Telr-ді қосу
MaviBot-та Telr төлем жүйесін пайдалану үшін Telr тіркелгіңізден дүкен деректерін алып, оларды төлем жүйесі параметрлеріне енгізуіңіз керек.
Дүкен деректерін алу
Telr компаниясымен келісімге қол қойып, саудагер тіркелгіңізге қол жеткізіңіз.
Дүкендер → Дүкен мәліметтері бөлімінде келесі мәндерді көшіріңіз:
| Telr өрісі | MaviBot өрісі |
|---|---|
| Дүкен ID | Дүкен ID |
| Аутентификация кілті | Аутентификация кілті |
Төлем хабарландыруларын конфигурациялау
Төлем беті (немесе Қауіпсіздік) → Транзакция кеңесі бөлімін ашып, келесі хабарландыру URL мекенжайын көрсетіңіз:
https://chatter.mavibot.ai/telr_callback/result
Хабарландыруларды алғыңыз келетін транзакция түрлерін таңдаңыз.
Сол бөлімде Құпия кілтті көшіріңіз. Бұл кілт хабарландыру қолтаңбаларын тексеру үшін пайдаланылады.
Маңызды! Транзакция кеңесін конфигурациялау міндетті. Онсыз MaviBot төлем хабарландыруларын алмайды және ботқа ешқандай кері шақыру жіберілмейді.
MaviBot-та Telr-ді қосу
Жоба параметрлерінде Төлем жүйелері бөлімін ашып, Telr таңдаңыз және келесі өрістерді толтырыңыз:
| Өріс | Сипаттама |
|---|---|
| Дүкен ID | Telr дүкеніңіздің сандық идентификаторы. |
| Аутентификация кілті | Төлем сілтемелерін жасау үшін пайдаланылады. |
| Құпия кілт | Төлем хабарландыруларының қолтаңбаларын тексеру үшін пайдаланылады. Онсыз төлем хабарландырулары қабылданбайды. |
| Тест режимі | Нақты ақшаны есептемей, Telr тест карталарын пайдаланып сынақ төлемдерін жасауға мүмкіндік береді. Нақты төлемдерді қабылдау үшін бұл опцияны өшіріңіз. |
Барлық өрістер толтырылғаннан кейін интеграция пайдалануға дайын.
Төлем сілтемесін жасау
Келесі Калькулятор функциясын пайдаланыңыз:
get_telr_payment_url(amount, description, currency, product_name)
Параметрлер
| Параметр | Сипаттама |
|---|---|
amount |
Төлем сомасы. Міндетті. |
description |
Төлем сипаттамасы. Қосымша. Максималды ұзындығы: 63 таңба. |
currency |
Үш әріпті валюта коды (AED, SAR, USD, EUR, GBP және Telr тіркелгіңіз үшін қолжетімді басқа валюталар). Қосымша. Әдепкі: AED. |
product_name |
Өнім атауы. Қосымша. |
Функция төлем сілтемесін қайтарады.
Маңызды! Төлем сілтемелері шектеулі уақытқа жарамды. Сілтемені жасағаннан кейін бірден тұтынушыға жіберіңіз.
Мысал
Төлем сілтемесі түймесі
Төлем түймесін жіберу үшін:
- Төлеу функциясы бар түймені жасаңыз.
- Төлем жүйесі ретінде Telr таңдаңыз.
- Көрсетіңіз:
- Өнім атауы
- Төлем сомасы
- Валюта
Төлем кері шақырулары
Тұтынушы төлемді аяқтағаннан кейін MaviBot автоматты түрде кері шақыруды алады.
Сәтті төлем
Мысал:
SDJ91MTKTT_success 100
Мұнда:
-
SDJ91MTKTT— Аутентификация кілтіңіздің алғашқы 10 таңбасы. -
100— төлем сомасы.
Сәтсіз немесе болдырылмаған төлем
Мысал:
SDJ91MTKTT_fail 100
Банк қарауындағы төлем
Егер төлем рұқсат етілген, бірақ банк қосымша тексеру үшін ұстап қалса, қарау аяқталғанша кері шақыру жіберілмейді.
Банк транзакцияны мақұлдағаннан немесе қабылдамағаннан кейін Telr хабарландыру жібереді және кері шақыру MaviBot-қа автоматты түрде жеткізіледі.
Сәтті төлемнен кейінгі тұтынушы айнымалылары
| Айнымалы | Сипаттама |
|---|---|
telr_callback_data |
Telr төлем жүйесінен алынған төлем ақпараты. |
telr_payment_completed |
Төлем сәтті өңделген болса, "True" мәні. |
telr_tran_ref |
Telr транзакция сілтемесі (tran_ref). |