MaviBot-те Clip пайдалану үшін Clip тіркелгіңізде жұп тіркелгі деректерін жасап, оларды төлем жүйесі параметрлеріне енгізуіңіз керек.
Clip — Мексикалық төлем қызметі.
Тіркелгі деректерін алу
Clip-пен келісімге қол қойып, Clip тіркелгіңіздегі Developer Dashboard (Әзірлеуші панеліне) қол жеткізіңіз.
Тіркелгі деректері бөлімінде Crear credencial (Тіркелгі деректерін жасау) түймесін басып, атауын енгізіп, жасауды растаңыз.
Келесі тіркелгі деректерін көшіріп алыңыз:
- API key (API кілті)
- Clave secreta (Құпия кілт)
Маңызды! Құпия кілт тіркелгі деректері жасалғаннан кейін бір рет қана көрсетіледі. Оны қауіпсіз жерде сақтаңыз. Clip тіркелгіңізде оны қайта көре алмайсыз. Егер жоғалтып алсаңыз, жаңа жұп тіркелгі деректерін жасауыңыз керек.
Тіркелгі деректері өндірістік және сынақ орталары үшін бөлек жасалады. Бір тіркелгіге 6 қосымшаға дейін жасай аласыз.
Интеграцияны тестілеу үшін сынақ жұбын жасаңыз. Нақты төлемдерді қабылдау үшін өндірістік тіркелгі деректерін пайдаланыңыз.
Clip тіркелгіңізде төлем туралы хабарландыру URL мекенжайын конфигурациялаудың қажеті жоқ. MaviBot әрбір төлем жасалған кезде хабарландыру URL мекенжайын автоматты түрде жібереді.
Clip-ті қосу
Acquiring (Эквайринг) қойыншасында Clip таңдап, келесілерді енгізіңіз:
| Өріс | Сипаттамасы |
|---|---|
| API key (API кілті) | Қосымша идентификаторы. |
| Secret key (Clave secreta) (Құпия кілт) | Қосымшаның құпия кілті. |
Қосылу аяқталды.
Төлем сілтемесін жасау
Келесі Calculator функциясын пайдаланыңыз:
get_clip_payment_url(amount, description, currency, customer_email, customer_phone, full_name, product_name, language)
Параметрлер
| Параметр | Сипаттамасы |
|---|---|
amount |
Төлем сомасы. Міндетті. Ең төменгі сома негізгі валюта бірлігінде 1. Соманы 100.55 деп көрсетіңіз, 10055 емес. |
description |
Төлем сипаттамасы. Қосымша. Ең ұзындығы: 250 таңба. Тұтынушы оны төлем бетінде және түбіртекте көре алады. |
currency |
Үш әріпті валюта коды (MXN және Clip тіркелгіңіз үшін қолжетімді басқа валюталар). Қосымша. Әдепкі: MXN. |
customer_email |
Тұтынушының электрондық пошта мекенжайы. Қосымша. Төлем нысанына автоматты түрде енгізіледі. |
customer_phone |
Тұтынушының телефон нөмірі. Қосымша. Төлем нысанына автоматты түрде енгізіледі. |
full_name |
Тұтынушының аты-жөні. Қосымша. Төлем нысанына автоматты түрде енгізіледі. |
product_name |
Өнім атауы. Қосымша. |
language |
Төлем бетінің тілі: es — испан тілі (әдепкі) немесе en — ағылшын тілі. |
Функция төлем URL мекенжайын қайтарады.
Төлем сілтемесі түймесі
Тұтынушыға төлем түймесін жіберу үшін:
- Pay (Төлеу) функциясы бар түймені жасаңыз.
- Төлем жүйесі ретінде Clip таңдаңыз.
- Өнім атауын, сомасын және валютасын көрсетіңіз.
- Қажет болса, тұтынушының аты-жөнін, электрондық пошта мекенжайын және телефон нөмірін қамтитын айнымалыларды көрсетіңіз.
Төлем қоңыраулары (Callbacks)
Тұтынушы төлем сілтемесі бойынша өтіп, төлемді аяқтағаннан кейін MaviBot қоңырау алады.
Сәтті төлем
Мысал:
SDJ91MTKTT_success 100.55
Мұнда:
-
SDJ91MTKTT— API кілтіңіздің алғашқы 10 таңбасы. -
100.55— төлем сомасы.
Сәтсіз төлем
Егер төлем сәтсіз болса, келесі қоңырау жіберіледі:
SDJ91MTKTT_fail 100.55
Маңызды! Сәтсіз төлем туралы қоңырау төлем сілтемесі толығымен жабылғаннан кейін ғана жіберіледі: 5 сәтсіз төлем әрекетінен кейін немесе сілтеменің мерзімі біткенде.
Тұтынушыда әлі төлем әрекеттері болса, сілтеме белсенді күйінде қалады және сәтсіз төлем туралы қоңырау жіберілмейді.
Сәтті төлемнен кейінгі тұтынушы айнымалылары
| Айнымалы | Сипаттамасы |
|---|---|
clip_callback_data |
Clip төлем жүйесінен алынған төлем ақпараты. |
clip_payment_completed |
Егер төлем сәтті өңделсе, "True". |
clip_payment_request_id |
Clip-тегі төлем сілтемесінің идентификаторы. |
clip_receipt_no |
Clip түбіртегінің нөмірі. |