Возвратный платеж
Данный API предназначен для формирования возвратного платежа на случайную маленькую сумму с последующим возвратом данной суммы и используется в сценариях, где требуется реализация автоматических платежей, подписки, вариантов сохранения банковских карт в сервисах Мерчантов.
Адреса:
POST https://api.maxpay.kz/payments/cards/random
Параметры запроса:
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
| merchant_id | integer | да | Идентификатор мерчанта в системе MaxPay. |
| signature | string | да | Подпись. Формирование подписи sha256("reference_id"+"secret_key"), где secret_key -это секретный ключ мерчанта, который выдается при заведении мерчанта в системе MaxPay. |
| reference_id | integer | да | Идентификатор пользователя в системе мерчанта. |
| user_id | integer | да | Идентификатор пользователя в системе мерчанта. |
| string | нет | Email пользователя. | |
| phone | string | нет | Телефон пользователя. |
| back_url | string | нет | url, на который будет отправлено сообщение о результатах платежа в случаях успеха или неудачи. Обязателен, если не указан в настройках мерчанта. |
| card_holder | integer | да | Владелец карты. |
| pan | string | да | Номер карты. |
| exp_month | integer | да | Месяц срока действия карты. |
| exp_year | integer | да | Год срока действия карты. |
| cvv | integer | да | CVV код карты. |
Параметры ответа:
| Параметр | Тип | Описание |
|---|---|---|
| status | boolean | Флаг, указывающий на успешность выполнения операции. |
| message | string | Текстовое описание ошибки (присутствует только при ошибке). |
Пример запроса:
Пример успешного ответа:
Пример ответа с ошибкой:
