/api/v1/paymentspayments:createIdempotency-KeyСоздать платёж (страница оплаты Bankemes, Kaspi QR)
| Поле | Тип | Ограничения |
|---|---|---|
| order_id * | string | pattern ^[A-Za-z0-9_.:#/-]{1,64}$ |
| amount * | integer | Целое число тенге (JSON-число). Дроби, строки и экспоненциальная запись отклоняются (INVALID_AMOUNT); ≥ 1; ≤ 100000000 |
| currency | "KZT" | |
| description | string | ≤ 200 символов |
| success_url | string | R5: только origin ресурса (иначе 400, fields.success_url = origin_mismatch); pattern ^https://; uri |
| cancel_url | string | R5: только origin ресурса; pattern ^https://; uri |
| expires_in | integer | ≥ 300; ≤ 86400; по умолчанию 1800 |
| metadata | object | Ваши данные (ключи: латиница, цифры, _ . -). Возвращаются в API и webhook, в банк не передаются. До 2 КБ |
| items | object[] | Состав заказа (показывается на странице оплаты); сумма quantity × price = amount |
curl -X POST "https://bankemes.example/api/v1/payments" \
-H "Authorization: Bearer bms_live_XXXXXXXX_your-secret-token" \
-H "Idempotency-Key: order-1001-attempt-1" \
-H "Content-Type: application/json" \
-d '{"order_id":"ORDER-1001","amount":1500,"currency":"KZT","description":"Заказ №1001","success_url":"https://shop.example.kz/orders/1001/thanks","cancel_url":"https://shop.example.kz/cart"}'const res = await fetch('https://bankemes.example/api/v1/payments', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.BANKEMES_TOKEN}`, 'Idempotency-Key': 'order-1001-attempt-1', 'Content-Type': 'application/json' },
body: JSON.stringify({
"order_id": "ORDER-1001",
"amount": 1500,
"currency": "KZT",
"description": "Заказ №1001",
"success_url": "https://shop.example.kz/orders/1001/thanks",
"cancel_url": "https://shop.example.kz/cart"
}),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);Ответы
200Повтор с тем же Idempotency-Key: та же операция в текущем состоянии; заголовок Idempotent-Replayed: true201Создан400Ошибка401Ошибка402Ошибка403Ошибка409Ошибка429Ошибка