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

Токенизация карты провайдером

Система eComCharge полностью сертифицирована по стандартами PCI DSS, что позволяет предлагать торговцам сервис токенизации. Вместо хранения важной информации пользователя на своей стороне торговцы могут обменять данные карты на токен. Токен можно хранить и использовать для проведения последующих оплат.

Передача токена в запросах на оплату, авторизацию или выплату средств отменяет необходимость передавать данные карты. Система определит данные карты по ее токену и передаст их в сеть процессинга. Для подтверждения платежа покупателю потребуется ввести лишь номер CVC/CVV.

Если торговец использует сервис подписок, то для проведения рекуррентного платежа достаточно передать только токен карты.

Info

Для работы с данными карт торговцу необходимо соответствовать требованиям PCI DSS сертификации.


Создание токена карты

Отправьте POST запрос на https://processing.ecomcharge.com/credit_cards со следующими параметрами:

Параметр Тип Описание
request object
number * обязательный
string (19) Номер карты.
holder * обязательный
string (32) Имя владельца карты.
exp_month * обязательный
integer Месяц окончания срока действия карты, представленный двумя цифрами (например, 01).
exp_year * обязательный
integer Год срока окончания действия карты, представленный четырьмя цифрами (например, 2026).
contract * обязательный
array Массив, элементами которого могут быть параметры:

recurring - eComCharge вернет токен карты для осуществления последующих платежей без повторного ввода реквизитов карты. Пользователь, соглашаясь с условиями регулярного списания, единожды производит оплату, вводя реквизиты карты, включая проверочный код карты CVC/CVV и проходя авторизацию по протоколу 3-D ­Secure.
Пример запроса на токенизацию карты
{
  "request":{
    "number":"4200000000000000",
    "holder":"John Smith",
    "exp_month":"05",
    "exp_year":"2026",
    "contract":["recurring"]
  }
}

Обновление данных карты

Отправьте POST запрос на https://processing.ecomcharge.com/credit_cards/{token}, где {token} - это значение токена, со следующими параметрами:

Параметр Тип Описание
request object
holder * обязательный
string (32) Имя владельца карты, как указано на карте.
exp_month * обязательный
integer Месяц срока окончания действия карты, представленный двумя цифрами (например, 01). Должен быть передан вместе с exp_year.
exp_year * обязательный
integer Год срока окончания действия карты, представленный четырьмя цифрами (например, 2026). Должен быть передан вместе с exp_month.
Пример запроса на обновление данных карты

Для обновления данные holder, exp_month и exp_year токена 23b48236ea85378ff899e33819ee31b1631ed8197dc254f9eb28c0011307cf32 POST запрос должен быть отправлен на https://processing.ecomcharge.com/credit_cards/23b48236ea85378ff899e33819ee31b1631ed8197dc254f9eb28c0011307cf32

{
  "request":{
    "holder":"John Doe",
    "exp_month":"01",
    "exp_year":"2026"
  }
}

Ответ

Ответ eComCharge на запрос токенизации карты или обновления данных карты будет включать следующие параметры:

Параметр Тип Описание
holder * обязательный
string Имя владельца карты, взятое из запроса.
brand * обязательный
string Определенный бренд карты: visa, master, jcb, discover, dinersclub, amex, belkart или unionpay.
first_1 * обязательный
string Первая цифра карты.
last_4 * обязательный
string Последние 4 цифры карты.
stamp * обязательный
string Хэш карты. Постоянная величина, даже если дата окончания действия карты или владелец изменены.
token * обязательный
string Токен карты. Позволяет сохранять данные клиентов и производить оплату, когда они делают покупку, или вы возобновляете свои услуги.
exp_month * обязательный
integer Месяц окончания срока действия карты, представленный двумя цифрами (например, 01).
exp_year * обязательный
integer Год срока окончания действия карты, представленный четырьмя цифрами (например, 2026).
Пример ответа
{
  "holder":"John Doe",
  "stamp":"a825df7faba8804619aef7a6d5a5821ec292fce04e3e43933ca33d0692df90b4",
  "brand":"visa",
  "last_4":"0000",
  "first_1":"4",
  "token":"7ba647e7013b5cb9df39f17c375783aef81bc8c20f221b962becbd0686cc33af",
  "exp_month":1,
  "exp_year":2026
}