# Чектер және оларды клиентке жеткізу

> Qut Pay-дің чек беті, оның нөмірленуі және не көрсететіні. Email арқылы жіберу, API мен webhook-тағы өрістер, Kaspi чегінің сілтемесі неге клиентке ашылмайды.

## Қысқаша

Счёт төленген сәтте Qut Pay оған **чек беті** жасайды: `https://api.qut.kz/receipt/<счёт идентификаторы>`. Ол — төлем туралы растама, клиентке де, өзіңізге де жарайды. Сілтеме API жауабында, webhook-та, кабинеттегі счёт тізімінде және Telegram хабарламасында бірдей келеді.

Бұл бет **фискалды чек емес**. Клиенттің ККМ чегін Kaspi өзі шығарады және оның Kaspi қосымшасына жібереді: [Фискалды чек](/kb/fiscal-receipt).

Клиенттің email-ы белгілі болса, төлем расталған соң оған хат кетеді — ол үшін кабинетте SMTP бапталған болуы керек.

## Чек беті нені көрсетеді

| Жол | Қайдан алынады |
|---|---|
| Дүкен атауы | Кабинет → Баптау → дүкен атауы (болмаса ұйым атауы) |
| Заңды атауы және БИН/ЖСН | Ұйым деректері, толтырылған болса |
| Чек нөмірі | Автоматты: `ЖЫЛ-000001` түрінде, әр ұйымға жыл сайын жаңадан |
| Күйі | «Төленді», «Толық қайтарылды» немесе «Ішінара қайтарылды» |
| Күні | Төлем расталған уақыт |
| Қызмет | Счёттың сипаттамасы (бос болса «Төлем») |
| Тапсырыс № | Сіздің `externalOrderId` мәніңіз, берілген болса |
| Клиент | Счётта көрсетілген аты |
| Төлем әдісі | «Kaspi QR» немесе «Kaspi счёт» |
| Қайтарылды | Қайтару болса, қайтарылған сомасы |
| Сумма | Счёттың сомасы |

Бетте **Басып шығару** батырмасы бар — браузердің баспа терезесі ашылады, PDF етіп сақтауға да болады. Sandbox счёттарында `SANDBOX` белгісі тұрады.

Чек нөмірі ұйым ішінде бірізді: жыл басында `2026-000001` деп басталып, әр төленген счётқа бір-бірден өседі. Нөмір бір рет беріледі және өзгермейді.

Чек беті іздеу жүйелеріне индекстелмейді, бірақ сілтемені білген адам оны аша алады — сондықтан сілтемені тек клиентке және өз жүйелеріңізге беріңіз.

## Чек қашан пайда болады

Чек **төлем расталғанда** ғана жасалады. Ашық (`new`, `pending`), болдырылған немесе мерзімі өткен счёттың чегі жоқ — ол адресті ашсаңыз «Чек табылмады» деп жауап береді.

Қайтару жасалса, чек жойылмайды: сол бет қайта ашылады, бірақ күйі «Толық қайтарылды» немесе «Ішінара қайтарылды» болып, қайтарылған сомасы бөлек жолмен көрсетіледі. Қайтару туралы: [Қайтару API](/kb/refunds-api).

## Клиентке қалай жеткізу керек

**Төлем бетінен.** Клиент төлеп болған соң төлем бетінің өзінде «Чекті ашу» батырмасы пайда болады. Ештеңе жасаудың қажеті жоқ.

**Email арқылы.** Счёт жасағанда `customer.email` берсеңіз және кабинетте SMTP бапталған болса, төлем расталған соң клиентке хат кетеді: сомасы, қызметтің атауы және чек сілтемесі. Бұл хатты кабинеттегі баптаудан өшіруге болады. SMTP бапталмаса хат жіберілмейді — жіберу әрекеті журналда «өткізілді» деп белгіленеді.

**Өз жүйеңізден.** `invoice.paid` webhook-ында чектің нөмірі де, сілтемесі де келеді — оны өз хатыңызға, СМС-ыңызға немесе тапсырыс бетіңізге қоюға болады.

**Telegram арқылы.** Ұйымға байланысқан чатқа төлем хабарламасы келгенде, оның астында **🧾 Чек** батырмасы тұрады.

## API мен webhook-тағы өрістер

Счёт объектісінде үш өріс бар:

| Өріс | Мәні |
|---|---|
| `receiptNumber` | Чектің нөмірі, мысалы `2026-000123`. Төленбеген счётта `null` |
| `receiptUrl` | Біздің чек бетіміздің толық адресі. Төленбеген счётта `null` |
| `providerReceiptUrl` | Kaspi қайтарған чек сілтемесі, болса |

Есеп-қисапта чектің нөмірін `externalOrderId` мәніңізбен бірге сақтаған ыңғайлы: сонда тапсырысты да, чекті де бір жолдан табасыз.

## Kaspi чегінің сілтемесі неге ашылмайды

Kaspi кейбір төлемдерге өз чегінің сілтемесін қайтарады. Бірақ ол сілтеменің бір түрі — **кассирдің қарау сілтемесі**: ол тек Kaspi кассирінің белсенді сессиясы ішінде ашылады. Клиент оны өз телефонынан ашса, «чекті алу мүмкін болмады» дегенді ғана көреді.

Сондықтан ондай сілтемені **клиентке көрсететін беттен алып тастадық**. Ол тек сіздің жағыңызда қалады: API жауабында, webhook-та және мерчант хабарламасында.

Клиент өзінің фискалды чегін басқа жерден алады — **өз Kaspi қосымшасының «Хабарламалар» бөлімінен**. Kaspi Касса қосулы болса, чек сонда автоматты түседі. Оны бізден сұрап әуре болудың қажеті жоқ, біз ККМ чегін шығармаймыз.

Егер Kaspi қайтарған сілтеме кассирге ғана арналған түрде болмаса, ол чек бетінде «Kaspi чегі» батырмасы ретінде көрінеді.

## Чек дұрыс көрінбесе

| Не болып тұр | Себебі |
|---|---|
| Дүкен атауының орнына ұйым атауы | Кабинет → Баптау → дүкен атауы толтырылмаған |
| Заңды атауы мен БИН жоқ | Ұйым деректері толтырылмаған: [Ұйым деректерін толтыру](/kb/org-settings) |
| Қызметтің орнына «Төлем» | Счёт жасағанда сипаттама берілмеген |
| Тапсырыс нөмірі жоқ | `externalOrderId` жіберілмеген |
| «Чек табылмады» | Счёт әлі төленбеген, немесе идентификатор қате |
| Клиентке хат келмеді | SMTP бапталмаған, `customer.email` берілмеген, немесе хат спамға түскен |

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

**Чекті қайта жіберуге бола ма?** Сілтеменің өзі тұрақты — оны кабинеттен көшіріп, кез келген арнамен қайта жіберсеңіз болады.

**Чек нөмірлері үзіліп кетеді, неге?** Нөмір тек төленген счётқа беріледі. Төленбеген счёттар нөмір алмайды, сондықтан аралықтар счёттар тізімінде емес, чектер тізбегінде болмайды — тізбек үзілмейді.

**Sandbox чегі есепке жарай ма?** Жоқ. Ол тест жазбасы, бетінде `SANDBOX` белгісі тұрады.

**Клиент «фискалды чек керек» деп тұр.** Оны біз бере алмаймыз. Kaspi Касса қосулы болса, чек клиенттің Kaspi қосымшасына өзі түскен: [Фискалды чек](/kb/fiscal-receipt).

**Чекте клиенттің телефоны көріне ме?** Жоқ. Бетте тек аты көрсетіледі. Клиент жалпы не көретіні туралы: [Клиент не көреді](/kb/what-customer-sees).