PayTabs-ты Mavibot-қа қосу
PayTabs-ты Mavibot-қа қосу үшін PayTabs тіркелгіңізде бірнеше параметрлерді конфигурациялау қажет.
1. API кілтін жасау
PayTabs бақылау тақтасында келесіге өтіңіз:
Developers → API Keys
Жаңа API кілтін жасаңыз.
API кілтін жасағаннан кейін келесі мәліметтерді сақтаңыз:
- Server Key — интеграцияны орнату үшін қажет.
- Profile ID — қосылымды орнату үшін де қажет.
2. Төлем хабарландыруларын конфигурациялау
Келесіге өтіңіз:
Developers → Configuration
Төлем хабарландыруларын (callbacks) қосыңыз.
"+" түймесін басып, келесі callback URL мекенжайын қосыңыз:
https://chatter.mavibot.ai/paytabs_callback/result
Бұл URL Mavibot-қа төлем күйінің жаңартуларын жіберу үшін пайдаланылады.
3. Mavibot-та PayTabs-ты конфигурациялау
Mavibot параметрлерінде:
- Acquiring бөліміне өтіңіз
- Төлем провайдері ретінде PayTabs таңдаңыз
- Келесі мәліметтерді енгізіңіз:
- Profile ID
- Server Key
- PayTabs тіркелгі аймағын таңдаңыз
Назар аударыңыз!
Таңдалған аймақ PayTabs тіркелгіңіз тіркелген аймаққа сәйкес келуі керек.
Параметрлер сақталғаннан кейін интеграцияны орнату аяқталады.
Төлем сілтемесін жасау
Төлем сілтемесін жасау үшін келесі функцияны пайдаланыңыз:
get_paytabs_payment_url(amount, description, currency, customer_email, customer_phone, full_name, language)
Функция параметрлері
| Параметр | Сипаттама |
|---|---|
| ! amount | Төлем сомасы. Міндетті параметр |
| description | Төлем сипаттамасы. Қосымша параметр |
| currency | Төлем валютасы. Қосымша параметр |
| customer_email | Тұтынушының электрондық поштасы. Қосымша параметр |
| customer_phone | Тұтынушының телефон нөмірі. Қосымша параметр |
| full_name | Тұтынушының толық аты. Қосымша параметр |
| language | Төлем бетінің тілі. Қосымша параметр |
Қолжетімді валюталар
Келесі валюта кодтары қолдау көрсетіледі:
SAR, AED, BHD, EGP, EUR, GBP, HKD, IDR,INR, IQD, JOD, JPY, KWD, MAD, OMR,PKR, QAR, USD
Қолжетімді тілдер
en — Ағылшыншаar — Арабшаfr — Французша
Функция төлем URL мекенжайын қайтарады.
Егер currency параметрі берілмесе, валюта конфигурацияланған аймаққа байланысты автоматты түрде таңдалады.
Төлем сілтемесін батырмада пайдалану
Тұтынушыға төлем батырмасын жіберу үшін:
- Төлем түрімен батырма жасаңыз
- Төлем провайдері ретінде PayTabs таңдаңыз
- Көрсетіңіз:
- төлем сипаттамасы;
- төлем сомасы;
- валюта.
Төлем күйін өңдеу
Тұтынушы төлем сілтемесін ашып, төлемді аяқтағаннан кейін, әңгімеге callback оқиғасы жіберіледі.
Сәтті төлем
Мысал:
SDJ91MTKTT_success 100
Мұнда:
- SDJ91MTKTT — Server Key кілтінің алғашқы 10 таңбасы
- 100 — төлем сомасы
Сәтті төлем үшін әрекет жасау үшін Builder бөліміне өтіп, триггері бар блок жасаңыз (бұл Start блогы немесе Trigger блогы болуы мүмкін).
Содан кейін Trigger өрісіне енгізіңіз:
- толық callback мәні (егер әрекетті тек белгілі бір төлем сомасы үшін іске қосқыңыз келсе), немесе
- төлем сомасына дейінгі callback мәні ғана (егер әрекетті барлық сәтті төлемдер үшін іске қосқыңыз келсе).
Сәтсіз төлем
Мысал:
SDJ91MTKTT_fail 100
Сәтсіз төлемді өңдеу сәтті төлемді өңдеу сияқты конфигурацияланады.
Триггері бар блок жасап, Trigger өрісіне callback мәнін енгізіңіз. Бұл төлем сәтсіз аяқталғанда орындалатын әрекеттерді анықтауға мүмкіндік береді.
Сәтті төлемнен кейін сақталған айнымалылар
Сәтті төлемнен кейін тұтынушы үшін келесі айнымалылар автоматты түрде сақталады:
paytabs_callback_data
Төлем жүйесінен алынған толық webhook жүктемесін қамтиды.
paytabs_payment_completed
Мәні:
True
Төлемнің сәтті аяқталғанын көрсетеді.