Что вам нужно
| Поле | Что оно делает |
|---|---|
| API key ID | Идентифицирует ваш MakePay API-ключ, так что мы вызываем нужный счёт. |
| API key secret | Позволяет нам создать MakePay checkout на вашем счёте. Секретный. |
| Webhook secret | Подтверждает, что вебхук действительно пришёл от MakePay. Секретный. |
| URL успеха | Куда попадает покупатель после завершения платежа. |
| URL отмены | Куда попадает покупатель, если платёж не прошёл или они отказались. |
MakePay выдаёт API key ID и secret вместе при создании ключа; webhook secret, это отдельное значение из его настроек колбэка.
Почему мы спрашиваем каждое поле
API key ID
Называет, какой MakePay-ключ мы аутентифицируем. Не секретный сам по себе, но спарен с секретом ниже.
API key secret
Авторизует создание checkout, так что платёж идёт на ваш MakePay-счёт и поступает на ваш кошелёк. MakePay показывает его один раз, сразу после создания ключа.
Webhook secret
Доказывает, что входящий вебхук подлинно от MakePay, так что никто не подделает событие «оплачено». Это отдельное значение от API key.
URL успеха и отмены
Простые настройки: куда попадает покупатель после оплаты или после неудачи или отмены. Не секретные.
Настройка
- Создайте API-ключ в MakePay
Войдите в MakePay и откройте API & SDK → API integrations. В разделе API keys нажмите Generate API Key, назовите его чем-нибудь вроде «Coin Moebius» и создайте. MakePay показывает API key ID и его secret один раз, сразу после создания — скопируйте оба сейчас, потому что secret больше не покажется.
MakePay → API & SDK → API integrations → Generate API Key Относитесь к API key secret как к пароли. Если потеряете его, создайте новый ключ, а не пытайтесь восстановить старый.
- Найдите ID своего проекта Coin Moebius
На отдельной вкладке откройте ваш проект в панели Coin Moebius и скопируйте Project ID из-под названия проекта. Ваш MakePay callback URL, это этот ID вставлен в адрес ниже — вы вставите его в MakePay на следующем шаге.
https://api.coinmoebius.com/webhook/makepay/<your project id>Coin Moebius → ваш проект → Project ID Карточка подключённого провайдера (последний шаг) показывает тот же URL, так что вы можете скопировать его снова в любое время.
- Задайте callback URL и скопируйте webhook secret
Обратно в MakePay, перейдите в Delivery → Callback URL configuration. Нажмите Edit Callback URL, вставьте ваш Coin Moebius webhook URL как активный пункт назначения и сохраните. Затем в разделе Webhook signing скопируйте signing secret (используйте Regenerate secret, если значения ещё нет) — это Webhook secret, который просит Coin Moebius.
MakePay → Delivery → Callback URL configuration MakePay постит обновления доставки на этот адрес после каждого изменения статуса, видимого мерчанту. Signing secret отдельный от API key — вам нужны оба.
- Подключите в панели управления
В Coin Moebius откройте Providers → Add provider → MakePay. Вставьте ваш API key ID, API key secret и Webhook secret, затем задайте URL успеха и URL отмены (куда попадают покупатели после оплаты или после неудачи). Нажмите Save.
Coin Moebius → Add provider → MakePay Сохранённые секреты остаются скрытыми. Чтобы позже поменять один, выберите Replace и введите новое значение.
- Вы подключены
MakePay теперь отображается на вкладке Providers с датой подключения и webhook URL, который он ожидает. Если вы ещё этого не сделали, вставьте тот же URL в настройки callback в MakePay. Используйте Edit, чтобы повернуть ключи, или Disconnect, чтобы удалить, и переключатель Test mode, чтобы провести заказ без влияния на реальные числа.
Coin Moebius → Providers → MakePay (подключено)
После подключения
Запустите один заказ до запуска:
- Включите переключатель Test mode на подключённой карточке MakePay, чтобы провести заказ без влияния на реальные числа.
- Создайте товар и поставьте кнопку покупки на страницу (подойдёт локальный HTML-файл), направленную на ваш проект.
- Завершите checkout через MakePay.
- Откройте вкладку «Транзакции». Когда статус новой строки достигнет succeeded, ваши ключи и webhook оба работают от начала до конца.
Выключите Test mode, когда будете готовы к реальным платежам.
Решение проблем
Начните в панели: подтвердите, что карточка MakePay показывает подключено и что webhook URL совпадает с callback destination, сохранённой в MakePay.
Платёж завершается, но заказ остаётся pending.
Вебхук не приходит или не проходит проверку. Подтвердите, что callback URL в MakePay совпадает с webhook URL вашего проекта в точности, и что Webhook secret в Coin Moebius совпадает с signing secret в MakePay.
Сохранение провайдера отклоняется.
API key ID, API key secret и Webhook secret все требуются. Перекопируйте их из MakePay — secret показывается только один раз, так что создайте новый ключ, если у вас его больше нет.
Тестовый заказ никогда не появляется в Transactions.
Включите переключатель Test mode для карточки MakePay перед тем, как запустить кнопку покупки, и убедитесь, что товар указывает на тот же проект.
Полезно знать
Нон-кастодиальное. MakePay поступает в крипте прямо на ваш собственный кошелёк. Coin Moebius никогда не держит средства и не может их двигать.
Ротация секретов. Создайте новый API key или переген webhook signing secret в любое время, затем выберите Replace в панели и вставьте новое значение. Секретные поля остаются пустыми при редактировании.
Вопросы? Join our Discord