Параметры платежа
Какие данные передать для сверки чека с заявкой.
В поле expectation передайте JSON-строку с ожидаемыми данными платежа.
Берите эти данные из своей заявки.
Обязательные поля
| Поле | Что передать |
|---|---|
amount | Сумма платежа без комиссии: положительное число, до двух знаков после запятой |
currency | Трёхбуквенный код валюты: KZT или RUB |
recipient | Реквизиты получателя — зависят от банка и вида перевода |
window.from, window.to | Допустимый интервал платежа в ISO 8601 с часовым поясом |
{
"bank": "kz.kaspi",
"amount": 2000,
"currency": "KZT",
"recipient": {"name": "Алексей Петров"},
"window": {
"from": "2026-09-09T10:00:00+03:00",
"to": "2026-09-09T11:00:00+03:00"
}
}Выбор банка
Для переводов по реквизитам в RUB со счётом получателя можно не передавать bank
или указать "bank": "auto". Kvitera определит банк отправителя по чеку и выберет
его среди банков, доступных вашему API-ключу.
Если банк известен, передайте код, например ru.sber, или список допустимых кодов.
Это ограничит выбор. Для Kaspi укажите bank: "kz.kaspi" — автоопределение сейчас
доступно только для российских переводов по счёту.
Получатель
| Перевод | Поле в recipient | Пример |
|---|---|---|
| Клиенту Kaspi | name | {"name":"Алексей Петров"}; допустимо Алексей П. |
| Международный перевод Kaspi | card_last4 | {"card_last4":"1234"} |
| По реквизитам в банке России | account | {"account":"40817810000000001234"} |
Для международного перевода Kaspi также передайте type: ["international"].
Для банков России используйте счёт получателя из 20 цифр, а не номер карты или БИК.
Все реквизиты в примерах вымышлены.
Дополнительные условия
| Поле | Когда нужно |
|---|---|
type | Ограничить допустимые виды перевода. Если не передано, используются виды по умолчанию для банка |
payment_reference | Сверить UUID в назначении платежа для банков России |
uploaded_at | Указать время загрузки чека в вашей системе; иначе используется время получения запроса |
sender_hint | Передать подсказку об отправителе, до 200 символов |
payment_reference — код в назначении банковского платежа.
Для ID заявки в вашей системе используйте отдельное поле external_id в запросе,
а не внутри expectation.
Доступные банки, виды переводов и требования к получателю возвращает GET /v1/profiles.