NUMUS Документация API

Тестовая среда

Проверяйте интеграцию с теми же методами, форматами подписи и статусами, которые используются в LIVE. Тестовые операции изолированы и не списывают деньги.

TEST и LIVE не смешиваются. Для тестовой среды выдаются отдельные partnerID, ключ Ed25519, секрет callback и настройки адресов. Боевые ключи здесь не работают.

Адреса

НазначениеTESTLIVE
Подписанный API https://sandbox-api.numus.online https://api.numus.online
Страницы покупателя https://sandbox-pay.numus.online https://pay.numus.online

Не передавайте название среды в заголовке или теле запроса. Среда определяется базовым адресом и полным набором выданных для неё ключей.

Что можно проверить

Статический QR отсутствует. Заявка на выплату проверяет контракт и состояния, но не создаёт реальную выплату.

Предсказуемые результаты

Результат определяется двумя цифрами после точки в сумме. Правило одинаково для QR, карты и повторного списания.

СуммаРезультатЧто проверять
100.00COMPLETEDУспешный статус и callback
100.01REJECTEDОтказ и один callback payment.failed
100.02PENDINGОжидание до истечения
100.03EXPIREDИстечение и один callback payment.failed
100.04Временная недоступностьБезопасный повтор и сверка неизвестного результата

Окончания от .05 до .99 завершаются успешно. Для PENDING событие ошибки не отправляется. TEST-страница всегда сообщает, что деньги не списываются.

Переход в LIVE

  1. Завершите TEST-проверкиПроверьте успешный платёж, отказ, повтор с тем же Idempotency-Key, binding и callback.
  2. Получите LIVE-доступNUMUS выдаст отдельный partnerID и активирует согласованные способы оплаты.
  3. Замените конфигурациюИзмените base URL, ключ, partnerID, callback-секрет, Callback URL и Return URL.
  4. Не переносите TEST-данныеPayment ID и bindingId из TEST не существуют в LIVE.