Mavibot-та EBANX төлем платформасын пайдалану үшін EBANX тіркелгіңізден Интеграция кілтін алып, оны төлем параметрлеріне енгізу қажет.

EBANX — Латын Америкасындағы жергілікті төлем әдістерінің агрегаторы. Төлемдер EBANX-те орналастырылған қауіпсіз төлем бетінде өңделеді, онда тұтынушылар өз елінде қолжетімді төлем әдістерін көреді (мысалы, Бразилияда PIX және boleto, Мексикада OXXO және SPEI, Колумбияда PSE, несие/дебет карталары және т.б.).

Интеграция кілтін алу

EBANX-пен келісімге қол қойып, EBANX Business Portal-ға (сатушының басқару панелі) қол жеткізіңіз.

Орнату процесі кезінде төлемдерді қабылдағыңыз келетін елдерді таңдаңыз. Тұтынушылар тек EBANX тіркелгіңізде қосылған елдерден ғана төлей алады.

Интеграция параметрлерінде Интеграция кілтін көшіріп алыңыз. Ол EBANX-ті Mavibot-қа қосу үшін қажет болады.

Тестілеу мақсатында EBANX өзінің Интеграция кілті бар жеке sandbox тіркелгісін ұсынады. Төмендегі Тест режимін қараңыз.

EBANX-ті қосу

Төлем жүйелері параметрлерінде EBANX таңдап, келесіні енгізіңіз:

  • Интеграция кілті — көшірілген EBANX Интеграция кілті.
  • Ел — әдепкі төлем елі (екі әріптен тұратын кіші әріппен жазылған ел коды: Бразилия үшін br, Мексика үшін mx, Колумбия үшін co, Чили үшін cl, Перу үшін pe, Аргентина үшін ar және т.б.). Бұл тұтынушылардың төлем бетінде қандай төлем әдістерін көретінін анықтайды. Таңдалған ел EBANX тіркелгіңізде қосылған болуы керек.
  • Тест режимі — EBANX sandbox ортасын пайдаланып интеграцияны тексеру үшін осы опцияны қосыңыз. Тест режимі қосылған кезде sandbox тіркелгіңіздегі Интеграция кілтін пайдаланыңыз. Нақты төлемдерді қабылдау үшін Тест режимін өшіріп, нақты Интеграция кілтін пайдаланыңыз.

Орнату аяқталды.

Төлем сілтемесін жасау

Калькулятор функциясы:

get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)

Параметрлер

  • amount — төлем сомасы. Міндетті.

  • customer_email — тұтынушының электрондық пошта мекенжайы. Міндетті. EBANX онсыз төлем жасай алмайды. Тұтынушы осы электрондық пошта мекенжайына төлем растауын да алады.

  • full_name — тұтынушының толық аты-жөні. Міндетті.

  • description — төлем сипаттамасы. Қосымша.

  • currency — төлем валютасы. Келесілердің бірін пайдалануға болады:

    • төлем елінің жергілікті валютасы (мысалы, BRL, MXN, COP, CLP, PEN, ARS және т.б.), немесе
    • EBANX тіркелгіңіздің валютасы (әдетте USD), бұл жағдайда EBANX соманы өз бағамы бойынша түрлендіреді.

    Қосымша. Әдепкі мәні — USD.

  • country — төлем елі (екі әріптен тұратын кіші әріппен жазылған ел коды). Қосымша. Егер көрсетілмесе, төлем параметрлерінде көрсетілген әдепкі ел пайдаланылады.

Функция төлем URL мекенжайын қайтарады.

Ескерту: Таңдалған валюта төлем елімен үйлесімді болуы керек. Ол елдің жергілікті валютасы немесе EBANX тіркелгіңіздің валютасы болуы керек. Мысалы, br (Бразилия) үшін BRL және USD жарамды, ал MXN жарамсыз.

Төлем сілтемесі түймесі

Төлем түймесін жіберу үшін Төлем түймесі түрін таңдап, төлем жүйесі ретінде EBANX таңдаңыз.

Енгізіңіз:

  • өнім атауы;
  • төлем сомасы;
  • валюта;
  • тұтынушының толық аты-жөні мен электрондық пошта мекенжайын қамтитын айнымалылар.

Қосымша төлем елін көрсетіңіз.

1-мысал: Жұмыс ағынын конфигурациялау

1-қадам. Бастау блогын жасаңыз.

Бастау блогы әдетте жұмыс ағынындағы бірінші қош келдіңіз хабарламасын және пайдаланушыға қажетті кіріспе ақпаратты көрсету үшін пайдаланылады.

2-қадам. Төменде көрсетілген блокты жасаңыз.

3-қадам. Қосылым параметрлеріне өтіңіз.

Тұтынушының жарамды электрондық пошта мекенжайын енгізгенін тексеру үшін келесі тұрақты өрнек қажет:

^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$

Сондай-ақ, Пайдаланушы деректерді енгізеді опциясын қосып, customer_email енгізіңіз.

4-қадам. Екінші блокқа хабарламаны енгізіңіз.

5-қадам. Үшінші блокты жасап, екінші және үшінші блоктар арасындағы Қосылым параметрлерін ашыңыз.

Келесі блокқа автоматты түрде өту үшін таймерді қосыңыз.

6-қадам. Үшінші блокта Калькулятор функциясын енгізіңіз.

Көшіруге арналған мысал:

amount = 1000
description = "Product1 is product of great reliability!"
currency = "BRL"
link = get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)

Егер USD-дан басқа валютада төлемдерді қабылдағыңыз келсе, төменде көрсетілгендей валютаны көрсетіңіз.

2-мысал. Төлем түймесі

Бұл мысал 1-мысалмен дерлік бірдей.

Дегенмен, төлем сілтемесін жасау функциясы бар үшінші блокты жасаудың орнына, екінші блокта түйме жасауға болады.

Ашылған терезеде:

  • Түйме мәтінін енгізіңіз.
  • Төлем функциясын таңдаңыз.
  • Төлем провайдері ретінде EBANX таңдаңыз.

Содан кейін келесіні енгізіңіз:

  • Өнім атауы.
  • Төлем сомасы.
  • Валюта (қосымша).
  • Клиенттің толық аты-жөні (қосымша). Мұны тұтынушының электрондық поштасын енгізу сияқты конфигурациялауға болады.
  • Тұтынушының электрондық поштасы — #{customer_email} айнымалысын енгізіңіз.

Содан кейін Қосу түймесін басыңыз.

Төлемнен кейінгі хабарландырулар

Тұтынушы төлем сілтемесін ашып, төлемді аяқтағаннан кейін, сәтті төлем кезінде әңгімеге келесі кері шақыру жіберіледі:

SDJ91MTKTT_success 100

Мұнда:

  • SDJ91MTKTT — Интеграция кілтіңіздің алғашқы 10 таңбасы.
  • 100 — төлем сомасы.

Егер төлем болдырылмаса, келесі кері шақыру жіберіледі:

SDJ91MTKTT_fail 100

Офлайн төлем әдістері үшін (мысалы, boleto, OXXO және т.б.) төлемді растау дереу жүзеге аспайды. EBANX кері шақыруды қаражатты алғаннан кейін ғана жібереді, бұл 1–3 жұмыс күнін алуы мүмкін. Кері шақыру төлем расталғаннан кейін автоматты түрде жеткізіледі.

Сәтті немесе сәтсіз төлемге жауапты қалай жіберуге болады

1-қадам. Триггер блогын жасаңыз.

2-қадам. Шарт өрісіне хабарландыру мәтінін SDJ91MTKTT_success — төлем сомасынсыз — енгізіңіз, егер әрбір төлемге әрекет еткіңіз келсе.

Бұл жағдайда Сәйкестік түрі Кілт сөздер бойынша болуы керек.

Немесе, егер белгілі бір төлемге әрекет еткіңіз келсе, Триггер өрісіне толық кері шақыру мәтінін енгізіңіз. Бұл жағдайда Сәйкестік түрі Дәл сәйкестік болуы керек.

Егер сәтті төлемнен кейін жұмыс ағынын жалғастырғыңыз келсе, Триггер блогының орнына Бастау блогын жасап, бот ағынын сол жерден құруды жалғастыра аласыз.

Сәтті төлемнен кейінгі тұтынушы айнымалылары

Айнымалы Мәні
ebanx_callback_data Төлем жүйесінен алынған төлем туралы ақпарат
ebanx_payment_completed "True" — төлем сәтті өңделді
ebanx_payment_hash EBANX-тегі төлем идентификаторы (hash)