Создание токенов
Общая информация
Токен — это идентификатор, представляющий собой уникальную строку из 64 символов и связанный в рамках платежной платформы с определенной платежной картой.
Вы можете сохранять токены в своей системе и использовать их при проведении оплаты через Payment Page. Токен не содержит конфиденциальной информации и может храниться в вашей системе, не создавая угрозы нарушения стандартов безопасности по хранению данных банковских карт.
В этом разделе рассказывается о создании токена с использованием Payment Page. Подробнее об использовании токена см. Оплата с использованием Payment Page. Информация о проверке действительности платежной карты с использованием токена представлена в разделе Проверка платежной карты.
Платежная платформа создает токены на основе данных платежных карт пользователей, таких как номер карты, имя и фамилия ее держателя, дата окончания срока действия карты.
Токены создаются в следующих случаях:
- при выполнении запроса на открытие Payment Page для создания токена;
- автоматически при проведении первой успешной оплаты с использованием платежной карты, если эта возможность включена в вашем проекте;
- автоматически при проведении первой успешной оплаты с сохранением платежных данных карты, если эта возможность включена в вашем проекте.
Для каждой платежной карты формируется один уникальный токен со сроком действия, совпадающим со сроком действия этой карты.
Процедуры отзыва токена, выплаты пользователю по токену, а также получения реквизитов платежной карты по токену выполняются через интерфейс Gate и описаны в разделе Использование токенов.
Чтобы токен был создан, пользователь должен указать реквизиты платежной карты и дождаться уведомления о результате. После успешного создания токена при последующей оплате сохраненная карта отображается пользователю на странице выбора способа оплаты в общем списке сохраненных карт и платежных методов.
Шаги создания токена
Чтобы создать токен через Payment Page:
- Создайте и отправьте в платежную платформу запрос на открытие Payment Page для создания токена.
- Примите от платежной платформы оповещение (callback) с результатами выполнения запроса.
Запрос
В запросе на открытие Payment Page для создания токена укажите необходимые параметры:
|
||
---|---|---|
Параметр | Описание | |
mode |
Режим работы Payment Page. Для создания токена укажите в этом параметре значение Пример: |
|
project_id |
Идентификатор проекта, полученный от Rocketpay при интеграции. Пример: |
|
customer_id |
Идентификатор пользователя, уникальный в рамках проекта. Пример: |
|
signature |
Подпись запроса, составленная после определения всех параметров запроса. Подробнее о составлении подписи см. Подписывание и проверка подписи. | |
При необходимости добавьте в запрос необязательные параметры из числа доступных для работы с 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®ion_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 | Срок действия токена истек, проведение оплаты по токену невозможно |