• DeutschEnglish

PagBrasil

Ü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.

Logo

COO 6505 1000 10 6092947

COO 6505 1000 5 6092948

COO 6505 1000 6 6092948

COO 6505 1000 5 6092932

COO 6505 1000 12 667149

Info

Über das Paygate lassen sich Zahlungen mit den brasilianischen Kreditkarten Hipercard, Elo und Aura verarbeiten. Computop bietet dafür umfassende Unterstützung bei der Steueroptimierung sowie der Fremdwährungskonversion.

Mehr als 30% der Online-Zahlungen erfolgen in Brasilien über die Cash-In-Lösung Boleto Bancário. Mit einem Zahlschein können Kunden in Supermärkten, Postfilialen oder an einem von über 48.000 Bankterminals bar zahlen.

Typ

Zahlungen per Kreditkarte

Card Scheme

VISA

MasterCard

AMEX

Diners

Elo

Aura

Hipercard

Diagramme zum Prozessablauf

PagBrasilOTF Prozessablauf

PagBrasil Boleto Bancário Prozessablauf

Paygate-Schnittstelle

Definitionen

Datenformate

Format

Beschreibung

a

alphabetisch

as

alphabetisch mit Sonderzeichen

n

numerisch

an

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

ns

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

3

feste Länge mit 3 Stellen/Zeichen

..3

variable Länge mit maximal 3 Stellen/Zeichen

enum

Aufzählung erlaubter Werte

dttm

ISODateTime (JJJJ-MM-TTThh:mm:ss)

Abkürzungen

Abkürzung

Beschreibung

Kommentar

CND

Bedingung (condition)

M

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

O

optional

Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich

C

bedingt (conditional)

Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist

Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.

Kreditkartenzahlung mit PagBrasil via Formular-Schnittstelle

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

https://www.computop-paygate.com/payssl.aspx

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDDescription

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Nur BRL zulässig. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

URLSuccess

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten

  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

URLFailure

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung gescheitert ist. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten

  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Response

a7

O

Die Status-Rückmeldung, die das Paygate an URLSuccess und URLFailure sendet, sollte verschlüsselt werden. Dazu übergeben Sie den Parameter Response=encrypt.

URLNotify

ans..256

M

Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

  • Bevor Folgeaktionen (Buchung / Gutschrift / Storno) auf eine bestehende Transaktion ausgeführt werden, muss zuvor das erste Notify durch den Shop beantwortet worden sein.

  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Capture

an..6

OM

Bestimmt Art und Zeitpunkt der Buchung (engl. Capture).

Buchungsart

Beschreibung

AUTO

Buchung sofort nach Autorisierung (Standardwert).

MANUAL

Buchung erfolgt durch den Händler – in der Regel erfolgt die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.

<Zahl>

Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

CreditCardHolder

ans..60

M

Name des Karteninhabers

Name

ans..128

O

Name des Kunden. Wenn der Name nicht angegeben ist, wird der CreditCardHolder übergeben.

AddrStreet

ans..46

M

Straßenname des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrCity

ans..40

M

Ortsname des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrZip

ans..8

M

Postleitzahl des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrState

a2

M

Abkürzung des Bundesstaats des Kunden. Siehe nachfolgende Tabelle Bundesstaaten Brasiliens. (Optional, wenn mit PagBrasil und Computop abgesprochen)

TaxNumber

n11/n14

M

In Brasilien gibt es zwei Arten von Steuernummern:

CPF für Personen und CNPJ für Firmen

CPF: 11 Zeichen ohne Trennzeichen, z.B. 12312312312

CNPJ: 14 Zeichen, ohne Trennzeichen, z.B. 12345678000123

eMail

ans..128

M

E-Mail-Adresse des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

Phone

ans..40

M

Telefonnummer des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

ChDesc

ans..12

M

Text, der auf der Kreditkartenabrechnung des Kunden neben dem Zahlungsempfänger („PAGBRASIL“) steht

OrderDesc

ans..768

M

Beschreibung der gekauften Waren, Einzelpreise usw.

ArticleList

ans..254

O

Beschreibung der gekauften Waren.

Beispiel: Produktname;Anzahl+Produktname;Anzahl

Das Produkt und die Anzahl werden auf der Abrechnung des Kunden angezeigt.

InstallmentNumber

n..2

O

Anzahl Monate der Ratenzahlung (1-12), Standard=1.

Plain

ans..50

O

Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID.

Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt.

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

IPAddr

ans..45

O

IP-Adresse des Gerätes des Kunden

DeviceID

ans..128

O

DeviceId des Gerätes des Kunden

Parameter für Kreditkartenzahlungen mit PagBrasil

Um das Layout der SSL-Seite an den Shop anzupassen, können Sie mit den folgenden unverschlüsselten Parametern Farben, Schriften und Bilder konfigurieren:

KeyFormatCNDDescription

Template

ans..20

O

Name der XSLT-Datei mit Ihrem individuellen Layout für das Bezahlformular. Wenn Sie das neugestaltete und abwärtskompatible Computop-Template nutzen möchten, übergeben Sie den Templatenamen „ct_compatible“. Wenn Sie das responsive Computop-Template für mobile Endgeräte nutzen möchten, übergeben Sie den Templatenamen „ct_responsive“.

Background

ans..256

O

Formular Hintergrundumgebung:

- URL für ein Hintergrundbild

- HTML-Farbwert für Hintergrundfarbe als HEX-Wert oder

- HTML-Farbname

BGColor

ans..7

O

Formular Hintergrundfarbe:

- HTML-Farbwert für Hintergrundfarbe als HEX-Wert oder

- HTML-Farbname

BGImage

ans..256

O

Formular Hintergrundbild:

URL für ein Hintergrundbild

Beachten Sie bitte, dass dieser Wert „BGColor“ überschreibt.

FColor

ans..7

O

Textfarbe:

- HTML-Farbwert als HEX-Wert oder

- HTML-Farbname

FFace

a..10

O

HTML-Name der Schriftart

FSize

n2

O

Zahl für die Schriftgröße

Language

a2

O

Sprachcode: <de> deutsch, <al> albanisch, <at> österreichisch, <cz/cs> tschechisch, <dk> dänisch, <en> englisch, <fi> finnisch, <fr> französisch, <gr> griechisch, <hu> ungarisch, <it> italienisch, <jp> japanisch, <nl> holländisch, <no> norwegisch, <pl> polnisch, <pt> portugiesisch, <ro> rumänisch, <ru> russisch, <es> spanisch, <se> schwedisch, <sk> slowakisch, <sl> slowenisch, <tr> türkisch, <zh> Simplified Chinese.

CCSelect

a..16

O

Bestimmt die vorausgewählte Kartenmarke im Formular: VISA, MasterCard, AMEX, DINERS, JCB, CBN, Hipercard, Elo, Aura, Dankort, Airplus, ComfortCard, CUP oder Maestro

URLBack

ans..256

O

Vollständige URL, die das Paygate aufruft, wenn der Kunde auf Abbruch klickt.

Der Parameter "URLBack" kann

  • sowohl unverschlüsselt ans Paygate übermittelt werden (Kompabilitätsmodus)

  • als auch in den verschlüsselten Übergabeparametern (bevorzugte Variante)

Wenn Sie Parameter/Werte in der URLBack übergeben möchten, so können Sie folgende Methode verwenden:

1
URLBack=https://your.shop.com/back.php?param1%3Dvalue1%26param2%3Dvalue3%26status%3Dcancelled

Wenn der Kunde auf Abbruch klickt, so wird die URL genauso aufgerufen, so dass Sie URL Decode verwenden können, um Parameter und Werte zu extrahieren.

Center

n1

O

Standardmäßig ist das Formular vertikal und horizontal zentriert. Der Wert <1> justiert es oben mittig.

tWidth

ans..4

O

Breite der Tabelle im Eingabeformular als Prozent- (50%) oder Pixelwerte (320)

tHeight

ans..4

O

Höhe der Tabelle für die Eingabe der Bezahldaten im Formular als Prozent- (70%) oder Pixelwerte (480)

CustomField[n]

ans..50

O

Händler können bis zu 14 spezielle Felder (genannt CustomField1 bis CustomField14) in ihrer Zahlungsformularvorlage anpassen. CustomFields sind eine Funktion, mit der Sie zusätzliche Informationen wie Ihr Logo, Bestelldetails und Kundendetails auf dem Zahlungsformular anzeigen können.

Sonderzeichen (wie &, ', <, >) sind nicht erlaubt – auch nicht "urlencoded".

Die Verwendung bzw. Darstellung der CustomField{n] ist abhängig vom verwendeten Template.

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

Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate an Ihre URLSuccess,URLFailure und URLNotify übergibt. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

OrderID

ans15

MC

Nicht an URLNotify: Entspricht der RefNr oder TransID, je nachdem ob eine RefNr übergeben wurde oder nicht.

Status

a..50

M

OK oder AUTHORIZE_REQUEST (URLSuccess) sowie FAILED (URLFailure)

OK oder FAILED an URLNotify

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

PCNr

n16

O

Pseudo Card Number: Vom Computop Paygate generierte Zufallszahl, die eine reale Kreditkartennummer repräsentiert. Die Pseudokartennummer (PKN) beginnt mit 0, und die letzten 3 Stellen entsprechen denen der realen Kartennummer. Die PKN kann wie eine Kreditkartennummer für Autorisierung, Buchung und Gutschriften verwendet werden.

PCNr ist ein Antwortwert vom Computop Paygate und kann ebenfalls als CCNr im Request oder als Teil von card-JSON verwendet werden.

CCBrand

a..22

O

In Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke wie VISA, MasterCard, AMEX, DINERS, Elo, Aura oder Hipercard

CCExpiry

n6

O

In Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM

MaskedCCNr

an..19

OC

Maskierte Kartennummer 6X4

Plain

ans..50

O

Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID.

Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt.

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

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:

https://www.computop-paygate.com/direct.aspx

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDDescription

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Nur BRL zulässig. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

URLNotify

ans..256

O

Vollständige URL, die dasPaygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData.

Die URL wird nur aufgerufen, wenn es sich um eine Zahlung mit Hipercard handelt, da in diesem Fall die Antwort vom Acquirer zeitverzögert gesendet wird. Alternativ kann der Zahlungsstatus über inquire.aspx angefragt werden.

Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten

  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Capture

an..6

OM

Bestimmt Art und Zeitpunkt der Buchung (engl. Capture).

Buchungsart

Beschreibung

AUTO

Buchung sofort nach Autorisierung (Standardwert).

MANUAL

Buchung erfolgt durch den Händler – in der Regel erfolgt die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.

<Zahl>

Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

CCNr

n..19

M

Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen. Optional können Sie auch eine Pseudokartennummer übergeben.

CCCVC

n..4

O

Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei AMEX 4 Ziffern.

CCExpiry

n6

M

Ablaufdatum der Kreditkarte (JJJJMM), z.B. 202607

CCBrand

a..22

M

Kartenmarke: VISA, MasterCard, AMEX, DINERS, Elo, Aura oder Hipercard. Bitte beachten Sie die Schreibweise!

CreditCardHolder

ans..60

M

Name des Karteninhabers

Name

ans..128

O

Name des Kunden. Wenn der Name nicht angegeben ist, wird der CreditCardHolder übergeben.

AddrStreet

ans..46

M

Straßenname des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrCity

ans..40

M

Ortsname des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrZip

ans..8

M

Postleitzahl des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrState

a2

M

Abkürzung des Bundesstaats des Kunden. Siehe nachfolgende Tabelle Bundesstaaten Brasiliens. (Optional, wenn mit PagBrasil und Computop abgesprochen)

TaxNumber

n11/n14

M

In Brasilien gibt es zwei Arten von Steuernummern:

CPF für Personen und CNPJ für Firmen

CPF: 11 Zeichen ohne Trennzeichen, z.B. 12312312312

CNPJ: 14 Zeichen, ohne Trennzeichen, z.B. 12345678000123

eMail

ans..128

M

E-Mail-Adresse des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

Phone

ans..40

M

Telefonnummer des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

ChDesc

ans..12

M

Text, der auf der Kreditkartenabrechnung des Kunden neben dem Zahlungsempfänger („PAGBRASIL“) steht

OrderDesc

ans..768

M

Beschreibung der gekauften Waren, Einzelpreise usw.

ArticleList

ans..254

O

Beschreibung der gekauften Waren.

Beispiel: Produktname;Anzahl+Produktname;Anzahl

Das Produkt und die Anzahl werden auf der Abrechnung des Kunden angezeigt.

InstallmentNumber

n..2

O

Anzahl Monate der Ratenzahlung (1-12), Standard=1.

IPAddr

ans..45

O

IP-Adresse des Gerätes des Kunden

DeviceID

ans..128

O

DeviceId des Gerätes des Kunden

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

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

OrderID

ans15

M

Entspricht der RefNr oder TransID, je nachdem ob eine RefNr übergeben wurde oder nicht.

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

PCNr

n16

O

Pseudo Card Number: Vom Computop Paygate generierte Zufallszahl, die eine reale Kreditkartennummer repräsentiert. Die Pseudokartennummer (PKN) beginnt mit 0, und die letzten 3 Stellen entsprechen denen der realen Kartennummer. Die PKN kann wie eine Kreditkartennummer für Autorisierung, Buchung und Gutschriften verwendet werden.

PCNr ist ein Antwortwert vom Computop Paygate und kann ebenfalls als CCNr im Request oder als Teil von card-JSON verwendet werden.

CCBrand

a..22

O

In Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke wie VISA, MasterCard, AMEX, DINERS, Elo, Aura oder Hipercard

CCExpiry

n6

O

In Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM

MaskedCCNr

an..19

OC

Maskierte Kartennummer 6X4

acsURL

string

C

Der Händler erhält die acsURL und muss den Kunden zu dieser URL umleiten, um die Authentifizierung abzuschließen

Ergebnis-Parameter der Socket-Verbindung für PagBrasil

Zusätzlich zur Antwort auf die Sitzung der Zahlungsanfrage sendet das Paygate abhängig von der Kartenmarke und den Konfigurationseinstellungen des Händlers eine Benachrichtigung an die im Paygate 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 Paygate Chargeback-Benachrichtigungen für alle unterstützten Kartenmarken an die URLNotify, wenn der betreffende Händler im Paygate entsprechend konfiguriert ist. Die Chargeback-Benachrichtigung enthält zusätzlich die Parameter

action=CHARGEBACK&chargebackamount={Wert}.

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

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:

https://www.computop-paygate.com/BrazilOTF.aspx

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDDescription

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Nur BRL zulässig. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

URLSuccess

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten

  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

URLFailure

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung gescheitert ist. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten

  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Response

a7

O

Die Status-Rückmeldung, die das Paygate an URLSuccess und URLFailure sendet, sollte verschlüsselt werden. Dazu übergeben Sie den Parameter Response=encrypt.

URLNotify

ans..256

M

Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

  • Bevor Folgeaktionen (Buchung / Gutschrift / Storno) auf eine bestehende Transaktion ausgeführt werden, muss zuvor das erste Notify durch den Shop beantwortet worden sein.

  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Name

ans..128

O

Name des Kunden

AddrStreet

ans..46

M

Straßenname des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen, jedoch nicht bei BankCode = U)

AddrCity

ans..40

M

Ortsname des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen, jedoch nicht bei BankCode = U)

AddrZip

ans..8

M

Postleitzahl des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen, jedoch nicht bei BankCode = U)

AddrState

a2

M

Abkürzung des Bundesstaats des Kunden. Siehe obige Tabelle Bundesstaaten Brasiliens. (Optional, wenn mit PagBrasil und Computop abgesprochen, jedoch nicht bei BankCode = U)

TaxNumber

n11/n14

M

In Brasilien gibt es zwei Arten von Steuernummern:

CPF für Personen und CNPJ für Firmen

CPF: 11 Zeichen ohne Trennzeichen, z.B. 12312312312

CNPJ: 14 Zeichen, ohne Trennzeichen, z.B. 12345678000123

eMail

ans..128

M

E-Mail-Adresse des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen, jedoch nicht bei BankCode = U)

Phone

ans..40

M

Telefonnummer des Kunden (Optional, wenn mit PagBrasil undComputop abgesprochen, jedoch nicht bei BankCode = U)

OrderDesc

ans..768

M

Beschreibung der gekauften Waren, Einzelpreise usw.

ArticleList

ans..254

O

Beschreibung der gekauften Waren.

Beispiel: Produktname;Anzahl+Produktname;Anzahl

Das Produkt und die Anzahl werden auf der Abrechnung des Kunden angezeigt.

BankCode

enum

M

Identifikation des Finanzinstituts des Kunden

R = Bradesco Comércio Eletrônico

E = Banco do Brasil Comércio Eletrônico

S = Banricompras

U = Itaú Shopline

Plain

ans..50

O

Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID.

Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt.

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

Parameter für Online-Überweisungen mit PagBrasil

Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate an Ihre URLSuccess,URLFailure und URLNotify übergibt. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

OrderID

ans15

MC

Nicht an URLNotify: Entspricht der RefNr oder TransID, je nachdem ob eine RefNr übergeben wurde oder nicht.

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

Plain

ans..50

O

Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID.

Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt.

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

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:

https://www.computop-paygate.com/BoletoBancario.aspx

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDDescription

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..30

M

Eindeutige Referenznummer. Das Format muss vorher mitComputop abgestimmt werden!

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Nur BRL zulässig. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

URLNotify

ans..256

M

Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

  • Bevor Folgeaktionen (Buchung / Gutschrift / Storno) auf eine bestehende Transaktion ausgeführt werden, muss zuvor das erste Notify durch den Shop beantwortet worden sein.

  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Name

ans..128

M

Name des Kunden

AddrStreet

ans..46

M

Straßenname des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrCity

ans..40

M

Ortsname des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrZip

ans..8

M

Postleitzahl des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrState

a2

M

Abkürzung des Bundesstaats des Kunden. Siehe nachfolgende Tabelle Bundesstaaten Brasiliens. (Optional, wenn mit PagBrasil und Computop abgesprochen)

TaxNumber

n11/n14

M

In Brasilien gibt es zwei Arten von Steuernummern:

CPF für Personen und CNPJ für Firmen

CPF: 11 Zeichen ohne Trennzeichen, z.B. 12312312312

CNPJ: 14 Zeichen, ohne Trennzeichen, z.B. 12345678000123

eMail

ans..128

M

E-Mail-Adresse des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

Phone

ans..40

M

Telefonnummer des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

OrderDesc

ans..768

M

Beschreibung der gekauften Waren, Einzelpreise usw.

ArticleList

ans..254

M

Beschreibung der gekauften Waren.

Beispiel: Produktname;Anzahl+Produktname;Anzahl

Das Produkt und die Anzahl werden auf der Abrechnung des Kunden angezeigt.

Expiration

n..4

O

Anzahl der Tage, wie lange das Zahlungsformular gültig ist

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

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

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

OrderID

ans15

MC

Nicht an URLNotify: Entspricht der RefNr oder TransID, je nachdem ob eine RefNr übergeben wurde oder nicht.

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

PaymentSlipLink

ans..256

M

Vollständige URL (URL-encoded) für die Seite, die den Zahlschein darstellt

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

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

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

PaymentSlipLink

ans..256

M

Vollständige URL (URL-encoded) für die Seite, die den Zahlschein darstellt

AmountAuth

n..10

M

Autorisierter Betrag in der kleinsten Währungseinheit (z.B. BRL Centavos)

AmountCap

n..10

M

Gebuchter Betrag in der kleinsten Währungseinheit (z.B. BRL Centavos). Dient zur Prüfung, ob der gesamte Betrag gebucht wurde.

AmountCred

n..10

M

Gutgeschriebener Betrag in der kleinsten Währungseinheit (z.B. BRL Centavos)

PaymentDate

dttm

M

Datum, wann der Kunde mit Boleto Bancário bezahlt hat. Format: JJJJ-MM-TT.

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

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

Pix-Zahlung mit PagBrasil

Um eine Pix-Zahlung mit PagBrasil über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/pix.aspx

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDDescription

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..30

M

Eindeutige Referenznummer. Das Format muss vorher mit Computop abgestimmt werden!

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Nur BRL zulässig. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

URLNotify

ans..256

M

Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

  • Bevor Folgeaktionen (Buchung / Gutschrift / Storno) auf eine bestehende Transaktion ausgeführt werden, muss zuvor das erste Notify durch den Shop beantwortet worden sein.

  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Name

ans..128

M

Name des Kunden

AddrStreet

ans..46

M

Straßenname des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrCity

ans..40

M

Ortsname des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrZip

ans..8

M

Postleitzahl des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrState

a2

M

Abkürzung des Bundesstaats des Kunden. Siehe nachfolgende Tabelle Bundesstaaten Brasiliens. (Optional, wenn mit PagBrasil und Computop abgesprochen)

TaxNumber

n11/n14

M

In Brasilien gibt es zwei Arten von Steuernummern:

CPF für Personen und CNPJ für Firmen

CPF: 11 Zeichen ohne Trennzeichen, z.B. 12312312312

CNPJ: 14 Zeichen, ohne Trennzeichen, z.B. 12345678000123

eMail

ans..128

M

E-Mail-Adresse des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

Phone

ans..40

M

Telefonnummer des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

OrderDesc

ans..768

M

Beschreibung der gekauften Waren, Einzelpreise usw.

ArticleList

ans..254

M

Beschreibung der gekauften Waren.

Beispiel: Produktname;Anzahl+Produktname;Anzahl

Das Produkt und die Anzahl werden auf der Abrechnung des Kunden angezeigt.

Expiration

n..4

O

Anzahl der Minuten, wie lange der Zahlschein gilt. Der Wert kann zwischen 1 und 7200 liegen.

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

Parameters for payments with PIX via PagBrasil via socket connection

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

OrderID

ans15

MC

Nicht an URLNotify: Entspricht der RefNr oder TransID, je nachdem ob eine RefNr übergeben wurde oder nicht.

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

QRCodeUrl

ans..80

C

Link zum Bild des Pix QR-Codes

QRCodeID

ans..254

C

Alternativer Code für mobile Benutzer, um die Zahlung abzuschließen, wenn sie den Code nicht scannen können

ExpirationDate

ans10

C

Letzter Tag zur Zahlung des PagBrasil Pix.

Format: MM/TT/JJJJ

ExpirationTime

ans5

C

Maximale Uhrzeit am Ablaufdatum, bis wann PagBrasil Pix bezahlt werden kann.

Format: HH:MM.

Results parameters for socket connection for PIX via PagBrasil

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

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

QRCodeUrl

ans..80

C

Link zum Bild des Pix QR-Codes

QRCodeID

ans..254

C

Alternativer Code für mobile Benutzer, um die Zahlung abzuschließen, wenn sie den Code nicht scannen können

ExpirationDate

ans10

C

Letzter Tag zur Zahlung des PagBrasil Pix.

Format: MM/TT/JJJJ

ExpirationTime

ans5

C

Maximale Uhrzeit am Ablaufdatum, bis wann PagBrasil Pix bezahlt werden kann.

Format: HH:MM.

AmountAuth

n..10

M

Autorisierter Betrag in der kleinsten Währungseinheit (z.B. BRL Centavos)

AmountCap

n..10

M

Gebuchter Betrag in der kleinsten Währungseinheit (z.B. BRL Centavos). Dient zur Prüfung, ob der gesamte Betrag gebucht wurde.

AmountCred

n..10

M

Gutgeschriebener Betrag in der kleinsten Währungseinheit (z.B. BRL Centavos)

PaymentDate

dttm

M

Datum, wann der Kunde mit PagBrasil Pix bezahlt hat. Format: JJJJ-MM-TT.

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

Response parameters to URLNotify for payments with PIX via PagBrasil

Barzahlung mit PagBrasil PEC Flash

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

https://www.computop-paygate.com/PECFlash.aspx

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDDescription

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Nur BRL zulässig. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

URLNotify

ans..256

M

Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

  • Bevor Folgeaktionen (Buchung / Gutschrift / Storno) auf eine bestehende Transaktion ausgeführt werden, muss zuvor das erste Notify durch den Shop beantwortet worden sein.

  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Name

ans..128

M

Name des Kunden

AddrStreet

ans..46

M

Straßenname des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrCity

ans..40

M

Ortsname des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrZip

ans..8

M

Postleitzahl des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

AddrState

a2

M

Abkürzung des Bundesstaats des Kunden. Siehe nachfolgende Tabelle Bundesstaaten Brasiliens. (Optional, wenn mit PagBrasil und Computop abgesprochen)

TaxNumber

n11/n14

M

In Brasilien gibt es zwei Arten von Steuernummern:

CPF für Personen und CNPJ für Firmen

CPF: 11 Zeichen ohne Trennzeichen, z.B. 12312312312

CNPJ: 14 Zeichen, ohne Trennzeichen, z.B. 12345678000123

eMail

ans..128

M

E-Mail-Adresse des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

Phone

ans..40

M

Telefonnummer des Kunden (Optional, wenn mit PagBrasil und Computop abgesprochen)

OrderDesc

ans..768

M

Beschreibung der gekauften Waren, Einzelpreise usw.

ArticleList

ans..254

M

Beschreibung der gekauften Waren.

Beispiel: Produktname;Anzahl+Produktname;Anzahl

Das Produkt und die Anzahl werden auf der Abrechnung des Kunden angezeigt.

Expiration

n..3

O

Anzahl der Tage (0 - 5), für die der PEC Flash® Zahlschein gültig ist. Wenn Sie diesen Parameter nicht verwenden, wird der im PagBrasil-Dashboard festgelegte Standardwert verwendet.

ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

Parameter für Zahlungen mit PEC Flash

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

OrderID

ans15

M

Entspricht der RefNr oder TransID, je nachdem ob eine RefNr übergeben wurde oder nicht.

TransactionID

ans..17

O

Der für die Zahlung erzeugte Code, den der Käufer im Lotteriegeschäft für die Barzahlung vorzeigen muss.

Er wird bei einer erfolgreichen Autorisierungsanfrage zurückgegeben.

CompanyID

ans..10

O

Firmencode zur Verwendung auf der Bestätigungsseite für den Käufer als Teil der Zahlungsinformationen für das Lotteriegeschäft

Note

ans..254

O

Zahlungsanweisungen mit einem portugiesischen Text, wo der Käufer bezahlen kann und welche Informationen er dem Händler geben muss. PagBrasil empfiehlt den Händlern, dieses Element "payment_instructions" auf ihrer Bestätigungsseite zu verwenden, anstatt den Text aus den XML-Elementen (company_code, payment_id, customer_taxid) zusammenzusetzen.

Rückgabeparameter für Zahlungen mit PEC Flash

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

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

TransactionID

ans..17

O

Der für die Zahlung erzeugte Code, den der Käufer im Lotteriegeschäft für die Barzahlung vorzeigen muss.

Er wird bei einer erfolgreichen Autorisierungsanfrage zurückgegeben.

CompanyID

ans..10

O

Firmencode zur Verwendung auf der Bestätigungsseite für den Käufer als Teil der Zahlungsinformationen für das Lotteriegeschäft

Note

ans..254

O

Zahlungsanweisungen mit einem portugiesischen Text, wo der Käufer bezahlen kann und welche Informationen er dem Händler geben muss. PagBrasil empfiehlt den Händlern, dieses Element "payment_instructions" auf ihrer Bestätigungsseite zu verwenden, anstatt den Text aus den XML-Elementen (company_code, payment_id, customer_taxid) zusammenzusetzen.

AmountAuth

n..10

M

Autorisierter Betrag in der kleinsten Währungseinheit (z.B. BRL Centavos)

AmountCap

n..10

M

Gebuchter Betrag in der kleinsten Währungseinheit (z.B. BRL Centavos). Dient zur Prüfung, ob der gesamte Betrag gebucht wurde.

AmountCred

n..10

M

Gutgeschriebener Betrag in der kleinsten Währungseinheit (z.B. BRL Centavos)

PaymentDate

dttm

M

Datum, wann der Kunde mit PEC Flash bezahlt hat. Format: JJJJ-MM-TT.

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

Response parameters to URLNotify for payments with 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:

https://www.computop-paygate.com/PagBrasilUpdate.aspx

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDDescription

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Expiration

n1

M

Anzahl der Tage, die zum aktuellen Ablaufdatum hinzugefügt werden sollen (maximal 5)

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Parameter für Aktualisierung von Zahlungen mit PEC Flash

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

OrderID

ans15

M

Entspricht der RefNr oder TransID, je nachdem ob eine RefNr übergeben wurde oder nicht.

PaymentSlipLink

ans..256

C

Vollständige URL zum PDF-Dokument, welches den Zahlschein mit dem Barcode darstellt. Nur bei Boleto Bancário.

QRCodeUrl

ans..80

C

Pix QR-Code-Bildlink. Nur bei PIX

QRCodeID

ans..254

C

Alternativer Code für mobile Benutzer, um die Zahlung abzuschließen, wenn sie den Code nicht scannen können. Nur bei PIX

ExpirationDate

ans10

C

Letzter Termin zur Zahlung von PagBrasil Pix. Nur bei PIX

Format: MM/TT/JJJJ

ExpirationTime

ans5

C

Maximale Uhrzeit am Tag des Ablaufs, bis zu der PagBrasil Pix bezahlt werden kann. Nur bei PIX

Format: HH:MM

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:

https://www.computop-paygate.com/capture.aspx

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDDescription

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

Vom Paygate vergebene ID für die zu buchende Zahlung

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Nur BRL zulässig. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

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

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

OrderID

ans15

M

Entspricht der RefNr oder TransID, je nachdem ob eine RefNr übergeben wurde oder nicht.

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:

https://www.computop-paygate.com/credit.aspx

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDDescription

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

Vom Paygate vergebene ID für die gutzuschreibende Zahlung

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Nur BRL zulässig. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

CredNo

ans..

OC

Nicht bei PagBrasilOTF/Boleto Bancário: Kreditnummer. Wird auf den Wert „0“ gesetzt, falls nicht übermittelt.

RefNr

ans..30

OC

Nur bei PagBrasilOTF und Boleto Bancário: Referenznummer (z.B. Rechnungsnummer), die für jede Retoure eindeutig sein muss

AccBankName

ans..40

O

Bankname des Kunden

AccNr

ans..12

O

Kontonummer des Kunden (muss Bindestrich enthalten, z.B. 12345-6)

AccBIC

ans..12

O

Bankleitzahl bzw. Filialnummer der Bank

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

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

KeyFormatCNDDescription

RefNr

ans..30

OC

Nur bei PagBrasilOTF und Boleto Bancário: Referenznummer des Händlers

OrderID

ans15

M

Entspricht der RefNr oder TransID, je nachdem ob eine RefNr übergeben wurde oder nicht.

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.

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:

Action

Version

Beschreibung

Credit

1.0 / 2.0

Standardversion ohne Rückgabe von Parameter Code

1.x / 2.x

mit RefNr (gilt für alle Versionen außer 1.0)

Beschreibung der möglichen Batch-Versionen

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

1
HEAD,<MerchantID>,<Date>,<Version>
2
PagBraCC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
3
PagBraCC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<AccBankName>,<AccNr>,<AccBIC>
4
PagBraBB,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<AccBankName>,<AccNr>,<AccBIC>
5
PagBraOTF,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<AccBankName>,<AccNr>,<AccBIC>
6
FOOT,<CountRecords>,<SumAmount>

Beispiel für Master-MID-Funktion:

1
HEAD,[Master]MerchantID,Date,2.x
2
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
3
FOOT,CountRecords,SumAmount

Die folgende Tabelle beschreibt die einzelnen Felder und Werte, die im Datensatz (Record) innerhalb der Batch-Datei verwendet werden:

KeyFormatCNDDescription

Type

a..11

M

HEAD für Header, FOOT für Footer, PagBraCC für PagBrasil Kreditkarte, PagBraOTF für PagBrasil Online-Überweisung, PagBraBB für Boleto Bancário

Action

a..20

M

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

Für Kreditkartenzahlungen mit PagBrasil sind Buchungen und Gutschriften möglich, für Zahlungen mit PagBrasilOTF sowie Boleto Bancário sind nur Gutschriften möglich.

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

PayID

an32

M

Vom Paygate vergebene ID für diese Transaktion

AccBankName

ans..40

M

Bankname des Kunden

AccNr

ans..12

M

Kontonummer des Kunden (muss Bindestrich enthalten, z.B. 12345-6)

AccBIC

ans..12

M

Bankleitzahl bzw. Filialnummer der Bank

Beschreibung der Felder im Datensatz von Batch-Dateien

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

1
HEAD,<MerchantID>,<Date>,<Version>
2
PagBraCC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
3
PagBraCC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<AccBankName>,<AccNr>,<AccBIC>,<Status>,<Code>
4
PagBraBB,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<AccBankName>,<AccNr>,<AccBIC>,<Status>,<Code>
5
PagBraOTF,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<AccBankName>,<AccNr>,<AccBIC>,<Status>,<Code>
6
FOOT,<CountRecords>,<SumAmount>

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):

KeyFormatCNDDescription

Action

a..20

M

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

PayID

an32

M

Vom Paygate vergebene ID für diese Transaktion

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien

Paygate

Documentation (EN)

Dokumentation (DE)

Paygate Status