Подключить NOWPayments

Что вам нужно

Поле	Что оно делает
API key	Позволяет нам вызвать NOWPayments, чтобы создать платёж. Секретный.
IPN secret	Подтверждает, что уведомление о платеже действительно пришло от NOWPayments. Секретный.
URL успеха / URL отмены	Куда попадает покупатель после оплаты или отказа.

IPN (Instant Payment Notification), это название NOWPayments для вебхука, который они отправляют при изменении статуса платежа.

Почему мы спрашиваем каждое поле

API key

Авторизует создание платежа, чтобы средства поступили на ваш счёт.

IPN secret

Доказывает, что входящее уведомление подлинно от NOWPayments, так что никто не подделает событие «оплачено». Это отдельное значение от API key.

URL успеха и отмены

Простые настройки: куда попадает покупатель после оплаты или отказа. Не секретные.

Настройка

Тестирование: песочницы нет
У NOWPayments нет песочницы или тестового окружения. Чтобы проверить от начала до конца, отправьте небольшой реальный платёж монетой с низкой комиссией и подтвердите, что он появляется в вашей панели. Считайте этот первый небольшой платёж своим тестом. Счёт NOWPayments бесплатен; на реальных платежах вы платите только обычные сетевые и сервисные комиссии.
Откройте «Настройки платежей» в NOWPayments
Войдите на account.nowpayments.io и перейдите в Settings → Payments. На этом одном экране сосредоточено всё необходимое: кошельки для выплат (Payout wallets), API-ключи (API keys) и мгновенные уведомления о платеже (Instant payment notifications). Вы последовательно посетите каждый из них.
NOWPayments → Settings → Payments
Добавьте кошелёк для выплат
NOWPayments разблокирует API только после добавления кошелька для выплат. В разделе Payout wallets нажмите «Add new wallet», выберите валюту, вставьте адрес кошелька под вашим контролем и нажмите «Add wallet». На этот адрес будет поступать ваша крипта.
NOWPayments → Payout wallets → Add new wallet
Создайте API-ключ
Откройте раздел API keys и нажмите «Add new API key». Ваши ключи перечислены здесь, каждый со значком копирования, так что вы можете вернуться и скопировать ключ в любое время.
NOWPayments → Settings → API keys
Скопируйте ваш API-ключ
NOWPayments показывает новый ключ в диалоге «API key created». Нажмите значок копирования рядом с «Your API key» и сохраните его. (Публичный ключ ниже Coin Moebius не нужен.) При желании добавьте метку, затем нажмите «Save».
NOWPayments → API key created
Это ваш секретный API-ключ. Обращайтесь с ним как с паролем.
Настройте IPN-колбэк и скопируйте IPN-секрет
Откройте раздел Instant payment notifications. IPN (Instant Payment Notification) — это название NOWPayments для вебхука, отправляемого при изменении статуса платежа.
1. В поле Webhook URL вставьте адрес вебхука NOWPayments для вашего проекта (ниже), затем нажмите «Save».
2. Скопируйте IPN secret key, показанный вверху (нажмите «Regenerate», если значения ещё нет).
3. В разделе «Choose webhook format» выберите «Classic way», чтобы суммы и идентификаторы оставались в обычном числовом формате.
```
https://api.coinmoebius.com/webhook/nowpayments/<your project id>
```
NOWPayments → Instant payment notifications
Id вашего проекта находится под его названием в панели Coin Moebius; подставьте его в адрес выше. Карточка подключённого провайдера (последний шаг) показывает тот же URL, так что вы можете скопировать его повторно в любое время.
Обратно в Coin Moebius: Добавить провайдера → NOWPayments
В вашем проекте откройте вкладку «Провайдеры», нажмите «Добавить провайдера», выберите «Подключить сервис» и выберите NOWPayments. Вставьте ваш API key и IPN secret, задайте URL успеха и URL отмены (куда покупатели попадают после оплаты или отказа), затем нажмите «Сохранить».
Coin Moebius → Добавить провайдера → NOWPayments
Вы подключены
NOWPayments теперь отображается на вкладке «Провайдеры» с датой подключения. Карточка показывает тот же URL вебхука, который вы вставили в NOWPayments, а также кнопки «Редактировать» и «Отключить». Поскольку у NOWPayments нет песочницы, мы не можем автоматически проверить IPN-секрет, поэтому карточка предлагает тест с микроплатежом: отправьте небольшой реальный платёж, чтобы убедиться, что всё работает от начала до конца.
Coin Moebius → Провайдеры → NOWPayments (подключено)

После подключения

Песочницы нет, так что ваш первый небольшой реальный платёж, это тест:

Создайте товар и поставьте кнопку покупки на страницу (подойдёт локальный HTML-файл), направленную на ваш проект.
Оплатите небольшую сумму монетой с низкой комиссией.
Откройте вкладку «Транзакции». Когда статус новой строки достигнет succeeded, ваш API key и IPN secret оба работают от начала до конца.

Решение проблем

Платёж завершается, но заказ остаётся в ожидании.

IPN не приходит или не проходит проверку. Подтвердите, что URL обратного вызова совпадает и что IPN secret в панели совпадает с IPN Secret Key в ваших настройках NOWPayments.

Нет способа протестировать без оплаты.

Верно, песочницы нет. Отправьте небольшой реальный платёж монетой с низкой комиссией, чтобы запустить подлинный IPN, затем смотрите, как обновляется заказ.

Статус меняется только при реальной активности.

Статус NOWPayments отражает доставки IPN, так что тихий счёт не показывает статуса, пока не пройдёт реальный платёж.

Полезно знать

Нет тестового режима. Проверяйте небольшим реальным платежом, а не песочницей.

Ротация секретов. Генерируйте новый API key или IPN secret когда угодно, затем вставьте новое значение.

Вопросы? Join our Discord

NOWPayments