Untuk menggunakan PagBank sebagai penyedia pembayaran di Mavibot, anda perlu mendapatkan token akses dari akaun PagBank anda dan memasukkannya ke dalam tetapan pembayaran.

Mendapatkan Token

Persekitaran pengeluaran: log masuk ke akaun PagBank anda dari komputer, pergi ke Vendas → Integrações (Jualan → Integrasi), dan klik Gerar token (Hasilkan token).

Persekitaran ujian (sandbox): log masuk ke Portal Pembangun PagBank, buka tab Tokens, dan salin token sandbox anda.

Token hanya dipaparkan sekali. Simpan di tempat yang selamat: jika anda kehilangannya, anda perlu menghasilkan token baharu, dan token lama akan berhenti berfungsi.

Anda tidak perlu mengkonfigurasi URL pemberitahuan pembayaran dalam akaun PagBank anda — Mavibot menyediakannya secara automatik semasa membuat setiap pembayaran.

Persediaan

Dalam tetapan sistem pembayaran, pilih PagBank dan masukkan:

  • Token — token akses API daripada akaun PagBank anda.
  • Mod ujian — aktifkan ini jika anda memasukkan token sandbox. Dalam mod ujian, permintaan dihantar ke sandbox.api.pagseguro.com, dan tiada wang sebenar dikenakan.

Persediaan selesai.

Mencipta Pautan Pembayaran

Fungsi kalkulator:

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

Parameter

Parameter Penerangan
amount Jumlah pembayaran. Diperlukan. Minimum: 1 BRL; maksimum: 9,999,999 BRL. Masukkan jumlah sebagai 100.55, bukan 10055.
description Penerangan pembayaran. Pilihan, sehingga 255 aksara. Pelanggan akan melihatnya pada halaman pembayaran.
product_name Nama produk, sehingga 100 aksara. Pilihan; description digunakan secara lalai.
customer_email Alamat e-mel pelanggan. Pilihan; diisi awal pada halaman pembayaran.
customer_phone Nombor telefon pelanggan. Pilihan; diisi awal pada halaman pembayaran. PagBank hanya menerima nombor mudah alih Brazil: kod negara 55, kod kawasan dua digit, dan nombor sembilan digit bermula dengan 9 (contohnya, +55 11 99999-8888).
full_name Nama pertama dan nama keluarga pelanggan. Pilihan; diisi awal pada halaman pembayaran.
identity_number CPF pelanggan (11 digit) atau CNPJ (14 digit). Pilihan; diisi awal pada halaman pembayaran.

Fungsi mengembalikan URL pembayaran.

PagBank menerima butiran pelanggan hanya sebagai set lengkap: nama, e-mel, nombor telefon, dan CPF/CNPJ mesti disediakan semuanya. Jika mana-mana daripada empat medan ini hilang, atau nombor telefon bukan nombor mudah alih Brazil yang sah, Mavibot tidak akan menghantar sebarang butiran pelanggan kepada PagBank. Pelanggan hanya akan mengisinya pada halaman pembayaran. Ini tidak menjejaskan pembayaran itu sendiri.

Pautan Pembayaran dalam Butang

Untuk menghantar butang dengan pautan pembayaran, pilih jenis butang pembayaran dan pilih PagBank sebagai sistem pembayaran. Masukkan nama produk dan jumlah pembayaran. Jika perlu, nyatakan pembolehubah yang mengandungi nama, alamat e-mel, dan nombor telefon pelanggan.

Panggil Balik Selepas Pembayaran

Selepas pelanggan mengikuti pautan dan menyelesaikan pembayaran, panggil balik pembayaran berjaya akan dihantar ke dialog:

A1B2C3D4E5_success 100.55

Di sini, A1B2C3D4E5 ialah 10 aksara pertama token anda, dan 100.55 ialah jumlah pembayaran.

Jika pembayaran gagal, panggil balik berikut akan dihantar:

A1B2C3D4E5_fail 100.55

Panggil balik kegagalan dihantar hanya apabila pautan pembayaran tidak boleh digunakan lagi: bank telah menolak atau membatalkan pembayaran secara kekal, atau pautan pembayaran telah tamat tempoh. Tiada panggil balik dihantar semasa pembayaran dalam semakan, menunggu pembayaran boleto, atau dibenarkan tetapi masih ditahan pada kad, kerana pautan pembayaran kekal aktif. Pautan pembayaran yang tamat tempoh tidak mempunyai pembayaran yang berkaitan, jadi panggil balik tidak akan menyertakan jumlah.

Untuk mengendalikan pembayaran yang berjaya atau gagal, ikuti langkah berikut:

  1. Cipta blok dengan pencetus (blok Trigger kelabu atau blok Start hijau — gunakan blok hijau jika anda ingin meneruskan pembinaan corong selepas pembayaran).
  2. Dalam medan Trigger, masukkan panggil balik tanpa jumlah pembayaran:
A1B2C3D4E5_success

Gunakan pilihan ini jika anda mahu blok bertindak balas terhadap setiap pembayaran yang berjaya.

Tetapkan jenis padanan kepada Keyword Match.

Sebagai alternatif, masukkan panggil balik penuh:

A1B2C3D4E5_success 100.55

Gunakan pilihan ini jika anda mahu blok bertindak balas hanya kepada pembayaran untuk jumlah tertentu.

Tetapkan jenis padanan kepada Exact Match.

Pembolehubah Pelanggan Selepas Pembayaran Berjaya

Pembolehubah Nilai
pagbank_callback_data Maklumat pembayaran yang diterima daripada sistem pembayaran
pagbank_payment_completed "True" — pembayaran telah diproses dengan jayanya
pagbank_order_id ID pesanan PagBank (ORDE_…)
pagbank_charge_id ID caj PagBank (CHAR_…)
pagbank_payment_method Kaedah pembayaran: CREDIT_CARD, DEBIT_CARD, PIX, atau BOLETO