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

payments/publickey, checkout.js - Публичный ключ и Checkout-скрипт

Вспомогательные методы для построения криптограммы карты на стороне мерчанта — перед вызовом payments/cards/charge / payments/cards/auth.

GET checkout.js

  • URL: /checkout.js
  • Аутентификация: не требуется
  • Назначение: JS-скрипт (аналог checkout.js CloudPayments), с вшитым публичным RSA-ключом и версией ключа нашего сервиса. Подключите его на своей странице и вызовите для получения криптограммы данных карты — так же, как это описано в документации CloudPayments для checkout.js.
1
<script src="https://cloud.wallet.kvell.group/checkout.js"></script>

Скрипт формирует криптограмму в стандартном формате CloudPayments (CloudCard), совместимом с CardCryptogramPacket в payments/cards/charge.

GET payments/publickey

  • URL: /payments/publickey
  • Аутентификация: не требуется
  • Назначение: текущий публичный RSA-ключ сервиса — тот же ключ, что вшит в checkout.js. Нужен, если вы формируете криптограмму собственным кодом, а не через checkout.js.

Структура ответа

Ответ отдаётся как есть, без обёртки Success/Message/Model, принятой в остальных методах:

Поле Тип Описание
pem str Публичный RSA-ключ в формате PEM.
version int Версия ключа.

Пример ответа

1
2
3
4
{
  "pem": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...\n-----END PUBLIC KEY-----",
  "version": 2
}

Примечания

  • Ключ периодически обновляется (version растёт) — не кэшируйте его надолго, запрашивайте актуальный перед формированием криптограммы или используйте checkout.js, который всегда отдаёт актуальную версию.
  • checkout.js также поддерживает построение криптограммы, совместимой с оригинальным клиентским SDK CloudPayments — переключать интеграцию не нужно, достаточно указать наш хост.