Перейти к основному контенту

Инструкция по работе с карточными токенами Kassa24 Business

  1. Провести интеграцию согласно технической документации сервиса Kassa24 Business.
  2. Запросить включение карточных токенов у техподдержки.
  3. После проведения оплаты в коллбэке будет приходить дополнительное поле cardToken, в котором будет находиться непосредственно токен в строковом формате (GUID). Его необходимо использовать в связке с номером телефона. Если клиент не укажет номер телефона или вы не передадите его при запросе, то привязки не произойдет и токен не сгенерируется.
  4. Этот токен будет необходимо передавать при запросе на выплату вместе с номером телефона, к которому он привязан. Таким образом, запрос будет выглядеть так:

Пример запроса с токеном на выплату:

{
  "merchantId":"your_login",
  "amount":12500,
  "returnUrl":"https://yoursite.kz/payment/complete",
  "description":"Test payment for youremail@example.com",
  "callbackUrl":"https://yoursite.kz/payment/callback",
  "acquiringId":5,
  "customerData":{
    "phone":"77472392990",
    "cardToken":"9a796429-6bf7-4611-a04c-d7b179f33e41"
  },
  "type":1,
  "demo":true
}

Пример запроса с токеном на платеж:

{
  "merchantId":"your_login",
  "amount":12500,
  "returnUrl":"https://yoursite.kz/payment/complete",
  "description":"Test payment for youremail@example.com",
  "callbackUrl":"https://yoursite.kz/payment/callback",
  "acquiringId":12,
  "customerData":{
    "phone":"77472392990",
    "cardToken":"9a796429-6bf7-4611-a04c-d7b179f33e41"
  },
  "demo":true
}
  • Поле acquiringId необходимо указывать, если передается токен.
  • Токены для демо платежей и боевых платежей разные, между собой не совместимы.

Пример коллбэка с токеном:

{
   "orderId":"11567534574928367",
   "id":"11567534574928367",
   "amount":12500,
   "commission":7000,
   "commissionIncluded":false,
   "attempt":1,
   "returnUrl":"https://yoursite.kz/payment/complete",
   "merchantId":"11509365292859861",
   "callbackUrl":"https://google.com",
   "date":"2020-07-23T13:12:20",
   "dateOut":"2020-07-23T13:12:52",
   "demo":false,
   "status":1,
   "errCode":"0",
   "errMessage":"",
   "email":"ndm@kassa24.kz",
   "phone":"77472392990",
   "card":"411111 ** 1111",
   "cardToken":"3f6c0739-1ded-4a40-ba39-c5fcfefb5ce7"
}
Наверх