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

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

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

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


Запрос

Отправьте POST запрос на https://processing.ecomcharge.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 символов. Параметр опционален в системе eComCharge, но может требоваться банком-эквайером.
exp_month string (2) Месяц окончания срока действия карты, представленный одной или двумя цифрами (например, 01).
exp_year string (4) Год окончания срока действия карты, представленный четырьмя цифрами (например, 2026).
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": "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"
  }
}