Payout - Зачисление средств на карту
Выполняется с помощью команды Payout.
Запрос позволяет зачислить денежные средства на карту Пользователя с расчетного счета ТСП. Расчетный счет должен быть открыт в банке или НКО, обеспечивающем перечисление средств. В качестве карты может быть указан идентификатор зарегистрированной карты, полученный в ответе на запрос storeCard или полные реквизиты новой карты.
| Название |
Описание |
Формат |
Обязательный |
key |
Идентификатор Продавца. Выдается Продавцу с параметрами тестового/боевого доступа |
Строка |
Да |
merchant_order_id |
Идентификатор платежа в системе Продавца |
Строка (максимум 50 символов) |
Да |
amount |
Сумма для перечисления в копейках |
Цифры, не содержащие десятичных или других разделителей |
Да |
card |
Данные карты для совершения транзакции |
Объект |
Да |
├─ pan |
Номер карты. Используются в случае перечисления средств по номеру карты |
Строка: цифры без пробелов |
Да, при отсутствии uid |
├─ uid |
Идентификатор карты в системе theMAP. Используются в случае перечисления средств по идентификатору карты |
Строка (максимум 30 символов, латинские буквы или пробел) |
Да, при отсутствии pan |
credential |
|
Объект |
Нет |
login |
Логин держателя карты, зарегистрированного в системе Продавца. Используются в случае перечисления средств по идентификатору карты, сохраненной за Пользователем |
Строка (максимум 50 символов) |
Нет |
password |
Пароль держателя карты, зарегистрированного в системе Продавца. Используются в случае перечисления средств по идентификатору карты, сохраненной за Пользователем |
Строка (максимум 50 символов) |
Нет |
merchant |
Наименование продавца. Используются в случае перечисления средств по идентификатору карты, сохраненной за Мерчантом |
Строка (максимум 50 символов |
Нет |
merchant_password |
Пароль Мерчанта для совершения операций. Используются в случае перечисления средств по идентификатору карты, сохраненной за Мерчантом |
Строка (максимум 50 символов |
Нет |
terminal_password |
Пароль терминала для совершения операций. Используются в случае перечисления средств по идентификатору карты, сохраненной за терминалом |
Строка (максимум 50 символов |
Нет |
| Название |
Описание |
Формат |
Обязательный |
Key |
Идентификатор Продавца. Выдается Продавцу с параметрами тестового/боевого доступа |
Строка |
Да |
OrderId |
Идентификатор платежа в системе Продавца |
Строка (максимум 50 символов) |
Да |
Amount |
Сумма для перечисления в копейках |
Цифры, не содержащие десятичных или других разделителей |
Да |
PAN |
Номер карты. Используются в случае перечисления средств по номеру карты |
Цифры без пробелов |
Да, при отсутствии CardUId |
CardUId |
Идентификатор карты в системе theMAP. Используются в случае перечисления средств по идентификатору карты |
Строка |
Да, при отсутствии PAN |
Login |
Логин держателя карты, зарегистрированного в системе Продавца. Используются в случае перечисления средств по идентификатору карты, сохраненной за Пользователем |
Строка (максимум 50 символов) |
Нет |
Password |
Пароль держателя карты, зарегистрированного в системе Продавца. Используются в случае перечисления средств по идентификатору карты, сохраненной за Пользователем |
Строка (максимум 50 символов) |
Нет |
Merchant |
Наименование продавца. Используются в случае перечисления средств по идентификатору карты, сохраненной за Мерчантом |
Строка (максимум 50 символов |
Нет |
MerchantPassword |
Пароль Мерчанта для совершения операций. Используются в случае перечисления средств по идентификатору карты, сохраненной за Мерчантом |
Строка (максимум 50 символов |
Нет |
TerminalPassword |
Пароль терминала для совершения операций. Используются в случае перечисления средств по идентификатору карты, сохраненной за терминалом |
Строка (максимум 50 символов |
Нет |
Пример запроса POST:
Content-Type: application/json
https:{domain}/Payout
{
"key": "TestTerminal",
"merchant_order_id": "TestOrder123",
"card": {
"pan": "4111111111111111"
}
}
Пример реализации запроса в программном коде:
curl -X POST \
https:https:{domain}/Payout \
-H 'Content-Type: application/json' \
-d '{"key":"TestTerminal","merchant_order_id":"TestOrder123","card":{"pan":"4111111111111111"}}'
Пример запроса POST:
Content-Type: application/x-www-form-urlencoded
https:{domain}/Payout
Key:TestTerminal
Amount:300
OrderId:TestOrder123
PAN:4111111111111111
Пример реализации запроса в программном коде:
curl -X POST \
https:https:{domain}/Payout \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'Key=TestTerminal&Amount=300&OrderId=TestOrder123&PAN=4111111111111111'
| Название |
Описание |
Формат |
Success |
Флаг успешности операции |
true/false |
OrderId |
Идентификатор платежа в системе Продавца |
Соответствует переданному в запросе |
Amount |
Сумма зачисления. Передается, если «Success=true» |
Соответствует переданному в запросе |
BankName |
Параметр опциональный. Наименование банка эмитента |
Строка (максимум 50 символов |
ErrCode |
Код ошибки. Не передается, если «Success=true» |
см. коды ошибок |
ErrMessage |
Опциональный параметр. Дополнительное описание ошибки |
Строка |
RRN |
Параметр является опциональным. RRN операции |
Строка |
ProcessingResponse |
Параметр является опциональным. Оригинальный отказ эквайера |
Строка |
TerminalID |
Параметр является опциональным. Id терминала в системе MAP, по которому фактически выполнена операция |
Число |
CustomParams |
Параметр является опциональным. Список дополнительных параметров операции |
Соответствует Params, переданному в запросе |
Пример ответа на успешный запрос:
{
"Status": "True",
"OrderId": "TestOrder123",
"Amount": "300",
"ErrCode": "NONE",
"BankName": "TestBank",
},
Пример ответа на не успешный запрос:
{
"Success": false,
"ErrCode": "INVALID_AUTHENTICATION"
}