Быстрый старт

За пять минут: создаём платёж, отправляем покупателя на страницу оплаты, получаем результат.

1. Получите ключи#

В личном кабинете создайте пару ключей: pk_test_… для фронтенда и sk_test_… для сервера.

2. Создайте платёж#

bash

curl -X POST https://api.example.kz/v1/payments \
  -H "Authorization: Bearer sk_test_51Hx…" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 150000,
    "currency": "KZT",
    "order_id": "ORDER-1042",
    "description": "Оплата заказа №1042"
  }'

Ответ содержит checkout_url — перенаправьте на него покупателя.

json

{
  "id": "pay_9f2k3",
  "status": "pending",
  "checkout_url": "https://pay.example.kz/9f2k3"
}

3. Получите результат#

Настройте вебхук или опросите платёж:

javascript

const res = await fetch("https://api.example.kz/v1/payments/pay_9f2k3", {
  headers: { Authorization: `Bearer ${process.env.SECRET_KEY}` },
});
const payment = await res.json();
if (payment.status === "paid") {
  // выдать заказ
}

Совет

Используйте заголовок Idempotency-Key при повторных запросах — так вы не создадите два платежа при сетевой ошибке.