Выплата средств
Транзакция выплаты денег на карту по ее номеру.
Info
Ваш банк-эквайер может устанавливать ограничения и лимиты на использование этого типа транзакции. Больше информации вы можете узнать у вашего менеджера.
Запрос
Отправьте POST
запрос на https://processing.ecomcharge.com/transactions/payouts
со следующими параметрами:
Параметр | Тип | Описание |
---|---|---|
request | object | |
amount * обязательный |
bigInteger | Стоимость в минимальных денежных единицах. Например, $32.45 должна быть отправлена как 3245 . |
currency * обязательный |
string | Валюта в ISO-4217 формате, например USD . |
description * обязательный |
string (255) | Описание выплаты. |
tracking_id | string | Ваш внутренний ID операции. Максимальная длина: 255 символов. Пожалуйста, используйте уникальное значение для того, чтобы при запросе статуса транзакции получить актуальную информацию. В противном случае вы получите первую найденную по tracking_id транзакцию. В параметре может быть отправлено несколько значений, разделенных символом ; . Например: "cbe59142-90af-4aea-b5a5-5bf3f66cf3da;f7883cb9-0e26-43a7-beb7-4027cb55d1a6;4a6a89d5-6950-400f" . Если в запросе было передано более одного значения tracking_id , поиск транзакции в личном кабинете может быть осуществлен по любому из них. |
duplicate_check | boolean | Параметр управляет процессом проверки входящего запроса на уникальность. Если в течение 30 секунд придет запрос на выплату средств с одинаковыми amount и number или token , то запрос будет отклонен. По умолчанию, этот параметр имеет значение true . |
language | string | Язык вашей страницы оформления заказа. Если параметр установлен и email уведомление о транзакции включено, то eComCharge отправит email, язык текста которого будет language . По умолчанию - en . Доступные значения параметра language . |
notification_url | string | URL, на который будут приходить уведомления. Формат запроса уведомления аналогичен формату ответа транзакции. |
verification_url | string | URL, на который будут приходить запрос на подтверждение транзакции. Формат запроса на подтверждение аналогичен формату ответа транзакции. |
test | boolean | Транзакция будет тестовой, если значение true . |
recipient_credit_card | object | |
number * обязательный |
string (19) | Номер карты. |
holder * условно обязательный |
string (32) | Имя владельца карты. |
exp_month * условно обязательный |
string (2) | Месяц окончания срока действия карты, представленный двумя цифрами (например, 01). |
exp_year * условно обязательный |
string (4) | Год срока окончания действия карты, представленный четырьмя цифрами (например, 2026). |
token * условно обязательный |
string | Вместо 4 параметров выше вы можете отправить токен карты, который вы получили в ответе первой оплаты. |
recipient | object | Данные о получателе. Узнайте у службы поддержки, должны ли вы отправлять эти данные. |
ip * условно обязательный |
string | IP-адрес получателя, которому производится выплата. |
email * условно обязательный |
string | Email получателя, которому производится выплата. |
device_id * условно обязательный |
string | ID устройства получателя, которому производится выплата. |
birth_date * условно обязательный |
string | Дата рождения получателя в формате ISO 8601 YYYY-MM-DD . |
taxpayer_id * условно обязательный |
string | Идентификационный номер налогоплательщика (ИНН), присвоенный получателю выплаты. |
sender | object | Узнайте у службы поддержки, должны ли вы отправлять эти данные. |
ip * условно обязательный |
string | IP-адрес отправителя. |
email * условно обязательный |
string | Email отправителя. |
device_id * условно обязательный |
string | Id устройства отправителя. |
birth_date * условно обязательный |
string | Дата рождения отправителя в формате ISO 8601 YYYY-MM-DD |
recipient_billing_address | object | Узнайте у службы поддержки, должны ли вы отправлять эти данные. |
first_name * условно обязательный |
string (30) | Имя получателя. |
last_name * условно обязательный |
string (30) | Фамилия получателя. |
country * условно обязательный |
string | Страна получателя в ISO 3166-1 alpha-2 формате. |
city * условно обязательный |
string (60) | Город получателя. |
state * условно обязательный |
string | Двухбуквенная аббревиатура штата, если страна получателя US или CA . |
zip * условно обязательный | string | Почтовый индекс получателя. Для country=US , формат почтового индекса Должен иметь вид NNNNN или NNNNN-NNNN. |
address * условно обязательный |
string (255) | Адрес получателя. |
phone * условно обязательный |
string (100) | Номер телефона получателя. |
sender_billing_address | object | Узнайте у службы поддержки, должны ли вы отправлять эти данные. |
first_name * условно обязательный |
string (30) | Имя отправителя. |
last_name * условно обязательный |
string (30) | Фамилия отправителя. |
country * условно обязательный |
string | Страна отправителя в формате ISO 3166-1 alpha-2. |
city * условно обязательный |
string (60) | Город отправителя. |
state * условно обязательный |
string | Двухбуквенная аббревиатура штата, если страна отправителя US или CA . |
zip * условно обязательный |
string | Почтовый индекс отправителя. Для country=US , формат почтового индекса должен иметь вид NNNNN или NNNNN-NNNN. |
address * условно обязательный |
string (255) | Адрес отправителя. |
phone * условно обязательный |
string (100) | Номер телефона отправителя. |
<span class="ident1"additional_data | object | Cекция, содержащая дополнительную информацию о транзакции. |
p2p | object | Секция для работы с OCT транзакциями. |
service_id * условно обязательный |
string | Значение параметра уточните у вашего менеджера. |
service_extension * условно обязательный |
string | Значение параметра уточните у вашего менеджера. |
document * условно обязательный |
object | Узнайте у службы поддержки, должны ли вы отправлять эти данные. |
type * условно обязательный |
string | Тип документа отправителя. Возможные значения: PASSPORT - паспорт гражданина ID - ID-карта. |
issuer * условно обязательный |
string | Кем выдан документ отправителя. |
series * условно обязательный |
string | Серия документа отправителя. |
number * условно обязательный |
string | Номер документа отправителя. |
issued_at * условно обязательный |
string | Дата начала действия документа отправителя. Формат YYYY-MM-DD . |
valid_until * условно обязательный |
string | Дата окончания срока действия документа отправителя. Формат YYYY-MM-DD . |
Пример запроса
{
"request": {
"amount": 100,
"currency": "USD",
"description": "Test transaction ütf",
"tracking_id": "tracking_id_000",
"recipient": {
"ip": "127.0.0.1",
"email": "john@example.com",
"birth_date": "1990-10-20"
},
"sender": {
"ip": "127.0.0.1",
"email": "john@example.com",
"birth_date": "1990-10-20"
},
"recipient_billing_address": {
"first_name": "John",
"last_name": "Doe",
"country": "US",
"city": "Denver",
"state": "CO",
"zip": "96002",
"address": "1st Street",
"phone": "375444444444"
},
"sender_billing_address": {
"first_name": "John",
"last_name": "Doe",
"country": "US",
"city": "Denver",
"state": "CO",
"zip": "96002",
"address": "1st Street",
"phone": "375444444444"
},
"recipient_credit_card": {
"number": "5555555555554444",
"holder": "John Doe",
"exp_month": "12",
"exp_year": "2026"
},
"additional_data": {
"document": {
"type": "PASSPORT",
"issuer": "Organization name",
"series": "MP",
"number": "1234567890",
"issued_at": "2010-03-12",
"valid_until": "2025-03-12"
}
}
}
}
Пример запроса с токеном карты
{
"request": {
"amount": 100,
"currency": "USD",
"description": "Test transaction ütf",
"tracking_id": "tracking_id_000",
"recipient": {
"ip": "127.0.0.1",
"email": "john@example.com",
"birth_date": "1990-10-20"
},
"sender": {
"ip": "127.0.0.1",
"email": "john@example.com",
"birth_date": "1990-10-20"
},
"recipient_billing_address": {
"first_name": "John",
"last_name": "Doe",
"country": "US",
"city": "Denver",
"state": "CO",
"zip": "96002",
"address": "1st Street",
"phone": "375444444444"
},
"sender_billing_address": {
"first_name": "John",
"last_name": "Doe",
"country": "US",
"city": "Denver",
"state": "CO",
"zip": "96002",
"address": "1st Street",
"phone": "375444444444"
},
"recipient_credit_card": {
"token": "b4469f38-cec7-4f55-a86d-2ab2dc300e0b"
},
"additional_data": {
"document": {
"type": "PASSPORT",
"issuer": "Organization name",
"series": "MP",
"number": "1234567890",
"issued_at": "2010-03-12",
"valid_until": "2025-03-12"
}
}
}
}
Ответ
Ответ будет содержать те же параметры, что и запрос, а также дополнительные параметры:
Параметр | Тип | Описание |
---|---|---|
uid * обязательный |
string | UID обработанной транзакции. |
code * обязательный |
string | Код обработки транзакции. |
friendly_message * обязательный |
string | Сообщение для покупателя с описанием кода ошибки из параметра code . |
status * обязательный |
string | Статус обработанной транзакции. |
message * обязательный |
string | Сообщение с результатом запроса. |
type * обязательный |
string | Тип транзакции. |
tracking_id * обязательный |
string | Значение параметра tracking_id из запроса. |
language * обязательный |
string | Значение параметра language из запроса или en , если параметр не был передан. |
redirect_url * обязательный |
string | URL страницы эквайера, на который требуется направить покупателя для завершения операции выплаты средств. Используется в схеме обработке транзакций с редиректом. Уточните у Службы технической поддержки, работает ли ваш эквайер по такой схеме. |
payment_method_type * обязательный |
string | Способ оплаты, используемый для завершения транзакции: credit_card |
credit_card | object | |
brand * required |
string | Определенный бренд карты. |
last_4 * required |
string | Последние 4 цифры карты. |
first_1 * required |
string | Первая цифра карты. |
bin * обязательный |
string (6) | Шестизначный банковский идентификационный номер. Первые 6 цифр номера карточки. |
bin_8 * обязательный |
string (8) | Восьмизначный банковский идентификационный номер. Первые 8 цифр номера карты. Значение возвращается для карт Visa, Mastercard, Maestro и соответствующих кобрендинговых карт. Для брендов других платежных карт значение параметра – null . |
issuer_country * обязательный |
string | Страна банка, выпустившего карту. |
issuer_name * required |
string | Название банка, выпустившего карту. |
stamp * required |
string | Хэш карты. Постоянная величина, даже если дата окончания действия карты или владелец изменены. |
token * required |
string | Токен карты. Позволяет сохранять данные клиентов и производить оплату, когда они делают покупку или вы возобновляете свои услуги. |
receipt_url * обязательный |
string | Ссылка на квитанцию обработанной транзакции |
payout | object | |
auth_code * обязательный |
string | Код авторизации. |
bank_code * обязательный |
string | Код ответа операции в банковской системе. |
rrn * обязательный |
string | Номер операции в международной платёжной системе. ID транзакции, выданный сетью обработки карт. |
ref_id * обязательный |
string | Номер операции в системе банка. |
message * обязательный |
string | Сообщение от системы банка. |
status * обязательный |
string | Статус обработанной банком-эквайером транзакции. |
Пример ответа
{
"uid": "8f2b4e0e-b6e6-41d7-970a-5a506519aa0c",
"code": "S.0000",
"friendly_message": "The operation is successful.",
"status": "successful",
"amount": 100,
"currency": "USD",
"description": "Test transaction ütf",
"type": "payout",
"tracking_id": "tracking_id_000",
"message": "Successfully processed",
"test": true,
"created_at": "2024-04-02T14:57:57.638Z",
"updated_at": "2024-04-02T14:58:04.211Z",
"paid_at": "2024-04-02T14:58:04.172Z",
"manually_corrected_at": null,
"language": "en",
"redirect_url": "https://processing.ecomcharge.com/process/8f2b4e0e-b6e6-41d7-970a-5a506519aa0c",
"status_code": null,
"customer": {
"ip": "127.0.0.1",
"email": "john@example.com",
"device_id": null,
"birth_date": "1990-10-20",
"first_name": "John",
"last_name": "Doe",
"address": "1st Street",
"country": "US",
"city": "Denver",
"zip": "96002",
"state": "CO",
"phone": "375444444444"
},
"recipient": {
"customer": {
"first_name": "John",
"last_name": "Doe",
"address": "1st Street",
"country": "US",
"city": "Denver",
"zip": "96002",
"state": "CO",
"phone": "375444444444"
},
"payment_method": {
"holder": null,
"stamp": "b3839d334ba40e89168d60cd9f9d1390aee3fe67dd4d5c41adbf3998043eaef8",
"brand": "visa",
"last_4": "0000",
"first_1": "4",
"bin": "420000",
"bin_8": "42000000",
"issuer_country": "US",
"issuer_name": "VISA Demo Bank",
"product": "F",
"exp_month": null,
"exp_year": null,
"token_provider": null,
"token": null,
"type": "credit_card"
}
},
"links": {
"receipt_url": "https://gateway.ecomcharge.com/customer/transactions/8f2b4e0e-b6e6-41d7-970a-5a506519aa0c/ef2a8781b3f5de417df0826fc8e371ffd621134b81435f8e2ab02d7123055a89?language=en"
},
"smart_routing_verification": {
"status": "successful"
},
"transaction": {
"auth_code": "654321",
"bank_code": "00",
"rrn": "123456789102",
"ref_id": "777888",
"message": "Payout was approved",
"amount": 100,
"currency": "USD",
"billing_descriptor": "test descriptor",
"gateway_id": 3483,
"status": "successful"
}
}