Қысқаша
Плагин мәселелерінің бәрі дерлік екі топқа бөлінеді. Счёт мүлде жасалмаса — кілт мәселесі: жоқ, қате көшірілген немесе режимге сәйкес емес. Счёт жасалып, тапсырыс күйі өзгермесе — webhook жетпей тұр: адрес қате, жабық немесе жария емес. Қайсысы екенін дүкеннің журналынан бірден көресіз.
Плагиндерді жүктеу: api.qut.kz/downloads. Орнату нұсқаулығы: api.qut.kz/docs/guide/wordpress.
Симптом → себеп → шешім
| Симптом | Себебі | Шешімі |
|---|---|---|
| Төлем әдісі кассада мүлде көрінбейді | Плагин қосылмаған немесе валюта сәйкес емес | Плагинді қосыңыз, дүкен валютасын тексеріңіз |
| «Төлеу» батырмасы қате береді | Кілт жоқ немесе қате көшірілген | Кілтті қайта көшіріңіз, бос орындарды алып тастаңыз |
| Қате мәтінінде 401 бар | Кілт жарамсыз немесе өшірілген | API 401 қайтарады |
| Қате мәтінінде 403 бар | Scope жетпейді немесе тариф белсенді емес | API 403 қайтарады |
| Счёт жасалады, бірақ клиентке келмейді | Тест кілті қойылған | Тест режимі қосулы қалып қойған |
| Клиент төледі, тапсырыс «күтілуде» күйінде | Webhook жетпей тұр | Webhook адресін тексеріңіз |
| Кейбір тапсырыс өтеді, кейбірі жоқ | Webhook адресі тұрақсыз немесе кэш қабаты бөгеп тұр | Журналды қараңыз |
1. Кілт дұрыс па
Плагиннің баптауындағы кілт — ең жиі кездесетін себеп.
- Толық көшірілген бе. Кілт
qp_live_немесеqp_test_деп басталады. Басы немесе соңы қиылып қалса, 401 келеді. - Артық бос орын бар ма. Көшіргенде соңына бос орын немесе жаңа жол ілесіп кетеді, оны көзбен көру қиын. Өрісті тазалап, қайта қойыңыз.
- Кілт әлі бар ма. Кабинетте ол кілт жойылған немесе өшірілген болуы мүмкін.
- Scope жеткілікті ме. Плагинге кем дегенде
invoices:writeжәнеinvoices:readкерек, қайтаруды қоссаңызrefunds:writeда керек.
Кілт дұрыс екенін тексерудің ең жылдам жолы — дүкеннен тыс, серверден бір сұрау жіберіп көру. Ол істесе, мәселе плагинде емес, баптаудағы мәтінде.
2. Режимге сәйкес пе
Екі жақта екі баптау бар және олар бір-біріне сәйкес келуі керек:
| Кабинеттегі режим | Плагиндегі кілт | Нәтиже |
|---|---|---|
| Live | qp_live_… | Нақты төлем, бәрі дұрыс |
| Sandbox | qp_test_… | Тест, нақты ақша жүрмейді |
| Live | qp_test_… | Тест счёттар, клиентке ештеңе келмейді |
| Sandbox | qp_live_… | Қате немесе күтпеген мінез |
Нақты дүкен sandbox-та қалып қойса, счёттар жасалып жатады, тапсырыстар түседі, ал ақша келмейді. Белгілері мен көшу реті: Тест режимі қосулы қалып қойған.
3. Webhook адресі жария ма
Тапсырыс күйі өзгермесе, дерлік әрқашан себебі осы. Плагин счёт жасай алады, бірақ төлем туралы хабарды ала алмайды.
Тексерілетін нәрселер:
- HTTPS және нақты домен. Продакшенде тек
https, IP-мекенжай мен уақытша туннель адрестері қабылданбайды. - Адрес авторизациясыз ашық. Егер сайтта «құрылыс жүріп жатыр» паролі, Basic Auth, «тек тіркелгендерге» ережесі тұрса, webhook жетпейді.
- Қорғаныс қабаттары бөгеп тұрған жоқ па. Cloudflare, ModSecurity, фаервол, «боттарды бөгеу» ережелері сырттан келген POST сұрауды тастауы мүмкін.
- Қайта бағыттау. 307/308 тек сол адрестің өзіне (http→https, қиғаш сызық) ұсталады. Басқа домендегі жерге апаратын қайта бағыттау ұсталмайды.
- Кэш. Толық бет кэші webhook адресіне тимеуі керек.
Егер сіздің жауабыңыз 2xx болмаса, жеткізу 11 рет қайталанады (10 секундтан бір сағатқа дейін өсіп отырады). Яғни уақытша ақау болса, тапсырыстар кейін өз-өзінен өтуі мүмкін.
Толық диагностика: Webhook келмей жатыр.
4. Дүкен журналын оқыңыз
Журнал — ең нақты дерек көзі, болжам емес.
- WooCommerce: WooCommerce → Күй → Журналдар. Плагин өз жазбаларын сонда қалдырады.
- OpenCart: Есептер → Қателер журналы, сондай-ақ сервердің PHP қате журналы.
- Кабинеттегі Интеграциялар бөлімінде webhook жеткізулерінің журналы бар: не жіберілді, қандай жауап келді.
Екі журналды салыстырыңыз. Біздің жақта жіберілген, ал дүкенде түспеген болса — мәселе дүкенге кірер жолда (фаервол, авторизация, кэш). Біздің жақта мүлде жіберілмеген болса — webhook адресі қосылмаған немесе оқиға түрі таңдалмаған.
Орнату мен нұсқаулық
Плагин мен кеңейтудің дұрыс нұсқасын жүктеп алыңыз: api.qut.kz/downloads. Егер сайтта ескі нұсқа тұрса, алдымен жаңартып көріңіз — кейбір мәселелер сонда шешіліп қойған.
Қадамдап орнату: api.qut.kz/docs/guide/wordpress. Баптау мен тапсырыс күйлерінің сәйкестігі: WooCommerce плагині, OpenCart 4 кеңейтуі.
Жиі қойылатын сұрақтар
Плагин жұмыс істеп тұрғанын қалай тексеремін? Кабинетті sandbox режиміне қойып, плагинге тест кілтін беріңіз де, бір тапсырыс жасаңыз. Счёт пайда болса және төлемді симуляциялағанда тапсырыс күйі өзгерсе — тізбек толық жұмыс істеп тұр.
Тапсырыс күйі қайтарудан кейін өзгере ме? Ол плагиннің баптауына байланысты. Қайтару үшін кілтке refunds:write құқығы керек.
Локалды серверде (localhost) сынауға бола ма? Счёт жасауға болады, бірақ webhook жетпейді: сыртқы адресі жоқ серверге хабарлама келмейді. Сынауды жария адресі бар ортада жүргізіңіз.
Плагинді ауыстырсам, ескі тапсырыстар жоғала ма? Жоқ. Тапсырыстар дүкенде қалады, счёттар бізде қалады.
Екі дүкенге бір кілт беруге бола ма? Болады, бірақ дұрысы — әр дүкенге бөлек кілт. Сонда біреуі бұзылса, екіншісіне тимейді әрі есепті бөлек жүргізуге ыңғайлы.