Токенизация карты получателя
Транзакция используется для токенизации банковской карты получателя средств и проведения 3-D Secure проверки.
Зачисления средств не происходит. Используйте полученный токен, чтобы провести выплату средств.
Запрос
Отправьте POST
запрос на https://demo-gateway.begateway.com/transactions/recipient_tokenizations
со следующими параметрами:
Параметр | Тип | Описание |
---|---|---|
description | string (255) | Описание транзакции. |
tracking_id | string (255) | Ваш внутренний ID транзакции. Пожалуйста, используйте уникальное значение для того, чтобы при запросе статуса транзакции получить актуальную информацию. В противном случае вы получите первую найденную по tracking_id транзакцию. В параметре может быть отправлено несколько значений, разделенных символом ; . Например: "cbe59142-90af-4aea-b5a5-5bf3f66cf3da;f7883cb9-0e26-43a7-beb7-4027cb55d1a6;4a6a89d5-6950-400f" . Если в запросе было передано более одного значения tracking_id , поиск транзакции в личном кабинете может быть осуществлен по любому из них. |
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) | Номер телефона владельца карты. |
recipient_credit_card | object | |
number * обязательный |
string (19) | Номер карты. |
holder * условно обязательный |
string (35) | Имя владельца карты. Максимальная длина: 35 символов. Параметр опционален в системе Demo PSP, но может требоваться банком-эквайером. |
exp_month | string (2) | Месяц окончания срока действия карты, представленный одной или двумя цифрами (например, 01). |
exp_year | string (4) | Год окончания срока действия карты, представленный четырьмя цифрами (например, 2026). |
recipient | object | Узнайте у службы поддержки, должны ли вы отправлять эти данные. |
ip | string | IP-адрес покупателя, запросившего транзакцию токенизации. |
string | email покупателя, запросившего транзакцию токенизации | |
device_id | string | ID устройства покупателя, запросившего транзакцию токенизации. |
birth_date | string | Дата рождения покупателя в формате ISO 8601 YYYY-MM-DD . |
Пример запроса
{
"request": {
"description": "Test transaction",
"tracking_id": "your_uniq_number",
"recipient_billing_address": {
"first_name": "John",
"last_name": "Doe",
"country": "US",
"city": "Denver",
"state": "CO",
"zip": "96002",
"address": "1st Street"
},
"recipient_credit_card": {
"number": "4200000000000000",
"holder": "John Doe",
"exp_month": "05",
"exp_year": "2026"
},
"recipient": {
"ip": "127.0.0.1",
"email": "john@example.com"
}
}
}
Ответ
Ответ будет содержать те же параметры, что и запрос, а также дополнительные параметры:
Параметр | Тип | Описание |
---|---|---|
transaction | object | |
uid * обязательный |
string | UID обработанной транзакции. |
status * обязательный |
string | Статус обработанной транзакции. |
type * обязательный |
string | Тип транзакции. |
payment_method_type * обязательный |
string | Способ оплаты, используется для завершения транзакции: credit_card |
tracking_id | string | Значение параметра tracking_id из запроса. |
message * обязательный |
string | Сообщение с результатом запроса. |
created_at * обязательный |
string | Дата создания транзакции. |
updated_at * обязательный |
string | Дата обновления транзакции. Например, обновление статуса. |
recipient_credit_card | object | |
holder | string | Имя владельца карты. |
stamp * обязательный |
string | Хэш карты. Постоянная величина, даже если дата окончания действия карты или владелец изменены. |
token * обязательный |
string | Токен карты. Позволяет сохранять данные покупателей и производить оплату, когда они делают покупку или вы возобновляете свои услуги. |
brand | string | Определенный бренд карты. |
last_4 | string | Последние 4 цифры карты. |
first_1 | string | Первая цифра карты. |
bin * обязательный |
string (6) | Шестизначный банковский идентификационный номер. Первые 6 цифр номера карты. |
bin_8 * обязательный |
string (8) | Восьмизначный банковский идентификационный номер. Первые 8 цифр номера карты. Значение возвращается для карт Visa, Mastercard, Maestro и соответствующих кобрендинговых карт. Для брендов других платежных карт значение параметра – null . |
issuer_country * обязательный |
string (2) | Страна банка, выпустившего карту в формате ISO 3166-1 alpha-2. |
issuer_name * обязательный |
string | Название банка, выпустившего карту. |
product * обязательный |
string | Код типа карточного продукта. |
exp_month * обязательный |
integer | Месяц окончания срока действия карты. |
exp_year * обязательный |
integer | Год окончания срока действия карты. |
token_provider * обязательный |
string | В данной транзакции не используется. Всегда null . |
id * обязательный |
string | UID обработанной транзакции. |
Пример ответа
{
"transaction": {
"uid": "0775f4fe-c4ac-4b55-83c2-d89ef948d84a",
"status": "successful",
"description": "Test transaction",
"type": "recipient_tokenization",
"payment_method_type": "credit_card",
"tracking_id": "your_uniq_number",
"message": "Successfully processed",
"created_at": "2024-04-02T15:52:51.606Z",
"updated_at": "2024-04-02T15:52:51.687Z",
"recipient": {
"ip": "127.0.0.1",
"email": "john@example.com",
"device_id": null,
"birth_date": null
},
"recipient_credit_card": {
"holder": "John Doe",
"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": 5,
"exp_year": 2026,
"token_provider": null,
"token": "39799863-240f-417e-9f12-5ca713118069"
},
"recipient_billing_address": {
"first_name": "John",
"last_name": "Doe",
"address": "1st Street",
"country": "US",
"city": "Denver",
"zip": "96002",
"state": "CO",
"phone": null
},
"status_code": null,
"id": "0775f4fe-c4ac-4b55-83c2-d89ef948d84a"
}
}