Жылдам бастау

Ең қысқа дұрыс интеграция. Барлық қадам нақты жария контрактқа сәйкес.

Пилоттық режим

Eleven Pay пилот/әзірлеу режимінде. Нақты төлем қабылдау ұйымыңыздың онбордингіне байланысты. Базалық мекенжай — сізге берілген мән (ELEVENPAY_BASE_URL); жария мекенжай әлі жоқ.

1. API-кілт және мекенжай

Кабинетте (app.eleven.kz → API-кілттер) кілт жасаңыз. Мән бір рет көрсетіледі — оны серверде сақтаңыз. Пішімі: ep_<env>_<keyid>_<secret>.

export ELEVENPAY_BASE_URL="<қосылу кезінде берілген базалық мекенжай>"
export ELEVENPAY_API_KEY="ep_live_<keyid>_<secret>"

2. Шот жасау

amount — екі таңбасы бар мәтін, бүтін теңге. customer_phone — 10–15 сан, пішімдеусіз.

curl -X POST "$ELEVENPAY_BASE_URL/v1/cashier/invoices" \
  -H "Authorization: Bearer $ELEVENPAY_API_KEY" \
  -H "Idempotency-Key: order-1001-v1" \
  -H "Content-Type: application/json" \
  -d '{"amount": "1500.00", "currency": "KZT", "merchant_order_id": "order_demo_1001", "customer_phone": "77001234567"}'

Жауап 201 Created (қайталауда 200 OK): status: "pending", invoice_state: "queued", settled: false. Сұрау шотты тек кезекке қояды; жіберу фонда жүреді.

3. Вебхук

Кабинетте (Вебхуктер) HTTPS мекенжайыңызды бірінші төлемнен бұрын тіркеңіз. Eleven Pay тек payment.succeeded оқиғасын жібереді. Қолтаңбаны шикі байттар бойынша тексеріңіз (HMAC-SHA256(құпия, "<t>." + дене), терезе ±5 минут), содан кейін қайталануды алып тастаңыз және тауарды бір рет беріңіз.

4. Тексеру GET арқылы

curl "$ELEVENPAY_BASE_URL/v1/cashier/invoices/ep1_7t4k2m8q9x3v6b1n5c0d2f4a8h" \
  -H "Authorization: Bearer $ELEVENPAY_API_KEY"

Төленді деп тек status: "succeeded" және settled: true болғанда санаңыз.

Әрі қарай

Cashier шоттары · Статустар · Вебхуктер · Python · Node.js · Тексеру тізімі