Что вам нужно
| Поле | Что оно делает |
|---|---|
| API key | Позволяет нам вызвать Dodo, чтобы создать размещённое оформление. Секретный. |
| Секрет подписи вебхука (whsec_…) | Подтверждает, что вебхук действительно пришёл от Dodo. Секретный. |
| Return URL | Куда попадает покупатель после оформления. |
Почему мы спрашиваем каждое поле
API key
Авторизует создание размещённого оформления, чтобы списание прошло через ваш счёт.
Секрет подписи вебхука
Доказывает, что входящий вебхук подлинно от Dodo, так что никто не подделает событие «оплачено». Это отдельное значение от API key.
Return URL
Простая настройка: куда попадает покупатель после оформления. Не секретная.
Настройка
- Используйте тестовый режим (бесплатно)
У Dodo есть отдельное тестовое окружение. Ключи тестового режима работают против тестового хоста Dodo, и реальные деньги не движутся.
- Войдите на app.dodopayments.com.
- Dodo разделяет боевые (Live) и тестовые (Test) ключи. Настройте сначала тест, затем повторите в боевой среде.
- Скопируйте свой API key
Перейдите в Developer → API Keys и скопируйте тестовый (Test) ключ для проверки или боевой (Live) ключ для приёма реальных платежей.
Dodo → Developer → API Keys - Добавьте вебхук
- Добавьте вебхук в Dodo.
- Задайте URL вебхука на адрес вебхука вашего проекта (ниже).
- Скопируйте секрет подписи вебхука (whsec_…). Добавьте отдельный вебхук в тесте и в боевой среде.
https://api.coinmoebius.com/webhook/dodopayments/<your project id>Dodo → Developer → Webhooks - Подключите в панели управления
Добавить провайдера → Dodo Payments. Введите Return URL и боевую группу (боевой API key, боевой секрет подписи вебхука). Добавьте необязательную тестовую группу, чтобы сначала проверить. Тестовая группа парная: добавьте и тестовый API key, и тестовый секрет вебхука, или оставьте оба пустыми. Боевая среда и тест проверяются отдельно.
После подключения
Сделайте один тестовый платёж до запуска:
- Создайте товар и задайте его Environment как Testing. Это запускает товар на ваших тестовых учётных данных, так что вы можете оформить полный заказ без движения денег. (Если вы пропустили тестовый набор, товар Testing откатывается к боевой среде, так что сначала добавьте его.)
- Поставьте кнопку покупки на страницу (подойдёт локальный HTML-файл), направленную на ваш проект.
- Завершите оформление в тестовом режиме Dodo.
- Откройте вкладку «Транзакции». Появляется новая строка с меткой Testing. Когда её статус достигнет succeeded, ваши учётные данные и вебхук оба работают от начала до конца.
Переключите Environment товара на Live, когда будете готовы к реальным платежам.
Решение проблем
Начните с «Проверить». В панели нажмите «Проверить» (или «Проверить тестовые учётные данные»), чтобы проверить ваш API key.
«Проверить тестовые учётные данные» говорит, что тестовые учётные данные не сохранены.
Добавьте тестовый API key во вкладке Test, сохраните провайдера, затем снова откройте диалог и проверьте.
Платёж завершается, но заказ остаётся в ожидании.
Подтвердите, что URL вебхука совпадает и что секрет подписи совпадает с вебхуком в том же окружении (тестовый секрет для теста, боевой для боевой среды).
Сохранение тестовой группы отклоняется.
Тестовая группа парная: добавьте и тестовый API key, и тестовый секрет вебхука, или оставьте оба пустыми.
Подтвердите всё от начала до конца.
Dodo Dashboard → Developer → Webhooks → Send Example (или Dodo CLI), направленный на ваш URL вебхука, затем смотрите, как обновляется заказ.
Полезно знать
Только разовые платежи. Coin Moebius использует Dodo для одиночных платежей, не для подписок.
Ротация секретов. Меняйте API key или секрет вебхука когда угодно, затем вставьте новое значение. Секретные поля остаются пустыми при редактировании.
Вопросы? Join our Discord