Lai izmantotu PagBank kā maksājumu pakalpojumu sniedzēju Mavibot, jums ir jāiegūst piekļuves pilnvara no sava PagBank konta un jāievada tā maksājumu iestatījumos.

Pilnvaras iegūšana

Ražošanas vide: pierakstieties savā PagBank kontā no datora, dodieties uz Vendas → Integrações (Pārdošana → Integrācijas) un noklikšķiniet uz Gerar token (Ģenerēt pilnvaru).

Testa vide (smilškaste): pierakstieties PagBank izstrādātāju portālā, atveriet cilni Tokens un nokopējiet savu smilškastes pilnvaru.

Pilnvara tiek parādīta tikai vienu reizi. Uzglabājiet to drošā vietā: ja to pazaudēsiet, jums būs jāģenerē jauna, un vecā pilnvara pārstās darboties.

Jums nav jākonfigurē maksājuma paziņojuma URL savā PagBank kontā — Mavibot to nodrošina automātiski, veidojot katru maksājumu.

Iestatīšana

Maksājumu sistēmas iestatījumos atlasiet PagBank un ievadiet:

  • Pilnvara — API piekļuves pilnvara no jūsu PagBank konta.
  • Testa režīms — iespējojiet to, ja esat ievadījis smilškastes pilnvaru. Testa režīmā pieprasījumi tiek nosūtīti uz sandbox.api.pagseguro.com, un reāla nauda netiek norakstīta.

Iestatīšana ir pabeigta.

Maksājuma saites izveide

Kalkulatora funkcija:

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

Parametri

Parametrs Apraksts
amount Maksājuma summa. Obligāts. Minimums: 1 BRL; maksimums: 9 999 999 BRL. Ievadiet summu kā 100.55, nevis 10055.
description Maksājuma apraksts. Neobligāts, līdz 255 rakstzīmēm. Klients to redzēs maksājuma lapā.
product_name Produkta nosaukums, līdz 100 rakstzīmēm. Neobligāts; pēc noklusējuma tiek izmantots description.
customer_email Klienta e-pasta adrese. Neobligāts; iepriekš aizpildīts maksājuma lapā.
customer_phone Klienta tālruņa numurs. Neobligāts; iepriekš aizpildīts maksājuma lapā. PagBank pieņem tikai Brazīlijas mobilos numurus: valsts kods 55, divciparu apgabala kods un deviņciparu numurs, kas sākas ar 9 (piemēram, +55 11 99999-8888).
full_name Klienta vārds un uzvārds. Neobligāts; iepriekš aizpildīts maksājuma lapā.
identity_number Klienta CPF (11 cipari) vai CNPJ (14 cipari). Neobligāts; iepriekš aizpildīts maksājuma lapā.

Funkcija atgriež maksājuma saiti.

PagBank pieņem klienta datus tikai kā pilnu komplektu: jānorāda vārds, e-pasts, tālruņa numurs un CPF/CNPJ. Ja trūkst kāda no šiem četriem laukiem vai tālruņa numurs nav derīgs Brazīlijas mobilais numurs, Mavibot nenosūtīs PagBank nevienu no klienta datiem. Klients tos vienkārši aizpildīs maksājuma lapā. Tas neietekmē pašu maksājumu.

Maksājuma saite pogā

Lai nosūtītu pogu ar maksājuma saiti, atlasiet maksājuma pogas veidu un izvēlieties PagBank kā maksājumu sistēmu. Ievadiet produkta nosaukumu un maksājuma summu. Ja nepieciešams, norādiet mainīgos, kas satur klienta vārdu, e-pasta adresi un tālruņa numuru.

Atzvanīšana pēc maksājuma

Pēc tam, kad klients seko saitei un pabeidz maksājumu, dialogā tiks nosūtīta veiksmīga maksājuma atzvanīšana:

A1B2C3D4E5_success 100.55

Šeit A1B2C3D4E5 ir jūsu pilnvaras pirmās 10 rakstzīmes, un 100.55 ir maksājuma summa.

Ja maksājums neizdodas, tiks nosūtīta šāda atzvanīšana:

A1B2C3D4E5_fail 100.55

Neveiksmīgas atzvanīšana tiek nosūtīta tikai tad, kad maksājuma saiti vairs nevar izmantot: banka ir neatgriezeniski noraidījusi vai atcēlusi maksājumu, vai arī maksājuma saite ir beigusies. Atzvanīšana netiek nosūtīta, kamēr maksājums tiek pārskatīts, gaida boleto maksājumu vai ir autorizēts, bet joprojām ir aizturēts kartē, jo maksājuma saite paliek aktīva. Beidzies maksājuma saitei nav saistīta maksājuma, tāpēc atzvanīšana neietvers summu.

Lai apstrādātu veiksmīgu vai neveiksmīgu maksājumu, rīkojieties šādi:

  1. Izveidojiet bloku ar trigeri (pelēks Trigger bloks vai zaļš Start bloks — izmantojiet zaļo bloku, ja vēlaties turpināt piltuves veidošanu pēc maksājuma).
  2. Laukā Trigger ievadiet atzvanīšanu bez maksājuma summas:
A1B2C3D4E5_success

Izmantojiet šo opciju, ja vēlaties, lai bloks reaģētu uz katru veiksmīgu maksājumu.

Iestatiet atbilstības veidu uz Atslēgvārda atbilstība.

Alternatīvi ievadiet pilnu atzvanīšanu:

A1B2C3D4E5_success 100.55

Izmantojiet šo opciju, ja vēlaties, lai bloks reaģētu tikai uz maksājumu par noteiktu summu.

Iestatiet atbilstības veidu uz Precīza atbilstība.

Klienta mainīgie pēc veiksmīga maksājuma

Mainīgais Vērtība
pagbank_callback_data Maksājuma informācija, kas saņemta no maksājumu sistēmas
pagbank_payment_completed "True" — maksājums ir veiksmīgi apstrādāts
pagbank_order_id PagBank pasūtījuma ID (ORDE_…)
pagbank_charge_id PagBank maksas ID (CHAR_…)
pagbank_payment_method Maksājuma metode: CREDIT_CARD, DEBIT_CARD, PIX vai BOLETO