С чего начать #
Путь от доступа до первой сделки. Детали каждой ручки — в её разделе.
- Получите ключ. Пару
public_key(ak_...) иsecretвыдаёт менеджер при онбординге; дальше ключи можно выпускать самому в кабинете мерчанта («Ключи API»,/merchant-ui/keys).secretпоказывается один раз — «Авторизация». - Зарегистрируйте адрес для уведомлений (HTTPS) и сохраните его
signing_secret— кабинет мерчанта, раздел «Коллбек». Без уведомлений остаётся только опрос — «Уведомления». - Проверьте подпись оффлайн на готовом примере из «Авторизации» и обработчик коллбека — на примере из «Уведомлений». До первого сетевого запроса.
- Прогоните сценарии в песочнице
/sandbox/v1/collect— ключ там не нужен, исход выбирает сумма. Обязательно прогоните сценарий отзыва реквизита (сумма оканчивается на30) — «Тестовый контур». - Создайте боевую заявку
POST /gw/v1/collect→201. Ответ синхронный: в нём сразуstatus: awaiting_payment,requisiteи курс заявкиrate, либо сразу отказ (lapsed,no_executor).referenceиз ответа — номер заявки для всех следующих запросов. - Покажите плательщику
requisite:number(телефон или карта — смотря какой способ вы запросили) иholder_nameдля сверки. Редкий случайstatus: acceptedбез реквизита — реквизит придёт уведомлением или опросомGET /gw/v1/collect/{reference}. - Дождитесь
fulfilled— деньги получены, баланс пополнен. Заявку держите «слушаемой» ещё семь дней: возможен спор. - Выведите средства —
GET /gw/v1/account(баланс в USDT), затемPOST /gw/v1/settlement— «Выплаты, баланс и вывод».
Если что-то не так #
| Симптом | Куда смотреть |
|---|---|
| Запрос вернул ошибку | error.code (не message) — «Ошибки» |
401 на подписанном запросе | Часы сервера, окно метки времени ±5 мин — «Авторизация» |
| Неожиданный статус | «Статусы» — таблица переходов |
| Не приходят уведомления | Кабинет мерчанта, «Коллбек» — история доставок и повтор |
| Непонятно, что уже настроено | Кабинет мерчанта, «Подключение» (/merchant-ui/connect) |
| Непонятно, по какой ставке считают | Кабинет мерчанта, «Магазины» (/merchant-ui/stores) — «Магазины» |