Токенизация карты получателя

Операция используется для токенизации банковской карты клиента-получателя средств и проведения 3-D Secure проверки. Зачисления средств не происходит. Используйте полученный токен, чтобы провести выплату средств.

---

Запрос

Отправьте POST запрос на https://gateway.bepaid.by/transactions/recipient_tokenizations со следующими параметрами:

Параметр	Тип	Описание
description	string (255)	Описание транзакции.
tracking_id	string (255)	Ваш внутренний ID операции. Пожалуйста, используйте уникальное значение для того, чтобы при запросе статуса транзакции получить актуальную информацию. В противном случае вы получите первую найденную по 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 (32)	Имя владельца карты.
exp_month	integer	Месяц окончания срока действия карты, представленный двумя цифрами (например, 01).
exp_year	integer	Год срока окончания действия карты, представленный четырьмя цифрами (например, 2007).
recipient	object	Узнайте у службы поддержки, должны ли вы отправлять эти данные.
ip	string	IP-адрес клиента, запросившего операцию токенизации.
email	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": "2020"
    },
    "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	Определенный бренд карты: visa, master, jcb, discover, dinersclub, amex, belkart или unionpay.
last_4	string	Последние 4 цифры карты.
first_1	string	Первая цифра карты.
bin	string	Банковский идентификационный номер.
issuer_country	string	Страна банка, выдавшего карту.
issuer_name	string	Имя банка, выдавшего карту.
product	string	Код типа карточного продукта.
exp_month	integer	Месяц окончания срока действия карты, представленный двумя цифрами (например, 01).
exp_year	integer	Год срока окончания действия карты, представленный четырьмя цифрами (например, 2023).
token_provider	string	В данной транзакции не используется. Всегда null.
id	string	UID обработанной транзакции.

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

{
  "transaction": {
    "uid": "1-310b0da80b",
    "status": "successful",
    "description": "Test transaction",
    "type": "recipient_tokenization",
    "payment_method_type": "credit_card",
    "tracking_id": "tracking_id_000",
    "message": "Successfully processed",
    "created_at": "2021-04-13T15:37:06.119Z",
    "updated_at": "2021-04-13T15:37:06.176Z",
    "recipient": {
      "ip": "127.0.0.1",
      "email": "john@example.com",
      "device_id": null,
      "birth_date": null
    },
    "recipient_credit_card": {
      "holder": "John Doe",
      "stamp": "a825df7faba8804619aef7a6d5a5821ec292fce04e3e43933ca33d0692df90b4",
      "token": "40bd001563085fc35165329ea1ff5c5ecbdbbeef40bd001563085fc35165329e",
      "brand": "visa",
      "last_4": "0000",
      "first_1": "4",
      "bin": "420000",
      "issuer_country": null,
      "issuer_name": null,
      "product": null,
      "exp_month": null,
      "exp_year": null,
      "token_provider": null
    },
    "recipient_billing_address": {
      "first_name": "John",
      "last_name": "Doe",
      "address": "1st Street",
      "country": "US",
      "city": "Denver",
      "zip": "96002",
      "state": "CO",
      "phone": null
    },
    "id": "1-310b0da80b"
  }
}