| Table of Contents |
|---|
Ü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.
| Page properties | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Multiexcerpt include | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Diagramme zum Prozessablauf
| Multiexcerpt include | ||||||||
|---|---|---|---|---|---|---|---|---|
|
PagBrasilOTF Prozessablauf
| Multiexcerpt include | ||||||||
|---|---|---|---|---|---|---|---|---|
|
PagBrasil Boleto Bancário Prozessablauf
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
-Schnittstelle
| SpaceWithExcerpt | DE |
|---|---|
| MultiExcerptName | Platform-Kurz |
| PageWithExcerpt | Wording |
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
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 Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
-Formular auszuführen, verwenden Sie bitte folgende URL:Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Kreditkartenzahlungen mit PagBrasilUm das Layout der SSL-Seite an den Shop anzupassen, können Sie mit den folgenden unverschlüsselten Parametern Farben, Schriften und Bilder konfigurieren:
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Layout_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Layout-Parameter für
-Formulare bei Kreditkartenzahlungen mit PagBrasilMultiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_IntroURL PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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.
Bundesstaat | Abkürzung |
|---|---|
Acre | AC |
Alagoas | AL |
Amapá | AP |
Amazonas | AM |
Bahia | BA |
Ceará | CE |
Distrito Federal | DF |
Espírito Santo | ES |
Goias | GO |
Maranhão | MA |
Mato Grosso | MT |
Mato Grosso do Sul | MS |
Minas Gerais | MG |
Pará | PA |
Paraíba | PB |
Paraná | PR |
Pernambuco | PE |
Piauí | PI |
Rio de Janeiro | RJ |
Rio Grande do Norte | RN |
Rio Grande do Sul | RS |
Rondônia | RO |
Roraima | RR |
Santa Catarina | SC |
São Paulo | SP |
Sergipe | SE |
Tocantins | TO |
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Kreditkartenzahlungen mit PagBrasil über Socket-Verbindung
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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 Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
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.Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
Zudem sendet das
Chargeback-Benachrichtigungen für alle unterstützten Kartenmarken an die URLNotify, wenn der betreffende Händler im Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
entsprechend konfiguriert ist. Die Chargeback-Benachrichtigung enthält zusätzlich die ParameterMultiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
action=CHARGEBACK&chargebackamount={Wert}.
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Online-Überweisungen mit PagBrasil
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_IntroURL PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Zahlungen mit Boleto Bancário über Socket-Verbindung
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Ergebnis-Parameter der Socket-Verbindung für Boleto Bancário
Die folgende Tabelle beschreibt die Parameter, die das
an URLNotify übergibt:Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Zahlungen mit PEC Flash
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Rückgabeparameter für Zahlungen mit PEC Flash
Die folgende Tabelle beschreibt die Parameter, die das
an URLNotify übergibt:Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Aktualisierung von Zahlungen mit PEC Flash
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Buchungen von PagBrasil, PagBrasilOTF sowie Boleto Bancário
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Gutschrift von Zahlungen mit PagBrasil, PagPrasilOTF sowie Boleto Bancário
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Antwort-Parameter für Gutschrift von Zahlungen mit PagBrasil, PagPrasilOTF sowie Boleto Bancário
Batch-Nutzung der Schnittstelle
Grundsätzliche Informationen zur Arbeit mit Batch-Dateien sowie zu deren Aufbau erfahren Sie im separaten Handbuch zum Batchmanager. Im Batch-Verfahren sind nicht alle Funktionen verfügbar, die für die Online-Schnittstelle verfügbar sind.Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Batch_Intro PageWithExcerpt Reuse API
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:
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Beschreibung der möglichen Batch-Versionen
Der Aufbau für eine Zahlung mit PagBrasil in einer einzureichenden Batch-Datei sieht folgendermaßen aus:
| Multiexcerpt include | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Beispiel für Master-MID-Funktion:
| Multiexcerpt include | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Die folgende Tabelle beschreibt die einzelnen Felder und Werte, die im Datensatz (Record) innerhalb der Batch-Datei verwendet werden:Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Batch_Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Beschreibung der Felder im Datensatz von Batch-Dateien
Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:
| Multiexcerpt include | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Die folgende Tabelle beschreibt die Antwort-Parameter, die der Batch-Manager im Record-Bereich zu jeder Transaktion speichert (hier nicht erklärte Standardparameter wie etwa <TransID> oder <RefNR> und Aufrufparameter, werden unverändert zum Aufruf wieder zurückgegeben und sind vorstehend beschrieben):Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Batch_Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien