GGWPAY docs

С чего начать #

Путь от доступа до первой сделки. Детали каждой ручки — в её разделе.

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

Если что-то не так #

СимптомКуда смотреть
Запрос вернул ошибкуerror.code (не message) — «Ошибки»
401 на подписанном запросеЧасы сервера, окно метки времени ±5 мин — «Авторизация»
Неожиданный статус«Статусы» — таблица переходов
Не приходят уведомленияКабинет мерчанта, «Коллбек» — история доставок и повтор
Непонятно, что уже настроеноКабинет мерчанта, «Подключение» (/merchant-ui/connect)
Непонятно, по какой ставке считаютКабинет мерчанта, «Магазины» (/merchant-ui/stores) — «Магазины»