Payout - Зачисление средств на карту
Выполняется с помощью команды Payout.
Запрос позволяет зачислить денежные средства на карту Пользователя с расчетного счета ТСП. Расчетный счет должен быть открыт в банке или НКО, обеспечивающем перечисление средств. В качестве карты может быть указан идентификатор зарегистрированной карты, полученный в ответе на запрос storeCard или полные реквизиты новой карты.
| Название |
Описание |
Формат |
eCom |
key |
Идентификатор Продавца. Выдается Продавцу с параметрами тестового/боевого доступа |
Строка |
|
merchant_order_id |
Идентификатор платежа в системе Продавца |
Строка (максимум 50 символов) |
|
amount |
Сумма для перечисления в копейках |
Цифры, не содержащие десятичных или других разделителей |
|
card |
Данные карты для совершения транзакции |
Объект |
|
├─ pan |
Номер карты. Используются в случае перечисления средств по номеру карты |
Строка: цифры без пробелов |
1 |
├─ uid |
Идентификатор карты в системе theMAP. Используются в случае перечисления средств по идентификатору карты |
Строка (максимум 30 символов, латинские буквы или пробел) |
2 |
custom_params_rdy |
Список дополнительных параметров операции в формате "ключ - значение" |
Объект |
|
credential |
|
Объект |
|
login |
Логин держателя карты, зарегистрированного в системе Продавца. Используются в случае перечисления средств по идентификатору карты, сохраненной за Пользователем |
Строка (максимум 50 символов) |
|
password |
Пароль держателя карты, зарегистрированного в системе Продавца. Используются в случае перечисления средств по идентификатору карты, сохраненной за Пользователем |
Строка (максимум 50 символов) |
|
merchant |
Наименование продавца. Используются в случае перечисления средств по идентификатору карты, сохраненной за Мерчантом |
Строка (максимум 50 символов |
|
merchant_password |
Пароль Мерчанта для совершения операций. Используются в случае перечисления средств по идентификатору карты, сохраненной за Мерчантом |
Строка (максимум 50 символов |
|
terminal_password |
Пароль терминала для совершения операций. Используются в случае перечисления средств по идентификатору карты, сохраненной за терминалом |
Строка (максимум 50 символов |
|
1 Параметр обязателен при отсутствии uid
2 Параметр обязателен при отсутствии pan
| Название |
Описание |
Формат |
eCom |
Key |
Идентификатор Продавца. Выдается Продавцу с параметрами тестового/боевого доступа |
Строка |
|
OrderId |
Идентификатор платежа в системе Продавца |
Строка (максимум 50 символов) |
|
Amount |
Сумма для перечисления в копейках |
Цифры, не содержащие десятичных или других разделителей |
|
PAN |
Номер карты. Используются в случае перечисления средств по номеру карты |
Цифры без пробелов |
1 |
CardUId |
Идентификатор карты в системе theMAP. Используются в случае перечисления средств по идентификатору карты |
Строка |
1 |
Login |
Логин держателя карты, зарегистрированного в системе Продавца. Используются в случае перечисления средств по идентификатору карты, сохраненной за Пользователем |
Строка (максимум 50 символов) |
|
Password |
Пароль держателя карты, зарегистрированного в системе Продавца. Используются в случае перечисления средств по идентификатору карты, сохраненной за Пользователем |
Строка (максимум 50 символов) |
|
Merchant |
Наименование продавца. Используются в случае перечисления средств по идентификатору карты, сохраненной за Мерчантом |
Строка (максимум 50 символов |
|
MerchantPassword |
Пароль Мерчанта для совершения операций. Используются в случае перечисления средств по идентификатору карты, сохраненной за Мерчантом |
Строка (максимум 50 символов |
|
TerminalPassword |
Пароль терминала для совершения операций. Используются в случае перечисления средств по идентификатору карты, сохраненной за терминалом |
Строка (максимум 50 символов |
|
Params |
Список дополнительных параметров операции |
Cтрока, содержащая пары ключей и их значений команды, разделённые символом «;» (точка с запятой). Ключи и значения разделены символом «=» (равно) |
|
1 Параметр обязателен при отсутствии CardUId
2 Параметр обязателен при отсутствии PAN
Пример запроса 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'
| Название |
Описание |
Формат |
eCom |
Success |
Флаг успешности операции |
true/false |
|
OrderId |
Идентификатор платежа в системе Продавца |
Соответствует переданному в запросе |
|
State |
Текстовое значение статуса платежа |
Строка (Rejected |
InProcess |
Paid) |
|
Amount |
Сумма зачисления |
Соответствует переданному в запросе |
1 |
ErrCode |
Описание ошибки |
см. коды ошибок |
2 |
ErrMessage |
Дополнительное описание ошибки |
Строка |
|
RRN |
RRN операции |
Строка |
|
BankName |
Наименование Банка-эмитента |
Строка |
|
ProcessingResponse |
Оригинальный отказ эквайера |
Строка |
|
CustomParams |
Список дополнительных параметров операции |
Соответствует Params, переданному в запросе |
|
TerminalID |
ID терминала в системе MAP, по которому фактически выполнена операция |
Число |
|
1 Передаётся, если в ответе Success=true
2 Передаётся, если в ответе Success=false
Пример ответа на успешный запрос:
{
"Status": "True",
"OrderId": "TestOrder123",
"State": "Paid",
"Amount": "300",
"ErrCode": "NONE",
"BankName": "TestBank",
},
Пример ответа на не успешный запрос:
{
"Success": false,
"State": "Rejected",
"ErrCode": "INVALID_AUTHENTICATION"
}