Подключение

Базовые URL (Base URLs)

Payment API доступен в двух окружениях:

Окружение	Base URL
STAGE	`https://business.stage.reactivepay.com`
PROD	`https://business.reactivepay.com`

Аутентификация

Для merchant-endpoints используется Bearer-аутентификация с merchant_private_key:

Authorization: Bearer <merchant_private_key>

Тестовые карты

Sandbox-окружение предоставляет полную функциональность, но processing в нём только эмулируется — реальные банковские транзакции не выполняются. Для тестов можно использовать следующие PAN:

PAN	Статус
4617611794313933	Успешная 3-D Secure операция
4626233193837898	Отклоненная 3-D Secure операция
4392963203551251	Успешная non 3-D Secure операция
4730198364688516	Отклоненная non 3-D Secure операция
4627342642639018	Успешная выплата
4968357931420422	Отклоненная выплата

С этими PAN можно использовать любые имя держателя карты, срок действия и CVV2/CVC2.

3-D Secure также эмулируется: открывается страница, которая не требует пароля, а показывает две кнопки. Одна кнопка — успешная аутентификация, вторая — неуспешная.

Формат ответов с ошибками

Ошибки на первичный запрос:

{
  "success": false,
  "result": 1,
  "status": 403,
  "token": "hiuXHoK1bizpMkG3XfcQSq72uGeswfoe",
  "processingUrl": "",
  "payment": {
    "amount": 5000000,
    "gateway_amount": 5000000,
    "gateway_currency": "RUB",
    "currency": "RUB",
    "status": "declined",
    "two_stage_mode": false,
    "commission": 0.0,
    "decline_reason": "antifraud: mid:card:amount:value=>[10, 10000]=>5000000"
  },
  "errors": "Limit breach or risk violation action: , message: mid:card:amount:value=>[10, 10000]=>5000000, result: fail, route:  - api_fraud_error"
}

Ошибки после перехода по processingUrl:

{
  "success": false,
  "result": 1,
  "status": 403,
  "errors": [
    {
      "code": "customer_email_not_found",
      "kind": "invalid_request_error"
    }
  ]
}

Поля ответа с ошибкой

Поле	Тип	Описание
`success`	boolean	`false` при ошибке
`result`	integer	`1` при ошибке
`status`	integer	HTTP-код ошибки (всегда 403)
`errors`	array/string	Список ошибок или строка с описанием

Базовые типы данных

Суммы (amount)

Суммы передаются в минимальных единицах валюты:

{
  "amount": 1000
}

1000 = 10.00 USD/EUR

Валюты (currency)

Валюты указываются в формате ISO 4217 (3-4 символа):

{
  "currency": "USD"
}

Токены

Токены это уникальные идентификаторы операций — строки длиной 32 символа

Статусы операций

Статус	Описание	Финальный?
`init`	Операция инициализирована	нет
`pending`	В процессе обработки	нет
`approved`	Успешно завершена	да
`declined`	Отклонена	да
`refunded`	Возврат выполнен	да
`expired`	Истёк срок обработки	нет