Создание токенов

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

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

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

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

Платежная платформа создает токены на основе данных платежных карт пользователей, таких как номер карты, имя и фамилия ее держателя, дата окончания срока действия карты.

Токены создаются в следующих случаях:

  • при выполнении запроса на открытие Payment Page для создания токена;
  • автоматически при проведении первой успешной оплаты с использованием платежной карты, если эта возможность включена в вашем проекте;
  • автоматически при проведении первой успешной оплаты с сохранением платежных данных карты, если эта возможность включена в вашем проекте.
Совет: По вопросам включения автоматического создания токенов в вашем проекте обращайтесь к специалистам технической поддержки Rocketpay по адресу support@rocketpay.kz.

Для каждой платежной карты формируется один уникальный токен со сроком действия, совпадающим со сроком действия этой карты.

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

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

Шаги создания токена

Чтобы создать токен через Payment Page:

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

Запрос

В запросе на открытие Payment Page для создания токена укажите необходимые параметры:

Табл. 1. Базовые параметры запроса на создание токена в Payment Page

strictly required — параметр обязательно должен присутствовать в начальном запросе.
Параметр Описание

mode
string, strictly required

Режим работы Payment Page. Для создания токена укажите в этом параметре значение card_tokenize.

Пример: card_tokenize

project_id
integer
strictly required

Идентификатор проекта, полученный от Rocketpay при интеграции.

Пример: 123

customer_id
string
strictly required

Идентификатор пользователя, уникальный в рамках проекта.

Пример: customer_123

signature
string
strictly required

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

Вот пример параметров из запроса на открытие Payment Page для создания токена с использованием виджета EPayWidget:

EPayWidget.run(
    {
   "mode": "card_tokenize",
   "project_id": "123",
   "customer_id": "customer_123",
   "signature": "TSzdE5rJZaA9VyJtnfRI362oGpfXriFf82MxF..."
   }
)

Рис.: Пример GET-запроса на открытие Payment Page для создания токена

https://paymentpage.rocketpay.kz/payment?signature=A%2Fqqxsl59tRrtACreixy8sieSfxR%2BC...&mode=card_tokenize&project_id=123&customer_id=customer_123&region_code=RU&language_code=ru

Оповещение (callback)

Платежная платформа вернет оповещение с токеном и информацией о его создании. Подробнее о структуре оповещений см. Оповещения (callbacks) в Payment Page.

В следующем примере содержится информация о том, что в рамках проекта 123 для пользователя customer_123 был создан токен, а также вновь созданный токен.

Рис.: Пример тела оповещения о создании токена

{
    "project_id": 123,
    "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..."
}

Статусы токенов

Статус токена определяет возможность его использования для проведения оплаты.

Статус Описание
active Действительный токен, по которому можно проводить оплату
revoke Токен был отозван, проведение оплаты по токену невозможно
expiry Срок действия токена истек, проведение оплаты по токену невозможно

Ссылки по теме