H2H

Суть метода: Вы передаете данные карты и сумму списания с нее, далее мы выполняем запрос на списание средств и возвращаем вам ссылку для выполнения 3DS подтверждения. Вы должны перенаправить вашего клиента на эту ссылку.

Метод запроса

POST

Урл запроса

/api/v2/deposit/h2h

Параметры запроса

На вход принимаются следующие параметры

Название	Обяз.	Формат	Описание
order_id		string(1-200)	Ваш уникальный номер заявки
site_account		string(1-255)	Код счета на который будет выполняться зачисление, например mts
amount		string(1-255)	Сумма заявки
card_number		string(1-255)	Номер карты клиента
card_expire		string(1-255)	Срок действия карты клиента в формате ММ\ГГ
card_cvv		string(1-255)	CVV карты клиента, 3 цифры
card_holder		string(1-255)	Фамилия и Имя владельца карты
comment		string(1-255)	Примечание по операции
notification_url		string(1-255)	Ссылка для отправки уведомления по этой транзакции
success_url		string(1-1024)	Урл для перенаправления плательщика после успешной оплаты
fail_url		string(1-1024)	Урл для перенаправления плательщика после ошибок оплаты
check_url		string(1-1024)	Кастомный урл для проверки статуса платежа, на тот случай если хотите сами выполнять перенаправление пользователя

Пример запроса

CURL

curl --request POST \
  --url https://{{your_api_domain}}/api/v2/deposit/h2h \
  --header 'Authorization: Bearer {{your_api_token}}' \
  --header 'Content-Type: application/json' \
  --data '{
  "order_id": "IN_2024_1289",
  "site_account": "sber",
  "amount": "100.00",
  "card_number": "51xxxxxx",
  "card_expire": "01/21",
  "card_cvv": "***",
  "card_holder": "Ivan Ivanov"
}'

PHP + Guzzle

$httpClient = new \GuzzleHttp\Client();
$response = $httpClient->post('https://{{your_api_domain}}/api/v2/deposit/h2h', [
    'json' => [
        'order_id'     => 'IN_2024_1289',
        'site_account' => 'mts',        
        'amount'       => '100.00',
        'card_number'  => '51xxxxxx',
        'card_expire'  => '01/21',
        'card_cvv'     => '***',
        'card_holder'  => 'Ivan Ivanov',
    ],
    'headers' => [
        'Authorization' => 'Bearer ' . $yourApiToken,
    ]
]);

Параметры ответа

Название	Формат	Описание
id	number	Номер заявки в нашей системе
amount	string(1-255)	Сумма по заявке
commission	string(1-255)	Комиссия по заявке
payment_url	string(1-255)	Ссылка для подтверждения оплаты клиентом

Пример ответа

{
  "id": 20,
  "amount": "100.00",
  "commission": "2.00",
  "payment_url": "https://some.url"
}