Über PagBrasil

Allgemeines zu Zahlungsmethoden via PagBrasil

Ein großer Teil der Online-Zahlungen in Brasilien wird über Kreditkarten abgewickelt. Bei 75% dieser Zahlungen nutzen brasilianische Kunden die Ratenzahlung. Der Händler bekommt dabei den vollen Betrag sofort gutgeschrieben, während die Bank an den Gebühren für die Ratenzahlung verdient. Nur etwa ein Drittel aller Kreditkarten in Brasilien ist international für E-Commerce einsetzbar. Für den Großteil lokaler Karten, auch wenn sie von Visa, MasterCard oder Amex ausgegeben wurden, sind Verträge mit lokalen Partnern nötig, um diese brasilianischen Kreditkarten annehmen und einen guten Umrechnungskurs erzielen zu können. Zu den inländischen Karten in Brasilien zählen Hipercard, Elo und Aura.

Zusätzlich ist die Cash-in-Lösung Boleto Bancário eine verbreitete Zahlungsmethode im Rahmen des E-Commerce. Der Händler stellt dem Käufer eine Art Pro-forma-Rechnung aus, die an Geldautomaten, bei Banken, Postfilialen, Einzelhändlern oder via Internet-Banking bezahlt werden kann. Auch reine Online-Überweisungen wie PagBrasilOTF gehören zu den Zahlungsarten, die Kunden vom Händler in Brasilien erwarten.

Ahnlich zu Boleto Bancário ist die neue Cash-in-Lösung PEC Flash für Kunden im E-Commerce verfügbar, die weder Bankkonto noch Kreditkarte haben, um ihre Online-Bestellungen in jedem Lotteriegeschäft zu bezahlen. PEC Flash ist sehr einfach zu nutzen und die Zahlung wird in wenigen Minuten bestätigt.

Diagramme zum Prozessablauf

PagBrasilOTF Prozessablauf

PagBrasil Boleto Bancário Prozessablauf

-Schnittstelle

Kreditkartenzahlung mit PagBrasil via Formular-Schnittstelle

Zahlungen mit PagBrasil erfolgen über die standardmäßige -Schnittstelle für Kreditkartenzahlungen. Um eine SSL-Kreditkartenzahlung mit PagBrasil über ein -Formular auszuführen, verwenden Sie bitte folgende URL:

Parameter für Kreditkartenzahlungen mit PagBrasil

Layout-Parameter für -Formulare bei Kreditkartenzahlungen mit PagBrasil

Ergebnis-Parameter für URLSuccess, URLFailure und URLNotify bei PagBrasil

Folgende Tabelle gibt die Bundesstaaten Brasiliens sowie deren offiziele brasilianische Abkürzung an, wie sie im Übergabe-Parameter AddrState verwendet werden muss.

Bundesstaaten Brasiliens

Kreditkartenzahlung per Server-zu-Server-Verbindung

Um eine SSL-Kreditkartenzahlung mit PagBrasil (Brasilien) über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

Parameter für Kreditkartenzahlungen mit PagBrasil über Socket-Verbindung

Ergebnis-Parameter der Socket-Verbindung für PagBrasil

Zusätzlich zur Antwort auf die Sitzung der Zahlungsanfrage sendet das abhängig von der Kartenmarke und den Konfigurationseinstellungen des Händlers eine Benachrichtigung an die im hinterlegte bzw. im Parameter [URLNotify] angegebene URL. Dies ist generell der Fall, wenn es sich um Zahlungen mit einer Karte der Marke Hipercard (Itau) handelt.

Zudem sendet das Chargeback-Benachrichtigungen für alle unterstützten Kartenmarken an die URLNotify, wenn der betreffende Händler im entsprechend konfiguriert ist. Die Chargeback-Benachrichtigung enthält zusätzlich die Parameter

action=CHARGEBACK&chargebackamount={Wert}.

Ergebnis-Parameter an URLNotify für PagBrasil-Zahlungen mit Hipercard

PagBrasilOTF Online-Überweisung

Um eine Zahlung mit PagBrasilOTF auszuführen, verwenden Sie bitte folgende URL:

Parameter für Online-Überweisungen mit PagBrasil

Rückgabeparameter für URLSuccess, URLFailure sowie URLNotify bei PagBrasilOTF

Barzahlung mit PagBrasil Boleto Bancário

Um eine Barzahlung mit PagBrasil Boleto Bancário (Brasilien) über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

Parameter für Zahlungen mit Boleto Bancário über Socket-Verbindung

Ergebnis-Parameter der Socket-Verbindung für Boleto Bancário

Die folgende Tabelle beschreibt die Parameter, die das an URLNotify übergibt:

Rückgabeparameter an URLNotify für Zahlungen mit Boleto Bancário

Barzahlung mit PagBrasil PEC Flash

Um eine Barzahlung mit PagBrasil PEC Flash auszuführen, verwenden Sie bitte folgende URL:

Parameter für Zahlungen mit PEC Flash

Rückgabeparameter für Zahlungen mit PEC Flash

Die folgende Tabelle beschreibt die Parameter, die das an URLNotify übergibt:

Rückgabeparameter an URLNotify für Zahlungen mit PEC Flash

Aktualisieren einer Zahlung mit PEC Flash

Um einen Zahlschein für PEC Flash über eine Server-zu-Server-Verbindung zu verlängern, verwenden Sie bitte folgende URL:

Parameter für Aktualisierung von Zahlungen mit PEC Flash

Ergebnis-Parameter für die Aktualisierung von Zahlungen mit PEC Flash

Buchung einer Kreditkartenzahlung mit PagBrasil

Buchungen sind über eine Server-zu-Server-Kommunikation möglich. Um eine Buchung (Capture) für eine PagBrasil-Kreditkartenzahlung über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

Parameter für Buchungen von PagBrasil, PagBrasilOTF sowie Boleto Bancário

Ergebnis-Parameter für Buchungen von PagBrasil, PagBrasilOTF sowie Boleto Bancário

Gutschrift mit Referenz

Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Bei einer Gutschrift mit Bezug auf eine Buchung ist die Höhe der Gutschrift auf die Höhe der vorangegangen Buchung beschränkt.

Gutschriften sind bei Kreditkarten bis zu 90 Tagen auf die bei der Zahlung angegebene Kreditkarte und bei Debitkarten nur am selben Tag möglich. Später ist eine Gutschrift nur mit den optionalen Parametern AccNr, AccBankName und AccBIC möglich. Diese müssen vom Kunden erfragt werden, da bei der Zahlung keine Daten für eine Gutschrift vorhanden sind. Bei Gutschriften für Zahlungen mit PagBrasilOTF sowie Boleto Bancário liegen ebenfalls keine Daten für eine Gutschrift vor. Auch hier müssen die Angaben vom Kunden erfragt und in den Parametern AccNr, AccBankName und AccBIC übergeben werden.

Um eine Gutschrift (Credit) mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:

Parameter für Gutschrift von Zahlungen mit PagBrasil, PagPrasilOTF sowie Boleto Bancário

Antwort-Parameter für Gutschrift von Zahlungen mit PagBrasil, PagPrasilOTF sowie Boleto Bancário

Batch-Nutzung der Schnittstelle

Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung von Zahlungen / Gutschriften mit PagBrasil, PagBrasilOTF sowie Boleto Bancário übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.

Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:

Beschreibung der möglichen Batch-Versionen

Der Aufbau für eine Zahlung mit PagBrasil in einer einzureichenden Batch-Datei sieht folgendermaßen aus:

Beispiel für Master-MID-Funktion:

Beschreibung der Felder im Datensatz von Batch-Dateien

Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien