# Клиентке төлем келмей жатыр

> Счёт жасалды, бірақ клиенттің телефонына ештеңе келмеді немесе QR ашылмайды. Ең жиі себебі — тест режимі қосулы қалып қойған. Алты қадамдық тексеру реті.

## Қысқаша

Ең жиі кездесетін себеп — **тест режимі қосулы қалып қойған**. Sandbox-та нақты Kaspi шақырылмайды: счёт бізде жасалады, күйі де өзгереді, бірақ клиенттің телефонына ештеңе бармайды және ақша жүрмейді. Ең алдымен кілттің басын қараңыз: `qp_test_` болса, сіз sandbox-тасыз. Live кілт — `qp_live_`. Егер режим дұрыс болса, төмендегі ретпен алты нәрсені тексеріңіз.

## Симптом бойынша

| Не көріп тұрсыз | Ықтимал себебі | Не істеу керек |
|---|---|---|
| Счёт жасалады, клиентке ештеңе келмейді | Тест режимі | Кілттің басын және кабинеттегі режимді тексеріңіз |
| API счёт жасамай, қате қайтарады | Кассир байланысы жоқ немесе үзілген | Кабинет → Kaspi → байланысты қалпына келтіріңіз |
| `tariff_inactive` қатесі | Сынақ мерзімі бітті немесе тариф төленбеген | Кабинет → Тариф |
| `invalid_phone` қатесі | Нөмір пішімі қате | `7XXXXXXXXXX`, 11 сан, бос орынсыз |
| Push кетті, клиент көрмейді | Клиентте Kaspi қосымшасы жоқ немесе басқа нөмірде | QR немесе төлем сілтемесін беріңіз |
| QR ашылады, бірақ «кейінірек көріңіз» дейді | Сканерлеу терезесі өтіп кеткен | [QR «кейінірек көріңіз» деп тұр](/kb/qr-expired) |

## Тексеру реті

**1. Режим.** Кабинетте қай режим қосулы тұрғанын қараңыз. Sandbox-та Kaspi мүлде қатыспайды: клиентке push бармайды, QR нақты төлемді қабылдамайды, ақша жүрмейді. Бұл қате емес, sandbox солай жұмыс істеуі керек — тек сіз оны жабуды ұмытып кеткенсіз.

Белгісі: счёттар сәтті жасалып тұр, күйлері де өзгеріп жатыр, бірақ Kaspi шотыңызға ешқандай ақша түспейді, ал клиенттер «ештеңе келмеді» дейді.

**2. Кілт.** Кодыңыз қай кілтті жіберіп тұр? Кілттің басы бәрін айтады:

| Кілт | Режим | Не болады |
|---|---|---|
| `qp_test_…` | Sandbox | Нақты ақша жүрмейді, Kaspi шақырылмайды, төлемді өзіңіз симуляциялайсыз |
| `qp_live_…` | Live | Нақты Kaspi QR, нақты ақша |

Жиі кездесетін жағдай: кабинетте режим live-қа ауыстырылған, ал серверде ортаның айнымалысында әлі сынақ кілті тұр. Немесе керісінше — өнімдік серверде бәрі дұрыс, ал сынақ стендінің кілтімен жұмыс істеп жатырсыз. Кілтті кодтың өзінен емес, серверде нақты орындалып жатқан мәнінен тексеріңіз.

**3. Кассир белсенді ме?** Live режимде счёт Kaspi-дегі «Кассир» рөлі арқылы шығады. Байланыс үзілген болса, счёт мүлде жасалмайды. Кабинет → **Kaspi** бөлімінде байланыс картасы белсенді тұр ма, қараңыз.

Ең жиі кездесетін себеп: кассир нөмірімен біреу Kaspi Pay қосымшасына кірген — Kaspi бір нөмірге бір ғана белсенді құрылғыға рұқсат береді, сондықтан біздің сессия үзіледі.

**4. Клиент нөмірінің пішімі.** `phone` түріндегі счёт клиенттің Kaspi қосымшасына push жібереді, сондықтан `customer.phone` дұрыс болуы керек: `7XXXXXXXXXX` — 11 сан, `+`, бос орын, жақша, сызықшасыз. `8` цифрынан басталатын нөмірді өзіңіз `7`-ге түрлендіріңіз.

Тағы бір жиі кездесетіні: нөмір техникалық тұрғыда дұрыс, бірақ клиенттің Kaspi-і **басқа нөмірге** тіркелген. Мұны біз тексере алмаймыз — клиенттен Kaspi-дегі нөмірін сұраңыз.

**5. Клиентте Kaspi қосымшасы бар ма?** Телефонға счёт тек Kaspi қосымшасы орнатылған және сол нөмірге тіркелген клиентке ғана жетеді. Қосымшасы жоқ адамға push та, счёт та келмейді. Мұндай жағдайда `qr` түріндегі счёт жасап, QR-ды немесе төлем сілтемесін беріңіз.

**6. Тариф белсенді ме?** Сынақ мерзімі бітіп, тариф төленбесе, API `tariff_inactive` қайтарады да, жаңа счёттар жасалмайды. Кабинет → **Тариф** бөлімінде күйін көресіз. Сынақ мерзімі 7 күн және ол тіркелген күннен емес, **бірінші нақты счёттан** басталады.

## Екі минутта қалай ажырату керек

Мәселе бізде ме, Kaspi-де ме, әлде кодыңызда ма — реті қарапайым:

1. Кабинеттен қолмен счёт жасап көріңіз. Жасалмаса — мәселе кодта емес, байланыста немесе тарифте.
2. Кабинеттен жасалған счёт клиентке жетті ме? Жетсе — кодыңыз басқа кілтпен немесе басқа режимде жұмыс істеп тұр.
3. Счёттар тізімінде жаңа счёт бар ма? Болмаса — сұрауыңыз бізге мүлде жетпеген.

## Жиі жіберілетін қателер

- **Кабинетте режимді ауыстырып, кодтағы кілтті ауыстырмау.** Екеуін бірге жасау керек.
- **Тиынмен сома жіберу.** Телефонға счёт бүтін теңгемен ғана жүреді.
- **Клиенттің нөмірін формадан тазаламай алу.** `+7 (777) 123-45-67` түріндегі мәтін қабылданбайды.
- **Счёт жасалғанын webhook келмегеніне қарап бағалау.** Бұл екі бөлек мәселе: [Webhook келмей жатыр](/kb/webhook-not-arriving).

## Жиі қойылатын сұрақтар

**Sandbox-та клиентке нақты хабарлама келе ме?** Жоқ. Sandbox Kaspi-ге мүлде жүгінбейді, ол тек сіздің кодыңызды сынауға арналған.

**Sandbox-та жасалған счёттар тарифтің лимитіне кіре ме?** Жоқ, sandbox счёттары айлық лимитке есептелмейді және сынақ мерзімін де бастамайды.

**Кассир нөмірімен клиенттің нөмірі бір бола ала ма?** Жоқ, бұл екі бөлек нөмір. Оның үстіне кассир нөмірімен Kaspi Pay қосымшасына кірмеу керек — байланыс үзіледі.

**Клиентке счёт қайта жіберуге бола ма?** Ескісін болдырмай, жаңа счёт жасаңыз. Сол сомамен жаңа push кетеді.

**Клиент «нөмірімді білмейсіңдер ме» деп сұрайды.** Счёт туралы хабарламада кассир нөмірі көрінеді — бұл Kaspi-дің қалыпты жұмысы, сіздің баптауыңызға байланысты емес.