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