Формирование токенов

Общая информация

При работе с Payment Page можно формировать токены, которые в дальнейшем хранятся на стороне веб-сервиса мерчанта и могут использоваться при проведении оплаты через Payment Page и Gate, а также выплаты через Gate.

Токен — это идентификатор, представляющий собой уникальную последовательность из 64 символов и связанный в рамках платежной платформы с определенной платежной картой.

Токены создаются на основе данных платежных карт пользователей (таких как номер карты, имя и фамилия ее держателя и дата окончания срока действия этой карты) в следующих случаях:

• при выполнении запроса на открытие Payment Page в режиме Card Tokenize;
• при проведении первой успешной оплаты с сохранением платежных данных карты в режиме Purchase, если эта возможность настроена в проекте мерчанта;
• при проведении первой успешной оплаты или выплаты с использованием платежной карты, если эта возможность настроена в проекте мерчанта.

По вопросам добавления возможности автоматической генерации токенов обращайтесь к специалистам технической поддержки по адресу support@itx.kz.

Для каждой платежной карты формируется один уникальный токен со сроком действия, соответствующим сроку действия этой карты, и этому токену присваивается статус active. По истечении срока действия токена этот статус изменяется на expiry, а при удалении токена по запросу со стороны веб-сервиса — на статус revoke. Проведение платежей по токену со статусом отличным от active невозможно.

Процедуры удаления токена, а также получения реквизитов платежной карты по токену выполняются через интерфейс Gate и представлены в разделе Использование токенов.

Базовыми действиями пользователя при формировании токенов с использованием Payment Page могут быть указание реквизитов платежной карты и ожидание уведомления о результате. После успешного формирования токена данные платежной карты, с которой он ассоциирован, отображаются пользователю на странице выбора способа оплаты в общем списке сохраненных инструментов.

В этом разделе представлена информация о формировании токенов с использованием Payment Page в режиме Card Tokenize. Информация о формировании токенов при проведении оплаты представлена в разделе Оплата с использованием Payment Page.

Схема работы

Для формирования токена через Payment Page со стороны веб-сервиса необходимо:

1. Сформировать и отправить в платежную платформу запрос на открытие Payment Page.
2. Принять оповещение о результате выполнения запроса со стороны платежной платформы.

Формат запросов

Формат запроса на открытие Payment Page для формирования токена соответствует описанному в разделе Описание Payment Page API. При формировании такого запроса необходимо учитывать следующее:

1. В запросе должны использоваться следующие обязательные параметры:
   • mode — индикатор режима работы Payment Page, для которого необходимо передавать значение card_tokenize.
   • project_id — идентификатор проекта, полученный от ITX при интеграции;
   • customer_id — идентификатор пользователя в веб-сервисе мерчанта;
   • signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Подписывание и проверка подписи).
2. Для отображения пользователю платежной страницы на заданном языке в запросе дополнительно необходимо использовать параметр language_code — код языка в формате ISO 639-1 alpha-2. Если этот параметр не передан, платежная страница отображается на языке, определенном по IP-адресу пользователя: на английском (для всех стран, кроме России) или на русском (для России).
3. Дополнительно в запросах могут использоваться любые другие параметры, используемые для работы Payment Page в режиме Card Tokenize. Полный список параметров вызова Payment Page представлен в разделе Параметры открытия платежной страницы Payment Page.

Таким образом, корректный запрос на формирование токена должен содержать индикатор режима работы Payment Page, идентификатор проекта, подпись, а таже идентификатор пользователя.

{
   "mode": "card_tokenize",
   "project_id": "112",
   "customer_id": "cust_123",
   "signature": "TSzdE5rJZaA9VyJtnfRI362oGpfXriFf82MxF..."
}

Формат оповещений

Для оповещения о формировании токена используется стандартный формат, описание которого представлено в разделе Оповещения (callbacks) в Payment Page.

В следующем примере содержится информация о том, что в рамках проекта 112 для пользователя cust_123 сформирован токен (token). Также для этого токена указаны дата и время его создания (token_created_at) и текущий статус (token_status).

{
    "project_id": 112,
    "customer": {
        "id": "customer_123"
        },
    "request": {
        "id": "3c7f53fdbb5b8c96f9707457d75f",
        "action": "tokenize",
        "status": "success"
    },
    "token": "2f0e75befacca30623354f9ffb0f44a80bee52982c39727b85039ef6f64309a1",
    "token_created_at": "2020-03-28 13:30:57",
    "token_status": "active",
    "signature": "mTHcy5wvpOYkl9S5eLJZ..."
}