Eleven Pay: Бастау

Eleven Pay — Қазақстанға арналған төлем коннекторы. Сіздің сервер төлем немесе шот жасайды, Eleven Pay нәтижені қолтаңбаланған вебхукпен хабарлайды, ал сіз тауарды немесе қызметті бір-ақ рет бересіз.

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

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

Eleven Pay — тәуелсіз сервис: Kaspi.kz-пен немесе басқа банкпен байланысты емес, олар қолдамайды және басқармайды. Үшінші тарап сервистерінің атаулары тек API не істейтінін сипаттау үшін аталады.

Интеграция жолын таңдаңыз

Жол	Қашан	Бастау
Төлеушіге шот (Cashier)	төлеушінің телефоны белгілі; төлем сұрауы оның банк қосымшасына түседі	Cashier шоттары (RU)
Төлем әрекетімен	сіз төлеушіге QR көрсетесіз немесе бағыттайсыз	Төлем жасау (RU)

Не істеу керек (қысқаша)

1. Кабинетте (app.eleven.kz) API-кілт жасаңыз; кілт тек серверде тұрады. Ол үшін cashier.invoice.create және payment.read мүмкіндіктері қажет (кілт live ортасынан).
2. Базалық мекенжайды ELEVENPAY_BASE_URL айнымалысына қойыңыз (сізге берілген мекенжай; өзге мекенжай ойлап шығармаңыз).
3. Шотты POST /v1/cashier/invoices арқылы жасаңыз. Idempotency-Key тапсырыспен бірге бұрын сақталады және қайталауда өзгермейді.
4. Вебхукті бірінші төлемнен бұрын тіркеңіз; қолтаңба құпиясы бір рет көрсетіледі.
5. Қолтаңбаны шикі байттар бойынша тексеріңіз, X-ElevenPay-Event-Id бойынша қайталануды алып тастаңыз, тапсырысты/соманы/валютаны тексеріп, тауарды бір рет беріңіз.
6. Тапсырыс тек расталған есеп айырысудан кейін ғана төленді деп саналады.

Маңызды ережелер

• Сома — бүтін теңге, мәтін: "1500.00"; бөлшек сома қабылданбайды, дөңгелектенбейді.
• Жауап келмесе, жаңа кілтпен жібермеңіз: сол кілтпен кейінірек қайталаңыз.
• Белгісіз нәтиже (invoice_state: "unknown") — екінші шот жасамаңыз.
• Eleven Pay шотты мерзімі өтті деп жаппайды және болдырмайды. Мерзім — сіздің жағыңыздағы шешім; кеш келген расталған төлем қолмен қарауға түседі, жоғалмайды.
• Бар төлем интеграциясын иесінің нақты рұқсатынсыз өзгертпеңіз.

Толық мәліметтер орыс тілінде: Статустар мен кеш төлемдер, Тексеру тізімі. ИИ-агенттерге арналған нұсқаулық: қысқаша және толық ағылшынша. Машинада оқылатын контракт: /openapi.json.