Um PagBank als Zahlungsanbieter in Mavibot zu nutzen, benötigst du ein Zugriffstoken aus deinem PagBank-Konto und gibst es in den Zahlungseinstellungen ein.

Token abrufen

Produktivumgebung: Melde dich von einem Computer aus bei deinem PagBank-Konto an, gehe zu Vendas → Integrações (Verkauf → Integrationen) und klicke auf Gerar token (Token generieren).

Testumgebung (Sandbox): Melde dich im PagBank Developer Portal an, öffne den Tab Tokens und kopiere dein Sandbox-Token.

Das Token wird nur einmal angezeigt. Bewahre es an einem sicheren Ort auf: Wenn du es verlierst, musst du ein neues generieren, und das alte Token wird ungültig.

Du musst in deinem PagBank-Konto keine Zahlungsbenachrichtigungs-URL konfigurieren – Mavibot stellt diese automatisch bei der Erstellung jeder Zahlung bereit.

Einrichtung

Wähle in den Zahlungssystemeinstellungen PagBank aus und gib Folgendes ein:

  • Token – das API-Zugriffstoken aus deinem PagBank-Konto.
  • Testmodus – aktiviere diese Option, wenn du ein Sandbox-Token eingegeben hast. Im Testmodus werden Anfragen an sandbox.api.pagseguro.com gesendet, und es wird kein echtes Geld abgebucht.

Die Einrichtung ist abgeschlossen.

Rechnerfunktion:

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

Parameter

Parameter Beschreibung
amount Zahlungsbetrag. Erforderlich. Minimum: 1 BRL; Maximum: 9.999.999 BRL. Gib den Betrag als 100.55 ein, nicht als 10055.
description Zahlungsbeschreibung. Optional, maximal 255 Zeichen. Der Kunde sieht sie auf der Zahlungsseite.
product_name Produktname, maximal 100 Zeichen. Optional; standardmäßig wird description verwendet.
customer_email E-Mail-Adresse des Kunden. Optional; wird auf der Zahlungsseite vorausgefüllt.
customer_phone Telefonnummer des Kunden. Optional; wird auf der Zahlungsseite vorausgefüllt. PagBank akzeptiert nur brasilianische Mobilnummern: Ländercode 55, eine zweistellige Vorwahl und eine neunstellige Nummer, die mit 9 beginnt (z. B. +55 11 99999-8888).
full_name Vor- und Nachname des Kunden. Optional; wird auf der Zahlungsseite vorausgefüllt.
identity_number CPF (11 Ziffern) oder CNPJ (14 Ziffern) des Kunden. Optional; wird auf der Zahlungsseite vorausgefüllt.

Die Funktion gibt eine Zahlungs-URL zurück.

PagBank akzeptiert Kundendaten nur als vollständigen Satz: Name, E-Mail, Telefonnummer und CPF/CNPJ müssen alle angegeben werden. Wenn eines dieser vier Felder fehlt oder die Telefonnummer keine gültige brasilianische Mobilnummer ist, sendet Mavibot keine Kundendaten an PagBank. Der Kunde füllt sie dann einfach auf der Zahlungsseite aus. Dies hat keine Auswirkungen auf die Zahlung selbst.

Um einen Button mit einem Zahlungslink zu senden, wähle den Zahlungsbutton-Typ und PagBank als Zahlungssystem aus. Gib den Produktnamen und den Zahlungsbetrag ein. Gib bei Bedarf Variablen mit dem Namen, der E-Mail-Adresse und der Telefonnummer des Kunden an.

Callbacks nach der Zahlung

Nachdem der Kunde dem Link gefolgt ist und die Zahlung abgeschlossen hat, wird ein erfolgreicher Zahlungs-Callback an den Dialog gesendet:

A1B2C3D4E5_success 100.55

Hierbei ist A1B2C3D4E5 die ersten 10 Zeichen deines Tokens und 100.55 der Zahlungsbetrag.

Wenn die Zahlung fehlschlägt, wird der folgende Callback gesendet:

A1B2C3D4E5_fail 100.55

Ein Fehler-Callback wird nur gesendet, wenn der Zahlungslink nicht mehr verwendet werden kann: Die Bank hat die Zahlung endgültig abgelehnt oder storniert, oder der Zahlungslink ist abgelaufen. Es wird kein Callback gesendet, solange die Zahlung noch geprüft wird, auf eine Boleto-Zahlung wartet oder zwar autorisiert, aber noch auf der Karte zurückgehalten wird, da der Zahlungslink dann noch aktiv ist. Ein abgelaufener Zahlungslink hat keine zugehörige Zahlung, daher enthält der Callback keinen Betrag.

Um eine erfolgreiche oder fehlgeschlagene Zahlung zu verarbeiten, führe folgende Schritte aus:

  1. Erstelle einen Block mit einem Trigger (ein grauer Trigger-Block oder ein grüner Start-Block – verwende den grünen Block, wenn du den Trichter nach der Zahlung fortsetzen möchtest).
  2. Gib im Feld Trigger den Callback ohne den Zahlungsbetrag ein:
A1B2C3D4E5_success

Verwende diese Option, wenn der Block auf jede erfolgreiche Zahlung reagieren soll.

Setze den Übereinstimmungstyp auf Keyword Match.

Alternativ gib den vollständigen Callback ein:

A1B2C3D4E5_success 100.55

Verwende diese Option, wenn der Block nur auf eine Zahlung mit einem bestimmten Betrag reagieren soll.

Setze den Übereinstimmungstyp auf Exact Match.

Kundenvariablen nach einer erfolgreichen Zahlung

Variable Wert
pagbank_callback_data Zahlungsinformationen, die vom Zahlungssystem empfangen wurden
pagbank_payment_completed "True" – die Zahlung wurde erfolgreich verarbeitet
pagbank_order_id PagBank-Bestell-ID (ORDE_…)
pagbank_charge_id PagBank-Belastungs-ID (CHAR_…)
pagbank_payment_method Zahlungsmethode: CREDIT_CARD, DEBIT_CARD, PIX oder BOLETO