Перейти к содержанию

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

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


Запрос

Отправьте POST запрос на https://demo-gateway.begateway.com/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"
  }
}