Mercado Pago төлем жүйесін пайдалану үшін төмендегі параметрлерді Mercado Pago Developers бақылау тақтасында орнатыңыз, содан кейін мәліметтерді интеграция параметрлеріне енгізіңіз.
Қолданба және кіру токені
- Mercado Pago жүйесіне кіріп, Developers бөлімін ашыңыз (Developers / Suas integrações).
- Егер әлі жоқ болса, қолданба жасаңыз (Your integrations → Create application).
- Production Access Token немесе Test Access Token көшіріп алыңыз — бұл токен негізгі API токені ретінде пайдаланылады.
Токен түрлері және оларды қайдан табуға болатыны туралы ақпаратты мына жерден қараңыз: Credentials.
Webhooks (төлем хабарландырулары)
- Интеграция параметрлерінде Webhooks / уведомления бөлімін ашыңыз (қараңыз: Webhooks).
- Хабарландыру URL мекенжайын орнатыңыз:
https://chatter.mavibot.ai/mercado_pago_callback/result
- Payments оқиғаларына жазылыңыз, осылайша сіз төлем жасау және күйінің өзгеруі туралы хабарландырулар ала аласыз.
- Webhook secret сақтаңыз — ол интеграция параметрлеріне енгізілуі керек.
Mavibot жүйесіне қосылу
Acquiring бөлімінде Mercado Pago таңдаңыз.
Содан кейін енгізіңіз:
- Access Token — сіз көшіріп алған токен.
- Webhook secret — вебхуктарды тексеру үшін пайдаланылатын құпия сөз.
Төлем сілтемесін жасау
Калькулятор функциясы:
get_mercado_pago_payment_url(amount, description, currency, customer_email, product_name)
Функция төлем сілтемесін қайтарады.
Түйме арқылы төлем
Mercado Pago арқылы төлем түймесін жіберу үшін түйме құрастырушыда төлемді қолдайтын түйме түрін таңдап, төлем жүйесі ретінде Mercado Pago таңдаңыз. Қажет болса, соманы, сипаттаманы және валютаны енгізіңіз.
Төлемнен кейінгі диалогтағы кері шақырулар
Сәтті төлем
Клиент сілтеме бойынша өтіп, төлемді сәтті аяқтағаннан кейін диалогқа келесі форматта кері шақыру жіберілуі мүмкін:
<Webhook_secret_алғашқы_10_таңбасы>_success <сома>
Мысал:
gltubgnDle_success 100 — мұнда префикс сіздің Webhook secret құпия сөзінің алғашқы 10 таңбасы, ал 100 — төлем сомасы.
Сәтті төлемге реакцияны қалай қосуға болады
Төлем сәтті аяқталғаннан кейін клиентіңізге хабарлама жіберу үшін (мысалы, "Төлем сәтті аяқталды" немесе кез келген басқа хабарлама), триггері мен кері шақыруы бар блокты пайдаланып реакцияны орнату қажет.
1-қадам
Шарты бар блок жасаңыз (Start block немесе Trigger block).
2-қадам
Кері шақырудың бір бөлігін (егер сізге барлық төлемдерге әрекет ету қажет болса, мысалы, бірнеше түрлі өнімдеріңіз болса) немесе толық кері шақыруды (егер сіз тек белгілі бір өнімді сатуға реакция орнатқыңыз келсе) көрсетіңіз.
3-қадам
Сәтті төлемге арналған жауап хабарламасын жазыңыз және блокты сақтаңыз.
Сәтсіз төлем
Егер төлем сәтсіз аяқталса (қабылданбады, болдырылмады және т.б., API күйіне байланысты), келесі форматта кері шақыру жіберілуі мүмкін:
<Webhook_secret_алғашқы_10_таңбасы>_fail <сома>
Мысал:
gltubgnDle_fail 100 — мұнда префикс сіздің Webhook secret құпия сөзінің алғашқы 10 таңбасы, ал 100 — сома.
Сәтсіз төлемге реакцияны қалай қосуға болады
Төлем сәтсіз аяқталғаннан кейін клиентіңізге хабарлама жіберу үшін (мысалы, "Төлем сәтсіз аяқталды" немесе кез келген басқа хабарлама), триггері мен кері шақыруы бар блокты пайдаланып реакцияны орнату қажет.
Сәтсіз төлемге реакция сәтті төлемге реакция сияқты конфигурацияланады.
1-қадам
Шарты бар блок жасаңыз (Start block немесе Trigger block).
2-қадам
Кері шақырудың бір бөлігін (егер сізге барлық төлемдерге әрекет ету қажет болса, мысалы, бірнеше түрлі өнімдеріңіз болса) немесе толық кері шақыруды (егер сіз тек белгілі бір өнімді сатуға реакция орнатқыңыз келсе) көрсетіңіз.
3-қадам
Сәтсіз төлемге арналған жауап хабарламасын жазыңыз және блокты сақтаңыз.
Сәтті төлемнен кейінгі клиент айнымалылары
| Айнымалылар | Сипаттама |
|---|---|
| mercado_pago_callback_data | Төлем жүйесінен алынған төлем туралы ақпарат. |
| mercado_pago_payment_completed | “True” — төлем сәтті өңделді. |
| mercado_pago_payment_id | Mercado Pago төлем идентификаторы |