6 бизнес-инструментов от Kassa24 для успешного предпринимателя

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

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

Для настройки выплат с использованием карточных токенов выполните следующие шаги:

Подготовка мерчанта

Перед использованием токенов при выплатах убедитесь, что ваш мерчант подключён к токенизации. Если токенизация не активна, выплаты с привязкой карты и использованием cardToken работать не будут.

Сбор данных и создание криптограммы

Попросите клиента ввести данные карты. На основе номера карты сформируйте криптограмму — зашифрованные данные карты, используя инструкцию по формированию криптограммы

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

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "merchantId": "your_login",
  "amount": 12500,
  "returnUrl": "https://yoursite.kz/payment/complete",
  "description": "Test payment for [email protected]",
  "callbackUrl": "https://yoursite.kz/payment/callback",
  "type": 1,
  "customerData": {
    "phone": "77007777777",
    "cardData": "wnUx+rkFVhpaTvapu2etbfA7RKf6Hu...."
  },
  "demo": false
}

Важно: cardData передаётся только при первой выплате, и только если вы используете свою кастомную форму оплаты. Если выплата проходит через форму Kassa24 — cardData передавать не нужно. Уточните у менеджера, какая форма используется в вашем случае.

Получение токена карты

Токен можно получить одним из трёх способов:

1. В коллбэке после успешной выплаты:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
  "orderId": "22222222222222222",
  "id": "22222222222222222",
  "description": "Выплаты для тестирования",
  "amount": -1000,
  "commission": 0,
  "commissionIncluded": false,
  "customerCommission": 0,
  "merchantCommission": 15,
  "attempt": 1,
  "returnUrl": "",
  "merchantId": "11111111111111111",
  "invoiceId": "",
  "callbackUrl": "hello.kz",
  "date": "2025-06-13T11:09:23",
  "dateOut": "2025-06-13T11:09:38",
  "demo": false,
  "status": 1,
  "errCode": "0",
  "errMessage": "",
  "email": "",
  "phone": "77007777777",
  "iin": "",
  "card": "495703 ** **** 0454",
  "cardToken": "TkRrMU56QXpNRFF5TUR...."
}

2. Через API-метод получения статуса:

1
GET /payment/status?id=16623843310076177

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
  "orderId": "22222222222222222",
  "id": "22222222222222222",
  "description": "Выплаты для тестирования",
  "amount": -1000,
  "commission": 0,
  "commissionIncluded": false,
  "customerCommission": 0,
  "merchantCommission": 15,
  "attempt": 1,
  "returnUrl": "",
  "merchantId": "11111111111111111",
  "invoiceId": "",
  "callbackUrl": "hello.kz",
  "date": "2025-06-13T11:09:23",
  "dateOut": "2025-06-13T11:09:38",
  "demo": false,
  "status": 1,
  "errCode": "0",
  "errMessage": "",
  "email": "",
  "phone": "77007777777",
  "iin": "",
  "card": "495703 ** **** 0454",
  "cardToken": "TkRrMU56QXpNRFF5TUR...."
}

3. По номеру телефона:

1
GET /card/tokens?phone=77007777777

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

1
2
3
4
5
6
[
  {
    "ID": "TkRrMU56QXpNRFF5TURJeE1EUTFOREl3NDdE...",
    "Pan": "495703 ** **** 0454"
  }
]

Документацию по получению токенов по телефону смотрите здесь.

Повторные выплаты по токену

Чтобы выполнить выплату без повторного ввода данных карты, передайте ранее сохранённый cardToken и номер телефона, который использовался при привязке:

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "merchantId": "your_login",
  "amount": 12500,
  "returnUrl": "https://yoursite.kz/payment/complete",
  "description": "Test payment for [email protected]",
  "callbackUrl": "https://yoursite.kz/payment/callback",
  "type": 1,
  "customerData": {
    "phone": "77007777777",
    "cardToken": "TkRrMU56QXpNRFF5TUR...."
  },
  "demo": false
}

Удаление токена карты

Для удаления токена используйте запрос:

1
POST /card/tokens/remove

Тело запроса:

1
2
3
{
  "id": "TkRrMU56QXpNRFF5TURJeE1EUTFOREl3NDdE..."
}

Общие замечания

Телефон клиента обязателен для связи токена с пользователем.
Все запросы требуют авторизации через заголовок Authorization (формат Basic).