Mavibot-та төлем провайдері ретінде PagBank пайдалану үшін PagBank тіркелгіңізден қолжетімділік токенін алып, оны төлем параметрлеріне енгізуіңіз керек.

Токен алу

Өндірістік орта: компьютерден PagBank тіркелгіңізге кіріп, Vendas → Integrações (Сату → Интеграциялар) бөліміне өтіп, Gerar token (Токенді генерациялау) түймесін басыңыз.

Сынақ ортасы (sandbox): PagBank Developer порталына кіріп, Tokens қойыншасын ашып, sandbox токеніңізді көшіріңіз.

Токен бір рет қана көрсетіледі. Оны қауіпсіз жерде сақтаңыз: егер жоғалтып алсаңыз, жаңасын генерациялауға тура келеді, ал ескі токен жұмысын тоқтатады.

PagBank тіркелгіңізде төлем туралы хабарландыру URL мекенжайын конфигурациялаудың қажеті жоқ — Mavibot әрбір төлемді жасау кезінде оны автоматты түрде қамтамасыз етеді.

Орнату

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

  • Token — PagBank тіркелгіңізден алынған API қолжетімділік токені.
  • Test mode — егер sandbox токенін енгізген болсаңыз, осыны қосыңыз. Сынақ режимінде сұраулар sandbox.api.pagseguro.com мекенжайына жіберіледі және нақты ақша алынбайды.

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

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

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

get_pagbank_payment_url(amount, description, product_name, customer_email, customer_phone, full_name, identity_number)

Параметрлер

Параметр Сипаттама
amount Төлем сомасы. Міндетті. Минимум: 1 BRL; максимум: 9,999,999 BRL. Соманы 100.55 деп енгізіңіз, 10055 емес.
description Төлем сипаттамасы. Қосымша, 255 таңбаға дейін. Тұтынушы оны төлем бетінде көреді.
product_name Өнім атауы, 100 таңбаға дейін. Қосымша; әдепкі бойынша description пайдаланылады.
customer_email Тұтынушының электрондық пошта мекенжайы. Қосымша; төлем бетінде алдын ала толтырылады.
customer_phone Тұтынушының телефон нөмірі. Қосымша; төлем бетінде алдын ала толтырылады. PagBank тек бразилиялық ұялы телефон нөмірлерін қабылдайды: ел коды 55, екі таңбалы аймақ коды және 9-дан басталатын тоғыз таңбалы нөмір (мысалы, +55 11 99999-8888).
full_name Тұтынушының аты мен тегі. Қосымша; төлем бетінде алдын ала толтырылады.
identity_number Тұтынушының CPF (11 цифр) немесе CNPJ (14 цифр). Қосымша; төлем бетінде алдын ала толтырылады.

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

PagBank тұтынушы деректерін тек толық жиынтық ретінде қабылдайды: аты, электрондық пошта, телефон нөмірі және CPF/CNPJ барлығы берілуі керек. Егер осы төрт өрістің біреуі жоқ болса немесе телефон нөмірі жарамды бразилиялық ұялы нөмір болмаса, Mavibot тұтынушы деректерінің ешқайсысын PagBank-қа жібермейді. Тұтынушы оларды төлем бетінде жай ғана толтырады. Бұл төлемнің өзіне әсер етпейді.

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

Төлем сілтемесі бар түймені жіберу үшін төлем түймесінің түрін таңдап, төлем жүйесі ретінде PagBank таңдаңыз. Өнім атауы мен төлем сомасын енгізіңіз. Қажет болса, тұтынушының атын, электрондық пошта мекенжайын және телефон нөмірін қамтитын айнымалыларды көрсетіңіз.

Төлемнен кейінгі кері шақырулар

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

A1B2C3D4E5_success 100.55

Мұнда A1B2C3D4E5 — токеніңіздің алғашқы 10 таңбасы, ал 100.55 — төлем сомасы.

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

A1B2C3D4E5_fail 100.55

Сәтсіздік туралы кері шақыру төлем сілтемесін енді пайдалану мүмкін болмаған кезде ғана жіберіледі: банк төлемді түпкілікті қабылдамады немесе болдырмады, немесе төлем сілтемесінің мерзімі өтті. Төлем қарастырылып жатқанда, boleto төлемін күткенде немесе картада авторизацияланған, бірақ әлі күтіп тұрғанда кері шақыру жіберілмейді, себебі төлем сілтемесі әлі белсенді. Мерзімі өткен төлем сілтемесінде төлем болмайды, сондықтан кері шақыру соманы қамтымайды.

Сәтті немесе сәтсіз төлемді өңдеу үшін келесі қадамдарды орындаңыз:

  1. Триггері бар блокты жасаңыз (сұр Trigger блогы немесе жасыл Start блогы — төлемнен кейін воронканы құруды жалғастырғыңыз келсе, жасыл блокты пайдаланыңыз).
  2. Trigger өрісіне төлем сомасынсыз кері шақыруды енгізіңіз:
A1B2C3D4E5_success

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

Сәйкестендіру түрін Keyword Match етіп орнатыңыз.

Немесе толық кері шақыруды енгізіңіз:

A1B2C3D4E5_success 100.55

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

Сәйкестендіру түрін Exact Match етіп орнатыңыз.

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

Айнымалы Мәні
pagbank_callback_data Төлем жүйесінен алынған төлем туралы ақпарат
pagbank_payment_completed "True" — төлем сәтті өңделді
pagbank_order_id PagBank тапсырыс идентификаторы (ORDE_…)
pagbank_charge_id PagBank заряд идентификаторы (CHAR_…)
pagbank_payment_method Төлем әдісі: CREDIT_CARD, DEBIT_CARD, PIX немесе BOLETO