PayPal V2 | Computop Documents

Über Paypal

Logo

COO 6505 1000 8 5948405

Info

Computop wickelt PayPal-Zahlungen ab, die Ihnen weltweiten Verkäuferschutz sowie ein Potenzial von 425 Millionen internationalen Kunden in über 200 Märkten bieten.

PayPal gehört zu den beliebtesten Online-Zahlungsmitteln und kann im E- und M-Commerce eingesetzt werden.

Typ

Zahlungen per eWallet

Allgemeines zu PayPal

PayPal steht seit mehr als 20 Jahren an der Spitze der digitalen Zahlungsrevolution. Durch den Einsatz von Technologie, um Finanzdienstleistungen und Handel bequemer, erschwinglicher und sicherer zu machen, ermöglicht die PayPal-Plattform mehr als 425 Millionen Kunden und Händlern in mehr als 200 Märkten, sich der globalen Wirtschaft anzuschließen und erfolgreich zu sein.

Kunden in Deutschland können per Lastschrift, giropay oder Kreditkarte (American Express, Diners Club, Discover, MasterCard, Visa) bezahlen. Mitglieder loggen sich während des Bestellvorgangs mit ihrer E-Mail-Adresse und einem Passwort in ihr PayPal-Konto ein und wählen die bevorzugte Zahlungsquelle – Lastschrift, Kreditkarte, PayPal-Guthaben (Pay Later) und ggf. Kauf auf Rechnung oder Ratenzahlung.

Für weitere Informationen besuchen Sie https://www.paypal.com/

PayPal Shortcut (früher "Express Checkout Shortcut (ECS)")

Computop Paygate bietet zur Verkürzung des Bestellvorgangs den PayPal Shortcut an: Ihr Kunde muss keine Adressdaten eingeben, sondern klickt im Warenkorbbereich auf Mit PayPal bezahlen, meldet sich an und wählt die bei PayPal hinterlegte Rechnungs- und Lieferadresse aus. Das Paygate sendet dann die Lieferadresse als Ergebnisparameter an Ihren Shop zurück.

Käufer und Verkäufer sind geschützt

PayPal bietet Käufern und Händlern einen umfassenden Käufer-/Verkäuferschutz bei Verwendung von „Bezahlen mit PayPal“ als Zahlungsmethode (ausgenommen alternative Zahlungsmethoden). Käufer können bei Nichterfüllung eines Kaufvertrags Geld von PayPal zurückfordern. Mit Adressverifizierung und PayPal-Verkäuferschutz nimmt PayPal dem Händler das Risiko von Zahlungsausfällen bei Lastschriftzahlungen, deutschen Kreditkartenzahlungen und unberechtigten Kundenreklamationen ab. Der Verkäuferschutz ist immer an die Regeln und Bedingungen von PayPal gekoppelt. Das PayPal-Risikomanagement mit Käuferschutz und Adressverifizierung wird Ihnen über das Computop Paygate zur Verfügung gestellt.

Weltweit online bezahlen

PayPal ist besonders vorteilhaft für die Kundenakquise im Ausland. Das Computop Paygate unterstützt alle von PayPal angebotenen Währungen und Märkte. In vielen Ländern bietet PayPal den Kunden landestypische Zahlungsmethoden an. Kunden im Ausland können häufig typische Zahlungsmethoden wie Prepaid-Karten in Italien oder Debitkarten in Großbritannien verwenden. Durch die Integration von PayPal in Ihren Shop haben Sie die Möglichkeit, Ihren Kunden gleich mehrere Zahlungsarten anzubieten. Natürlich steht es Ihnen auch frei, nur "Bezahlen mit PayPal" anzubieten.

Vorteile von Orders V2 ("PayPal Checkout")

Orders V2 hat folgende Vorteile gegenüber PayPal NVP und SOAP.

Orders V2 ist die Grundlage für alle zukünftigen Entwicklungen von Produkten und wird von PayPal empfohlen. PayPal wird keine neuen Funktionen mehr entwickeln/bestehende Funktionen auf der Grundlage von PayPal NVP und SOAP erweitern.
Orders V2 hält sich an die neuesten Compliance-Standards.
Orders V2 bietet einen reibungsloseren Checkout-Prozess mit einer Lightbox (unter Verwendung von JS SDK, sogenannter „PayPal Mini Browser“), einem Fenster-Overlay, das oben auf der Online-Shop-Seite des Händlers erscheint. Dadurch bleibt der Kunde auf der Seite des Händlers und den Fokus nicht verlieren.

Weitere Informationen finden Sie auf der Webseite von PayPal (https://www.paypal.com).

Wichtige Hinweise

Bitte beachten Sie, dass entgegen der Darstellung in unserer Währungstabelle die Währungen HUF (Ungarn ‒ Forint), JPY (Japanische Yen) und TWD (Republik China ‒ Taiwan-Dollar) ohne Nachkommastellen einzureichen sind.

Beispiel: Um 100,00 HUF einzureichen, übergeben Sie Amount=100.

Diese Ausnahme gilt ausschließlich für die Zahlungsart PayPal. Weitere Details finden Sie unter https://developer.paypal.com/reference/currency-codes/.

Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den Computop Helpdesk, um diese Funktion für Sie zu aktivieren.

Diagramm zum Prozessablauf

Konfiguration für PayPal

PayPal Sandbox Geschäftskonto

Wenn Sie die Integration testen möchten bevor Sie live gehen und noch über kein PayPal Sandbox-Testkonto verfügen, bitten wir Sie im ersten Schritt ein PayPal Sandbox-Testkonto zu erstellen.

Melden Sie sich bei https://developer.paypal.com/ an und gehen Sie zu „Testing Tools“ => „Sandbox Accounts“

COO 6505 1000 14 315149

Klicken Sie auf „Konto erstellen“ und wählen Sie „Geschäftlich (Händlerkonto)“ und „Deutschland“ als „Land / Region“ aus.

COO 6505 1000 11 315149

COO 6505 1000 13 315149

Wählen Sie „Konto anzeigen/bearbeiten“

COO 6505 1000 12 315149

Nehmen Sie „E-Mail-ID“ und „vom System generiertes Passwort“ und verwenden Sie diese im nächsten Schritt als Login/Pass für Sandbox.

COO 6505 1000 15 315148

Dem Computop Paygate API-Berechtigungen erteilen

Damit Computop Transaktionen in Ihrem Namen verarbeiten darf, bitten wir Sie, Computop die entsprechenden Berechtigungen zu erteilen.

Berechtigungen können Computop unter Ihrem PayPal-Konto erteilt werden. Bitte verwenden Sie die folgenden Links, um sich bei Ihrem PayPal-Konto anzumelden, und folgen Sie den Schritten.

PayerID an Computop Merchant Services senden

Um die Händlereinrichtung auf Computop-Seite abzuschließen, bitten wir Sie, die PayerID an Computop Merchant Services zu senden.

PayPal Sandbox

1. Melden Sie sich bei https://developer.paypal.com/dashboard an und go to "Testing tools" --> "Sandbox Accounts".

COO 6505 1000 11 315689

Wählen Sie das entsprechende Sandbox Händlerkonto aus und informieren Merchant Services über die "Account ID".

COO 6505 1000 15 315687

PayPal Live-Umgebung

Die PayerID finden Sie unter Ihrem PayPal-Konto unter https://paypal.com/myaccount/settings/ wie angegeben. Durch die PayerID wird der Händler eindeutig bei PayPal identifiziert.

COO 6505 1000 12 315807

Paypal Smart Button

Es gibt zwei Möglichkeiten zur Integration von PayPal V2 über Computop. Die erste Möglichkeit ist die Nutzung des Computop JavaScript-Moduls. Eine andere besteht darin, eine PayPal-Schaltfläche durch Kopieren und Einfügen des unten dargestellten JavaScript-Codes einzurichten.

Computop JavaScript-Modul

Das Computop PayPal JavaScript-Modul bietet clientseitige Technologie zur Ergänzung der Integration von PayPal V2 über Computop.

Das Modul und die Installationsanweisungen finden Sie unter Readme.

Einrichtung der PayPal-Schaltfläche

Auf der Client-Seite erfolgt die PayPal-Implementierung über das PayPal JavaScript SDK.

Je nach Ihrer Einrichtung können Sie das folgende Skript verwenden oder mit Hilfe der offiziellen PayPal JavaScript SDK-Dokumentation https://developer.paypal.com/sdk/js/ ein eigenes erstellen.

COO 6505 1000 13 315932

Während Sie in der Sandbox testen, können Sie die client-id verwenden, die zu Ihrer Test-App vom PayPal-Webentwicklerportal passt. Wenn Sie live gehen, ersetzen Sie diese mit der live client-id.

Conditional Content (CT)

1
<!DOCTYPE html>
2
<html lang="en">
3
<head>
4
<meta charset="utf-8"/>
5
</head>
6
 
7
<body>
8
    <!-- Set up a container element for the button -->
9
    <div id="paypal-button-container"></div>
10
 
11
	<!-- Include the PayPal JavaScript SDK -->
12
    <!-- Replace <PayerID> with your value, available under your PayPal account --> 
13
    <!-- Replace <Currency> with the currency which should be used, e.g., EUR -->
14
    <!-- When going live, replace client-id with the live client-id provided by Computop -->
15
    <!-- When going live, replace data-partner-attribution-id with the live data-partner-attribution-id provided by Computop --> 
16
    <script type="text/javascript" src="https://www.paypal.com/sdk/js?client-id=ARCsDK7xBFxa5pnGxk8qvB0STB07fyi_yHDRrb5al6gxahj73Pxg9X2l7onP9J2IN-LqcVJojys94FLK&merchant-id=<PayerID>&currency=<Currency>&disable-funding=giropay,sofort,sepa,card&intent=capture" data-partner-attribution-id="Computop_PSP_PCP_Test"></script>
17
    <!-- Initialize and show PayPal button -->
18
    <script type="text/javascript">
19
    let mid = "YOUR MERCHANTID";
20
    let len = "LEN OF UNENCRYPTED BLOWFISH STRING";
21
    let data = "BLOWFISH ENCRYPTED STRING";
22
	let payid;
23
     
24
        if (len != '' && data != '') {
25
            // Set the request parameter MerchantID, Len and Data
26
            const params = new URLSearchParams({
27
                MerchantID: mid,
28
                Len: len,
29
                Data: data
30
            });
31
 
32
            // Render the PayPal button into #paypal-button-container
33
            paypal.Buttons({
34
                // Call your server to set up the transaction
35
                createOrder: function(data, actions) {
36
                    return fetch('https://www.computop-paygate.com/ExternalServices/paypalorders.aspx', {
37
                        method: 'POST',
38
                        body: params
39
                    }).then(function (res) {
40
                        return res.text();
41
                    }).then(function(orderData) {
42
						let qData = new URLSearchParams(orderData)
43
                        payid = qData.get('PayID');
44
                        return qData.get('orderid');
45
                    });
46
                },
47
                // Call cbPayPal.aspx for continue sequence
48
                onApprove: function (data, actions) {
49
                    var rd = "MerchantId=" + mid + "&PayId=" + payid + "&OrderId=" + data.orderID;
50
					// Build an invisible form and directly submit it
51
					const form = document.createElement('form');
52
					form.method = 'POST';
53
					form.action = 'https://www.computop-paygate.com/cbPayPal.aspx?rd=' + window.btoa(rd);
54
					form.style.display = 'none';
55
					// Add form to body
56
					document.body.appendChild(form);
57
					// Submit form
58
					form.submit();
59
                },
60
                onCancel: function (data, actions) {                     
61
                    var rd = "MerchantId=" + mid + "&PayId=" + payid + "&OrderId=" + data.orderID;
62
                    // Build an invisible form and directly submit it                     
63
                    const form = document.createElement('form');
64
                    form.method = 'POST';
65
                    form.action = "https://www.computop-paygate.com/cbPayPal.aspx?rd=" + window.btoa(rd) + "&ua=cancel&token=" + data.orderID;
66
                    form.style.display = 'none';
67
                    // Add form to body
68
                    document.body.appendChild(form);                     
69
                    // Submit form                     
70
                    form.submit();
71
                 }
72
             }).render('#paypal-button-container');
73
        }
74
    </script>
75
     
76
</body>
77
</html>

Conditional Content (BNP)

1
<!DOCTYPE html>
2
<html lang="en">
3
<head>
4
<meta charset="utf-8"/>
5
</head>
6
 
7
<body>
8
    <!-- Set up a container element for the button -->
9
    <div id="paypal-button-container"></div>
10
 
11
    <!-- Include the PayPal JavaScript SDK -->
12
    <!-- While you are testing in sandbox, you can use client-id that matches your test app from PayPal web developer portal. When going live, replace this with the live client-id provided by Paypal --> 
13
    <script type="text/javascript" src="https://www.paypal.com/sdk/js?client-id=myClientID&currency=EUR&disable-funding=giropay,sofort,sepa,card&intent=capture"></script>
14
     
15
    <!-- Initialize and show PayPal button -->
16
    <script type="text/javascript">
17
    let mid = "YOUR MERCHANTID";
18
    let len = "LEN OF UNENCRYPTED BLOWFISH STRING";
19
    let data = "BLOWFISH ENCRYPTED STRING";
20
 	let payid;
21
     
22
        if (len != '' && data != '') {
23
            // Set the request parameter MerchantID, Len and Data
24
            const params = new URLSearchParams({
25
                MerchantID: mid,
26
                Len: len,
27
                Data: data
28
            });
29
 
30
            // Render the PayPal button into #paypal-button-container
31
            paypal.Buttons({
32
                // Call your server to set up the transaction
33
                createOrder: function(data, actions) {
34
                    return fetch('https://paymentpage.axepta.bnpparibas/ExternalServices/paypalorders.aspx', {
35
                        method: 'POST',
36
                        body: params
37
                    }).then(function (res) {
38
                        return res.text();
39
                    }).then(function(orderData) {
40
                        var json = stringToObj(orderData);
41
						 	payid = json.PayID;
42
                        return json.orderid;
43
                    });
44
                },
45
                // Call cbPayPal.aspx for continue sequence
46
                onApprove: function (data, actions) {
47
                    var rd = "MerchantId=" + mid + "&PayId=" + payid + "&OrderId=" + data.orderID;
48
                    window.location = "https://epayment.axepta.bnpparibas/cbPayPal.aspx?rd=" + window.btoa(rd);
49
                    }
50
                        }).render('#paypal-button-container');
51
                    }
52
 
53
            function stringToObj (string) {
54
                var newobj = {};
55
                string.split('&').forEach(function (value) {
56
                var keypair = value.split('=');
57
                newobj[keypair[0]] = keypair[1];
58
            });
59
 
60
            return newobj;
61
        }
62
         
63
    </script>
64
     
65
</body>
66
</html>

Conditional Content (VR)

1
<!DOCTYPE html>
2
<html lang="en">
3
<head>
4
<meta charset="utf-8"/>
5
</head>
6
 
7
<body>
8
    <!-- Set up a container element for the button -->
9
    <div id="paypal-button-container"></div>
10

11
    <!-- Include the PayPal JavaScript SDK -->
12
    <!-- Replace <PayerID> with your value, available under your PayPal account --> 
13
    <!-- Replace <Currency> with the currency which should be used, e.g., EUR -->
14
    <!-- When going live, replace client-id with the live client-id provided by Computop -->
15
    <!-- When going live, replace data-partner-attribution-id with the live data-partner-attribution-id provided by Computop --> 
16
    <script type="text/javascript" src="https://www.paypal.com/sdk/js?client-id=Aavp9mlxVFQydGXJHBVZ0LEL1c1VtBcaPahoHzwu2VienquZGZjDzCXOKH_jDGlzkieWazhrixEEcd4X&merchant-id=<PayerID>&currency=<Currency>&disable-funding=giropay,sofort,sepa,card&intent=capture" data-partner-attribution-id="VRPayment_PSP_Computop_Test"></script> 
17
    <!-- Initialize and show PayPal button -->
18
    <script type="text/javascript">
19
    let mid = "YOUR MERCHANTID";
20
    let len = "LEN OF UNENCRYPTED BLOWFISH STRING";
21
    let data = "BLOWFISH ENCRYPTED STRING";
22
 	let payid;
23
     
24
        if (len != '' && data != '') {
25
            // Set the request parameter MerchantID, Len and Data
26
            const params = new URLSearchParams({
27
                MerchantID: mid,
28
                Len: len,
29
                Data: data
30
            });
31
 
32
            // Render the PayPal button into #paypal-button-container
33
            paypal.Buttons({
34
                // Call your server to set up the transaction
35
                createOrder: function(data, actions) {
36
                    return fetch('https://vr-epayment-gateway.de/ExternalServices/paypalorders.aspx', {
37
                        method: 'POST',
38
                        body: params
39
                    }).then(function (res) {
40
                        return res.text();
41
                    }).then(function(orderData) {
42
                        var json = stringToObj(orderData);
43
						 	payid = json.PayID;
44
                        return json.orderid;
45
                    });
46
                },
47
                // Call cbPayPal.aspx for continue sequence
48
                onApprove: function (data, actions) {
49
                    var rd = "MerchantId=" + mid + "&PayId=" + payid + "&OrderId=" + data.orderID;
50
                    window.location = "https://vr-payments.gateway/cbPayPal.aspx?rd=" + window.btoa(rd);
51
                    }
52
                        }).render('#paypal-button-container');
53
                    }
54
 
55
            function stringToObj (string) {
56
                var newobj = {};
57
                string.split('&').forEach(function (value) {
58
                var keypair = value.split('=');
59
                newobj[keypair[0]] = keypair[1];
60
            });
61
 
62
            return newobj;
63
        }
64
         
65
    </script>
66
     
67
</body>
68
</html>

Aktivierung der PayPal-Schaltfläche Später Bezahlen

Der obige Codeabschnitt enthält die folgende Zeile. In dieser Zeile können Sie festlegen, welche Finanzierungsquellen im Webshop zugelassen werden.

Die Zeile entsprach der folgenden Schaltfläche. Standardmäßig (unter Verwendung der obigen Zeile) ist nur die PayPal-Schaltfläche verfügbar.

COO 6505 1000 14 580868

Wenn zusätzlich der zur standardmäßigen PayPal-Schaltfläche die Schaltfläche PayPal Später Bezahlen benötigt wird, kann die Schaltfläche durch den Parameter enable-funding wie folgt aktiviert werden.

Im Ergebnis erscheinen folgende zwei Schaltflächen.

COO 6505 1000 15 580933

Die komplette List der Werte für disable-funding und enable-funding finden Sie unter nachstehendem Link.

https://developer.paypal.com/docs/regional/th/checkout/reference/customize-sdk/#components

Parameter intent

Der obige Codeabschnitt enthält die folgende Zeile.

Das Paygate bietet 3 mögliche Optionen für eine Zahlung.

SALE (capture=Auto) (wenn das Paygate automatisch die Buchung für eine Zahlung sendet; das ist das Standardszenario, das den Anforderungen der meisten Händler entspricht)
AUTHORIZE (capture=Manual + txtype=Auth) (wenn die Buchung später vom Händler als separater API-Aufruf gesendet werden soll)
ORDER (capture=Manual + txtype=Order) (wenn Autorisierung und Buchung später vom Händler als separate API-Aufrufe gesendet werden sollen)

Der Parameter intent in der obigen Zeile muss mit diesen Optionen synchron sein.

Wenn die Option SALE verwendet wird, muss der Parameter intent wie nachstehend auf "capture" gesetzt werden.

Wenn die Option AUTHORIZE oder ORDER verwendet wird, muss der Parameter intent wie nachstehend auf "authorize" gesetzt werden.

Es ist wichtig, den richtigen Wert für den Parameter intent festzulegen, weil sonst ein Fehler auftritt.

Stil der PayPal-Schaltfläche

Der obige Codeabschnitt für die PayPal-Schaltfläche hat keine stilbezogenen Parameter. Dieser Codeabschnitt geht wie folgt vom standardmäßigen PayPal-Stil für die Schaltfläche aus.

COO 6505 1000 14 580868

PayPal erlaubt es, verschiedene Stile für die PayPal-Schaltfläche zu definieren, indem Sie die Parameter shape, color, layout und label verwenden. Eine vollständige Liste der stilbezogenen Parameter finden Sie unter dem folgenden Link.

https://developer.paypal.com/docs/checkout/advanced/style-guide/

Paygate-Schnittstelle

Definitionen

Datenformate

Format

Beschreibung

alphabetisch

alphabetisch mit Sonderzeichen

numerisch

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

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)

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

optional

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

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.

Aufruf der Schnittstelle

Um eine PayPal-Zahlung im Paygate-Formular abzuwickeln, nutzen Sie folgende URL und Parameter:

https://www.computop-paygate.com/ExternalServices/paypalorders.aspx

Mit dieser URL unterstützt das Paygate zwei verschiedene PayPal-Methoden: Einerseits können Sie PayPal ganz normal als zusätzliche Zahlungsmethode zum Abschluss einer Bestellung anbieten. Zum anderen können Sie PayPal Express Checkout nutzen, damit der Kunde vom Warenkorb direkt zu PayPal gelangt und dort seine Liefer- und Rechnungsadresse auswählt. Dem Kunden erspart das die erneute Eingabe von Adressdaten und als Händler genießen Sie den PayPal Verkäuferschutz.

Das Paygate unterstützt auch für PayPal Express Checkout das Auseinanderfallen von Autorisierung und Buchung. Sie können über das Paygate über Parameter steuern, ob der Betrag auf dem PayPal-Account des Kunden geblockt oder gleich gebucht werden soll.

Hinweis: Damit Sie vom PayPal Verkäuferschutz profitieren, muss eine der folgenden Bedingungen erfüllt sein. Entweder der Kunde nutzt PayPal Express Checkout und wählt eine bei PayPal selbst hinterlegte Lieferadresse aus, die das Paygate an Ihren Shop übergibt. Oder Ihr Shop übergibt die bereits bekannte Lieferadresse an PayPal. Der Verkäuferschutz gilt nur, wenn die Ware an diese angegebene Adresse geliefert wurde. Zwischen der Autorisierung des Betrags im PayPal-Konto des Kunden und der Buchung dürfen nicht mehr als 3 Tage liegen, wenn Sie vom Verkäuferschutz profitieren möchten. Das Paygate unterstützt deshalb mehrere Alternativen zur Abwicklung von PayPal-Zahlungen: für eine Beratung zur Implementierung von PayPal stehen wir Ihnen gerne zur Verfügung.

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:

Key REST Format CND Description

Key	REST	Format	CND	Description
MerchantID	BasicAuth.Username	ans..30	M	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransID	"transactionId": "..."	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
refnr	"referenceNumber": "..."	ans..30	O	Eindeutige Referenznummer des Händlers
Amount	"amount": { "value": ...}	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. Falls OrderDesc(n) verwendet wird, muss gelten: Amount=ItemTotal+TaxTotal+SHAmount
Currency	"amount": { "currency": "..."}	a3	M	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
MAC	–––	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
Capture	"capture": {"auto": "Yes"} "capture": {"manual": "Yes"}	a..6	O	Auto oder Manual: bestimmt, ob der angeforderte Betrag sofort oder später abgerechnet wird. Wichtiger Hinweis:Bitte wenden Sie sich an den Computop Helpdesk für Manual, um verschiedene Möglichkeiten der Nutzung zu besprechen. Wichtiger Hinweis: Bei einer Multi-Seller-Zahlung (Marktplatzfunktionalität) ist nur Auto möglich.
TxType	"payment": {"card": { "transactionType": "Order" }} "payment": {"card": { "transactionType": "Auth" }} "payment": {"card": { "transactionType": "BAID" }}	ans..5	C	Pflicht bei Capture=Manual: Transaktionstyp mit den möglichen Werten Order oder Auth. Für die erste Billing Agreement transaction TxType=BAID. Im Fall TxType=BAID sind alle Parameter außer den folgenden optional. RefNr MUSS für jede Transaktion zur Erstellung einer Billing Agreement eindeutig sein. MerchantID TransID RefNr Amount Currency OrderDesc TxType URLSuccess URLFailure URLNotify MAC
PayPalMethod	"payment": {"payPal": { "method": "..." }}	enum	O	Wert "shortcut" wählt den geänderten Transaktionsablauf, bei dem der Kunde für die Zahlungsbestätigung in den Shop zurückgeleitet wird. Zum Abschließen der Bestellung muss anschließend die Schnittstelle paypalcomplete.aspx aufgerufen werden.
RTF	–––	ans1	O	Für zukünftige Verwendung reserviert
OrderDesc	"order": {"description": "..."}	ans..127	M	Beschreibung der gekauften Waren, Einzelpreise usw.
OrderDesc(n)	"order": {"items": "..."}	ans..127	O	Warenkorb des Kunden im Format: OrderDesc(n)=Name,Amount,Number,Quantity,Description,Tax OrderDesc2 bis max. OrderDesc99 zulässig. Weitere Informationen finden Sie bei PayPal unter https://developer.paypal.com/docs/api/orders/v2/#orders_create!ct=application/json&path=purchase_units/items&t=request. Zur korrekten Ausführung der Anzeigefunktion müssen alle OrderDesc(n) Amounts gleich dem Paygate-Parameter Amount sein. Beispiel zur Übergabe aller Varianten: Amount=1600 OrderDesc2=book,500,1111,1,Article,100& OrderDesc3=book,600,2222,1,Article,100& ItemTotal=1100& TaxTotal=200& ShAmount=300& Beispiel zusätzlich mit Rabatt / Discount: Amount=400 Orderdesc2=book,500,1234,1,nice book,100& Orderdesc3=Discount,-200,5678,1,nice book,0& taxtotal=100& itemtotal=300&
TaxTotal	"amount": {"taxTotal": ...}	n..10	C	Pflicht, wenn +Tax in der Beschreibung von OrderDesc(n) angegeben ist: Gesamtbetrag der Steuern aller Einzelartikel in der kleinsten Währungseinheit (z.B. EUR Cent) = Sum(Tax*Number)
ItemTotal	"amount": {"itemTotal": ...}	n..10	C	Pflicht, wenn +Tax in der Beschreibung von OrderDesc(n) angegeben ist: Bruttobetrag aller Einzelartikel in der kleinsten Währungseinheit (z.B. EUR Cent) = Sum(Amount*Number)
ShAmount	"amount": {"shippingTotal": ...	n..10	C	Lieferkosten in der kleinsten Währungseinheit (z.B. EUR Cent). Kann nur verwendet werden, wenn ShAmount <> 0 und in Verbindung mit den Parametern ItemTotal und TaxTotal.
URLSuccess	"urls": {"success": "..."}	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	"urls": {"failure": "..."}	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	"urls": {"notify": "..."}	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	"metadata[userData]": "..."	ans..1024	O	Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.
ReqId	"requestId": "..."	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.
Account	"payment": {"payPal": { "accountId": "..." }}	ans..128	O	Für die Verwaltung mehrerer PayPal-Konten, Händlerkonto: ID oder E-Mail-Adresse, für die die Anfrage an PayPal gesendet werden soll
Language	"language": "..."	an2	O	Sprache: AU, DE, FR, IT, GB, ES, US; Standardwert DE Wenn Sie die Sprache für den Kunden auf der PayPal-Anmeldeseite steuern möchten, beachten Sie bitte den Ablauf der Prüfungen bei PayPal und wie Sie die Sprache entsprechend beeinflussen können. Das User-Cookie ist bei PayPal primär. Wenn dieses gesetzt ist, überschreibt es alles (ist die Browsersprache auf Deutsch, dann hat diese immer Vorrang). Der Parameter localcode – Parameter Language am Paygate – mit einem 5-stelligen ISO-Code (fr_FR). Bitte beachten Sie die PayPal-Dokumentation: https://developer.paypal.com/reference/locale-codes/. Der Parameter ShipToCountry aus der Lieferadresse (sofern eine Lieferadresse übergeben wird) Der Parameter Localcode – Parameter Language am Paygate – mit einem 2-stelligen Ländercode (FR) Der Ländercode des PayPal-Kontos. Bitte beachten Sie, dass dies erfolgt, wenn sich der Kunde an seinem PayPal-Konto angemeldet hat.Zu diesem Zeitpunkt kann die Sprache nicht mehr aktiv gesteuert werden.
FirstName	"billing": {"consumer": { "firstName": "..." }}	ans..50	OC	(Pflicht für USA und Kanada): Entweder nur der Vorname oder Vor- und Nachname, wenn ein Firmenname als Lieferadresse verwendet wird.
LastName	"billing": {"consumer": { "lastName": "..." }}	ans..50	OC	(Pflicht für USA und Kanada): Nachname oder Firmenname der Lieferadresse
AddrStreet	"billing": {"addressInfo": { "addressLine1": { "street": "..." }}}	ans..100	OC	(Pflicht für USA und Kanada): Straßenname in der Lieferadresse
AddrStreet2	"billing": {"addressInfo": { "addressLine2": "..." }}	ans..100	O	Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vomComputop Helpdeskaktiviert werden.
AddrCity	"billing": {"addressInfo": { "city": "..." }}	ans..40	OC	(Pflicht für USA und Kanada): Ort in der Lieferadresse
AddrState	"billing": {"addressInfo": { "state": "..." }}	ans..40	C	(Pflicht für USA und Kanada): Bundesstaat der Lieferadresse. Der in AddrCity hinterlegte Ort muss im angegebenen Bundesland liegen, ansonsten lehnt PayPal diese Zahlung ab. Mögliche Werte entnehmen Sie bitte der PayPal-API-Referenzdokumentation.
AddrZip	"billing": {"addressInfo": { "postalCode": "..." }}	ans..20	OC	(Pflicht für USA und Kanada): Postleitzahl in der Lieferadresse
AddrCountryCode	"billing": {"addressInfo": { "country": { "A2": "..." }}}	an2	O	Ländercode in der Lieferadresse
Phone	"billing": {"contactInfo": { "phone": "..." }}	n..20	O	Telefonnummer
NoShipping		n1	O	Die Übergabe von NoShipping=1 verhindert, dass die bei Paypal hinterlegte Lieferadresse angezeigt wird. Zusätzlich bietet das Computop Paygate die Variante an, dass wir an Ihrer MID die Unterdrückung der Adresse fest für Sie hinterlegen. Bitte beachten Sie, dass die Lieferadresse nur im Fall digitaler Güter unterdrückt werden sollte, da daran auch der Verkäuferschutz geknüpft ist. Bitte wenden Sie sich dafür an den Computop Helpdesk.
RiskEvaluation		ans..2048	O	Array von Key-Value-Paaren (Base64-codiert).Die Liste der Schlüssel muss vor der Verwendung des Parameters RiskEvaluation mit PayPal vereinbart werden (kann bei verschiedenen Händlern unterschiedlich sein). Beispiel: `1 { 2 "additional_data": [ 3 { 4 "key": "sender_first_name", 5 "value": "John" 6 }, 7 { 8 "key": "sender_last_name", 9 "value": "Doe" 10 } 11 ] 12 }`
PaymentUnit(n)		ans..2048	O	Bei einer Multi-Seller-Zahlung (Marktplatzfunktionalität) bezieht sich jede PaymentUnit(n) auf einen separaten Verkäufer (Händler innerhalb des Marktplatzes) und enthält ein JSON-Objekt (Base64-codiert) mit dem folgenden Format. Beispiel: 1 { 2 merchantemailaddress: "merchant@example.com", 3 merchantid: "XVRKM94GQDXB2", 4 amount: "11000", 5 itemtotal: "8000", 6 taxtotal: "2000", 7 shippingamount: "1000", 8 invoiceid: "xxxxx", 9 orderdescription: "yyyyy", 10 orderitems: [ 11 { 12 name: "zzzzz", 13 quantity: "1", 14 unitamount: "3000", 15 tax: "1000", 16 description: "xxxx", 17 category: "PHYSICAL_GOODS" 18 }, 19 { 20 name: "xxxxx", 21 quantity: "2", 22 unitamount: "2500", 23 tax: "500", 24 description: "yyyyy", 25 category: "DIGITAL_GOODS" 26 } 27 ] 28 } Dabei ist MerchantID die PayPal PayerID des Händlers. InvoiceID muss pro MerchantID eindeutig sein.Der Händler darf dieselbe InvoiceID nicht zweimal verwenden. Gültige Werte für die Category sind DIGITAL_GOODS, PHYSICAL_GOODS und DONATION. Für eine PayPal-Transaktion ist die Verwendung von 1) DIGITAL_GOODS und/oder PHYSICAL_GOODS; 2) DONATION. DONATION kann nicht mit DIGITAL_GOODS oder PHYSICAL_GOODS kombiniert werden. ItemTotal ist die Zusammenfassung von *UnitAmount Quantity aller Bestellartikel, die sich auf diesen Händler beziehen. TaxTotal ist die Zusammenfassung von Tax aller Bestellartikel dieses Händlers. Amount ist die Zusammenfassung von ItemTotal, TaxTotal und ShippingAmount** dieses Händlers.
mode		an8	O	Wenn mode="redirect" gesendet wird, bedeutet dies, dass der Händler den PayPal Smart Button nicht verwendet und Paygate den Kunden zu PayPal weiterleiten sollte. Wenn mode nicht gesendet wird (oder mit einem anderen Wert außer „redirect“ gesendet wird), bedeutet dies, dass der Händler den PayPal Smart Button verwendet und Paygate den Kunden nicht zu PayPal weiterleitet (die Umleitung wird über den PayPal Smart Button abgewickelt). Allgemeine Hinweise: Wir empfehlen, die Verwendung des PayPal Smart Button für zusätzlichen Betrugsschutz und ein verbessertes Benutzererlebnis

MerchantID

BasicAuth.Username

ans..30

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

TransID

"transactionId": "..."

ans..64

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

refnr

"referenceNumber": "..."

ans..30

Eindeutige Referenznummer des Händlers

Amount

"amount": { "value": ...}

n..10

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.

Falls OrderDesc(n) verwendet wird, muss gelten: Amount=ItemTotal+TaxTotal+SHAmount

Currency

"amount": { "currency": "..."}

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.

MAC

–––

an64

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

Capture

"capture": {"auto": "Yes"}

"capture": {"manual": "Yes"}

a..6

Auto oder Manual: bestimmt, ob der angeforderte Betrag sofort oder später abgerechnet wird.

Wichtiger Hinweis:Bitte wenden Sie sich an den Computop Helpdesk für Manual, um verschiedene Möglichkeiten der Nutzung zu besprechen.

Wichtiger Hinweis: Bei einer Multi-Seller-Zahlung (Marktplatzfunktionalität) ist nur Auto möglich.

TxType

"payment": {"card": { "transactionType": "Order" }}

"payment": {"card": { "transactionType": "Auth" }}

"payment": {"card": { "transactionType": "BAID" }}

ans..5

Pflicht bei Capture=Manual: Transaktionstyp mit den möglichen Werten Order oder Auth.

Für die erste Billing Agreement transaction TxType=BAID. Im Fall TxType=BAID sind alle Parameter außer den folgenden optional. RefNr MUSS für jede Transaktion zur Erstellung einer Billing Agreement eindeutig sein.

MerchantID
TransID
RefNr
Amount
Currency
OrderDesc
TxType
URLSuccess
URLFailure
URLNotify
MAC

PayPalMethod

"payment": {"payPal": { "method": "..." }}

enum

Wert "shortcut" wählt den geänderten Transaktionsablauf, bei dem der Kunde für die Zahlungsbestätigung in den Shop zurückgeleitet wird.

Zum Abschließen der Bestellung muss anschließend die Schnittstelle paypalcomplete.aspx aufgerufen werden.

RTF

–––

ans1

Für zukünftige Verwendung reserviert

OrderDesc

"order": {"description": "..."}

ans..127

Beschreibung der gekauften Waren, Einzelpreise usw.

OrderDesc(n)

"order": {"items": "..."}

ans..127

Warenkorb des Kunden im Format:

OrderDesc(n)=Name,Amount,Number,Quantity,Description,Tax

OrderDesc2 bis max. OrderDesc99 zulässig. Weitere Informationen finden Sie bei PayPal unter https://developer.paypal.com/docs/api/orders/v2/#orders_create!ct=application/json&path=purchase_units/items&t=request.

Zur korrekten Ausführung der Anzeigefunktion müssen alle OrderDesc(n) Amounts gleich dem Paygate-Parameter Amount sein.

Beispiel zur Übergabe aller Varianten:

Amount=1600

OrderDesc2=book,500,1111,1,Article,100&

OrderDesc3=book,600,2222,1,Article,100&

ItemTotal=1100&

TaxTotal=200&

ShAmount=300&

Beispiel zusätzlich mit Rabatt / Discount:

Amount=400

Orderdesc2=book,500,1234,1,nice book,100&

Orderdesc3=Discount,-200,5678,1,nice book,0&

taxtotal=100&

itemtotal=300&

TaxTotal

"amount": {"taxTotal": ...}

n..10

Pflicht, wenn +Tax in der Beschreibung von OrderDesc(n) angegeben ist: Gesamtbetrag der Steuern aller Einzelartikel in der kleinsten Währungseinheit (z.B. EUR Cent) = Sum(Tax*Number)

ItemTotal

"amount": {"itemTotal": ...}

n..10

Pflicht, wenn +Tax in der Beschreibung von OrderDesc(n) angegeben ist: Bruttobetrag aller Einzelartikel in der kleinsten Währungseinheit (z.B. EUR Cent) = Sum(Amount*Number)

ShAmount

"amount": {"shippingTotal": ...

n..10

Lieferkosten in der kleinsten Währungseinheit (z.B. EUR Cent). Kann nur verwendet werden, wenn ShAmount <> 0 und in Verbindung mit den Parametern ItemTotal und TaxTotal.

URLSuccess

"urls": {"success": "..."}

ans..256

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

"urls": {"failure": "..."}

ans..256

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

–––

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

URLNotify

"urls": {"notify": "..."}

ans..256

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

"metadata[userData]": "..."

ans..1024

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

ReqId

"requestId": "..."

ans..32

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.

Account

"payment": {"payPal": { "accountId": "..." }}

ans..128

Für die Verwaltung mehrerer PayPal-Konten, Händlerkonto: ID oder E-Mail-Adresse, für die die Anfrage an PayPal gesendet werden soll

Language

"language": "..."

an2

Sprache: AU, DE, FR, IT, GB, ES, US; Standardwert DE

Wenn Sie die Sprache für den Kunden auf der PayPal-Anmeldeseite steuern möchten, beachten Sie bitte den Ablauf der Prüfungen bei PayPal und wie Sie die Sprache entsprechend beeinflussen können.

Das User-Cookie ist bei PayPal primär. Wenn dieses gesetzt ist, überschreibt es alles (ist die Browsersprache auf Deutsch, dann hat diese immer Vorrang).
Der Parameter localcode – Parameter Language am Paygate – mit einem 5-stelligen ISO-Code (fr_FR). Bitte beachten Sie die PayPal-Dokumentation: https://developer.paypal.com/reference/locale-codes/.
Der Parameter ShipToCountry aus der Lieferadresse (sofern eine Lieferadresse übergeben wird)
Der Parameter Localcode – Parameter Language am Paygate – mit einem 2-stelligen Ländercode (FR)
Der Ländercode des PayPal-Kontos. Bitte beachten Sie, dass dies erfolgt, wenn sich der Kunde an seinem PayPal-Konto angemeldet hat.Zu diesem Zeitpunkt kann die Sprache nicht mehr aktiv gesteuert werden.

FirstName

"billing": {"consumer": { "firstName": "..." }}

ans..50

(Pflicht für USA und Kanada): Entweder nur der Vorname oder Vor- und Nachname, wenn ein Firmenname als Lieferadresse verwendet wird.

LastName

"billing": {"consumer": { "lastName": "..." }}

ans..50

(Pflicht für USA und Kanada): Nachname oder Firmenname der Lieferadresse

AddrStreet

"billing": {"addressInfo": { "addressLine1": { "street": "..." }}}

ans..100

(Pflicht für USA und Kanada): Straßenname in der Lieferadresse

AddrStreet2

"billing": {"addressInfo": { "addressLine2": "..." }}

ans..100

Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vomComputop Helpdeskaktiviert werden.

AddrCity

"billing": {"addressInfo": { "city": "..." }}

ans..40

(Pflicht für USA und Kanada): Ort in der Lieferadresse

AddrState

"billing": {"addressInfo": { "state": "..." }}

ans..40

(Pflicht für USA und Kanada): Bundesstaat der Lieferadresse. Der in AddrCity hinterlegte Ort muss im angegebenen Bundesland liegen, ansonsten lehnt PayPal diese Zahlung ab. Mögliche Werte entnehmen Sie bitte der PayPal-API-Referenzdokumentation.

AddrZip

"billing": {"addressInfo": { "postalCode": "..." }}

ans..20

(Pflicht für USA und Kanada): Postleitzahl in der Lieferadresse

AddrCountryCode

"billing": {"addressInfo": { "country": { "A2": "..." }}}

an2

Ländercode in der Lieferadresse

Phone

"billing": {"contactInfo": { "phone": "..." }}

n..20

Telefonnummer

NoShipping

Die Übergabe von NoShipping=1 verhindert, dass die bei Paypal hinterlegte Lieferadresse angezeigt wird.

Zusätzlich bietet das Computop Paygate die Variante an, dass wir an Ihrer MID die Unterdrückung der Adresse fest für Sie hinterlegen. Bitte beachten Sie, dass die Lieferadresse nur im Fall digitaler Güter unterdrückt werden sollte, da daran auch der Verkäuferschutz geknüpft ist. Bitte wenden Sie sich dafür an den Computop Helpdesk.

RiskEvaluation

ans..2048

Array von Key-Value-Paaren (Base64-codiert).Die Liste der Schlüssel muss vor der Verwendung des Parameters RiskEvaluation mit PayPal vereinbart werden (kann bei verschiedenen Händlern unterschiedlich sein).

Beispiel:

1
{
2
 "additional_data": [
3
    {
4
      "key": "sender_first_name",
5
      "value": "John"
6
    },
7
    {
8
      "key": "sender_last_name",
9
      "value": "Doe"
10
    }
11
]
12
}

PaymentUnit(n)

ans..2048

Bei einer Multi-Seller-Zahlung (Marktplatzfunktionalität) bezieht sich jede PaymentUnit(n) auf einen separaten Verkäufer (Händler innerhalb des Marktplatzes) und enthält ein JSON-Objekt (Base64-codiert) mit dem folgenden Format.

Beispiel:

1
{
2
        merchantemailaddress: "merchant@example.com",
3
        merchantid: "XVRKM94GQDXB2",
4
        amount: "11000",
5
        itemtotal: "8000",
6
        taxtotal: "2000",
7
        shippingamount: "1000",
8
        invoiceid: "xxxxx",
9
        orderdescription: "yyyyy",
10
        orderitems: [
11
        {
12
            name: "zzzzz",
13
            quantity: "1",
14
            unitamount: "3000",
15
            tax: "1000",
16
            description: "xxxx",
17
            category: "PHYSICAL_GOODS"
18
        },
19
        {
20
            name: "xxxxx",
21
            quantity: "2",
22
            unitamount: "2500",
23
            tax: "500",
24
            description: "yyyyy",
25
            category: "DIGITAL_GOODS"
26
        }
27
    ]
28
}

Dabei ist MerchantID die PayPal PayerID des Händlers.
InvoiceID muss pro MerchantID eindeutig sein.Der Händler darf dieselbe InvoiceID nicht zweimal verwenden.
Gültige Werte für die Category sind DIGITAL_GOODS, PHYSICAL_GOODS und DONATION. Für eine PayPal-Transaktion ist die Verwendung von 1) DIGITAL_GOODS und/oder PHYSICAL_GOODS; 2) DONATION. DONATION kann nicht mit DIGITAL_GOODS oder PHYSICAL_GOODS kombiniert werden.
ItemTotal ist die Zusammenfassung von UnitAmount * Quantity aller Bestellartikel, die sich auf diesen Händler beziehen.
TaxTotal ist die Zusammenfassung von Tax aller Bestellartikel dieses Händlers.
Amount ist die Zusammenfassung von ItemTotal, TaxTotal und ShippingAmount dieses Händlers.

mode

an8

Wenn mode="redirect" gesendet wird, bedeutet dies, dass der Händler den PayPal Smart Button nicht verwendet und Paygate den Kunden zu PayPal weiterleiten sollte.

Wenn mode nicht gesendet wird (oder mit einem anderen Wert außer „redirect“ gesendet wird), bedeutet dies, dass der Händler den PayPal Smart Button verwendet und Paygate den Kunden nicht zu PayPal weiterleitet (die Umleitung wird über den PayPal Smart Button abgewickelt).

Allgemeine Hinweise:

Wir empfehlen, die Verwendung des PayPal Smart Button für zusätzlichen Betrugsschutz und ein verbessertes Benutzererlebnis

Parameter für PayPal-Zahlungen

Bei Verwendung der REST-API

Bei Verwendung der REST-API erhalten Sie immer einen Link, über den der Händler den Verbraucher umleiten muss, um die Zahlung abzuschließen.

REST

Format

CND

Beschreibung

"paymentId": "..."

an32

Kann "00000000000000000000000000000000" lauten, wenn dies noch nicht vom Paygate festgelegt wurde

"_Links.self.type": "..."

an..20

"application/json"

"_Links.redirect.href": "..."

an..1024

Der Händler muss den Kunden zu dieser URL weiterleiten, um die Zahlung abzuschließen

"_Links.redirect.type": "..."

an..20

"text/html"

Der Händler kann inquire.aspx verwenden

Bei Verwendung der Key-Value-Pair-API

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

Key Format CND Description

Key	Format	CND	Description
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, AUTHORIZE_REQUEST oder Timeout (nur bei Capture=Manual) auf der URLSuccess-Seite oder FAILED auf der URLFailure-Seite. AUTHORIZE_REQUEST – wird nur bei Anfrageparameter „TxType=auth“ oder „PayPalMethod=shortcut“ aktiv zurückgegeben. Bei Verwendung von TxType=auth oder ohne TxType wird direkt der finale Status zurückgegeben. Timeout – alle offenen Zahlungen mit Status AUTHORIZE_REQUEST werden etwa 3 Stunden später automatisch geschlossen und als Timeout gemeldet
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: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
refnr	ans..30	O	Eindeutige Referenznummer des Händlers
UserData	ans..1024	O	Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.
CodeExt	n..10	O	Fehlercode von PayPal, wenn mitComputop Helpdesk abgesprochen
Name	ans..50	M	Vorname und Nachname zusammen
FirstName	ans..50	M	Vorname des Zahlers (PayerInfo, kann vom Kontonamen abweichen)
LastName	ans..50	M	Nachname des Zahlers (PayerInfo, kann vom Kontonamen abweichen)
E-Mail	ans..100	M	E-Mail-Adresse des Käufers
AddrStreet	ans..100	O	Straßenname in der Lieferadresse
AddrStreet2	ans..100	O	Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vom Computop Helpdesk aktiviert werden.
AddrCity	ans..40	O	Ort in der Lieferadresse
AddrState	ans..40	O	Bundesstaat in der Lieferadresse
AddrZip	ans..20	O	Postleitzahl in der Lieferadresse
AddrCountryCode	an2	O	Ländercode in der Lieferadresse
Phone	n..20	O	Telefonnummer
BillingAgreementID	ans..19	O	Billing Agreement, die für nachfolgende Transaktionen basierend auf dieser Billing Agreement verwendet werden kann.
BillingName	ans..32	O	Vorname und Nachname zusammen
BillingAddrStreet	ans..100	O	Straßenname der bei PayPal hinterlegten Rechnungsadresse
BillingAddrStreet2	ans..100	O	Straßenname der bei PayPal hinterlegten Rechnungsadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vom Computop Helpdesk aktiviert werden. Für die Rückgabe von Billing-Daten wenden Sie sich bitte direkt an Ihre Ansprechpartner bei PayPal, welche die Rückgabe sowohl für den Live- als auch den Sandbox-Account aktivieren müssen.
BillingAddrCity	ans..40	O	Ortsname der bei PayPal hinterlegten Rechnungsadresse. Für die Rückgabe von Billing-Daten wenden Sie sich bitte direkt an Ihre Ansprechpartner bei PayPal, welche die Rückgabe sowohl für den Live- als auch den Sandbox-Account aktivieren müssen.
BillingAddrState	ans..40	O	Bundesstaat der bei PayPal hinterlegten Rechnungsadresse. Für die Rückgabe von Billing-Daten wenden Sie sich bitte direkt an Ihre Ansprechpartner bei PayPal, welche die Rückgabe sowohl für den Live- als auch den Sandbox-Account aktivieren müssen.
BillingAddrZIP	ans..20	O	Postleitzahl der bei PayPal hinterlegten Rechnungsadresse. Für die Rückgabe von Billing-Daten wenden Sie sich bitte direkt an Ihre Ansprechpartner bei PayPal, welche die Rückgabe sowohl für den Live- als auch den Sandbox-Account aktivieren müssen.
BillingAddrCountryCode	an2	O	Ländercode in der Rechnungsadresse. Für die Rückgabe von Billing-Daten wenden Sie sich bitte direkt an Ihre Ansprechpartner bei PayPal, welche die Rückgabe sowohl für den Live- als auch den Sandbox-Account aktivieren müssen.
payerStatus	an..10	O	Status des Käufers mit den möglichen Werten "verified" oder "unverified"
InfoText	ans..255	M	Nachricht an den Händler
PayerID	ans..13	O	(falls Antwort aktiviert ist): Eindeutige Identifikationsnummer des Kundenkontos bei PayPal
GrossAmount	an..9	O	Abgerechneter Endbetrag, einschließlich Versandkosten und Steuern aus Ihrem Händlerprofil
FeeAmount	an..9	O	Für die Transaktion berechneter Betrag der PayPal-Gebühr
SettleAmount	an..9	O	Auf Ihrem PayPal-Konto nach einer Währungsumrechnung eingezahlter Betrag
TaxAmount	an..9	O	Auf die Transaktion erhobene Steuer
ExchangeRate	an..17	O	Wechselkurs, falls eine Währungsumrechnung stattgefunden hat. Nur relevant, wenn Sie in ihrer Nicht-Hauptwährung abrechnen. Wenn der Käufer mit einer anderen Währung als der Nicht-Primärwährung bezahlt, erfolgt die Umrechnung im Konto des Käufers.
mc_fee	an..9	C	Nur bei einem separaten Notify von PayPal: Transaktionsgebühr im Zusammenhang mit der Zahlung. mc_gross minus mc_fee entspricht dem Betrag, der auf das Konto receiver_email eingezahlt wurde. Entspricht Payment_fee für USD-Zahlungen. Wenn dieser Betrag negativ ist, bedeutet dies eine Rückerstattung oder Stornierung, und jeder dieser Zahlungsstatus kann für den vollen oder einen Teilbetrag der ursprünglichen Transaktionsgebühr gelten.
mc_gross	an..9	C	Nur bei einem separaten Notify von PayPal: Gesamtbetrag der Zahlung des Kunden vor Abzug der Transaktionsgebühr. Äquivalent zu payment_gross für USD-Zahlungen. Wenn dieser Betrag negativ ist, bedeutet dies eine Rückerstattung oder Stornierung, und jeder dieser Zahlungsstatus kann für den gesamten oder einen Teilbetrag der ursprünglichen Transaktion gelten.
OrderStatus(n)	ans..255	O	Bei einer Multi-Seller-Zahlung (Funktionalität Marketplace) enthält jeder OrderStatus(n) den Status und die Capture-ID (bei einer Gutschrift zu verwenden) für die entsprechenden in der Anfrage gesendeten OrderDesc(n).JSON-Objekt (Base64-codiert) mit dem folgenden Format. Beispiele: `1 {"status":"COMPLETED", "id":"3C679366HH908993F1", "invoiceid":"PU1_20230812"}` `1 {"status":"FAILED", "id":"na", "invoiceid":""}` Der Status wurde analysiert, da ein Kunde nicht genug Geld für alle Händler haben könnte.In diesem Fall genehmigt PayPal nur einige OrderDesc(n) (nur für einige Händler).
TID	ans..17	O	Bei SALE enthält der Parameter eine eindeutige, von PayPal generierte Capture-ID. Bei AUTH enthält der Parameter eine eindeutige, von PayPal generierte Autorisierungs-ID.
TransactionID	ans..17	O	The parameter contains unique PayPal-generated Order ID

mid

ans..30

HändlerID, die von Computop vergeben wird

PayID

an32

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

XID

an32

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

TransID

ans..64

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

Status

a..50

OK, AUTHORIZE_REQUEST oder Timeout (nur bei Capture=Manual) auf der URLSuccess-Seite oder FAILED auf der URLFailure-Seite.

AUTHORIZE_REQUEST – wird nur bei Anfrageparameter „TxType=auth“ oder „PayPalMethod=shortcut“ aktiv zurückgegeben. Bei Verwendung von TxType=auth oder ohne TxType wird direkt der finale Status zurückgegeben.

Timeout – alle offenen Zahlungen mit Status AUTHORIZE_REQUEST werden etwa 3 Stunden später automatisch geschlossen und als Timeout gemeldet

Description

ans..1024

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

Code

an8

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

MAC

an64

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

refnr

ans..30

Eindeutige Referenznummer des Händlers

UserData

ans..1024

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

CodeExt

n..10

Fehlercode von PayPal, wenn mitComputop Helpdesk abgesprochen

Name

ans..50

Vorname und Nachname zusammen

FirstName

ans..50

Vorname des Zahlers (PayerInfo, kann vom Kontonamen abweichen)

LastName

ans..50

Nachname des Zahlers (PayerInfo, kann vom Kontonamen abweichen)

E-Mail

ans..100

E-Mail-Adresse des Käufers

AddrStreet

ans..100

Straßenname in der Lieferadresse

AddrStreet2

ans..100

Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vom Computop Helpdesk aktiviert werden.

AddrCity

ans..40

Ort in der Lieferadresse

AddrState

ans..40

Bundesstaat in der Lieferadresse

AddrZip

ans..20

Postleitzahl in der Lieferadresse

AddrCountryCode

an2

Ländercode in der Lieferadresse

Phone

n..20

Telefonnummer

BillingAgreementID

ans..19

Billing Agreement, die für nachfolgende Transaktionen basierend auf dieser Billing Agreement verwendet werden kann.

BillingName

ans..32

Vorname und Nachname zusammen

BillingAddrStreet

ans..100

Straßenname der bei PayPal hinterlegten Rechnungsadresse

BillingAddrStreet2

ans..100

Straßenname der bei PayPal hinterlegten Rechnungsadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vom Computop Helpdesk aktiviert werden.

Für die Rückgabe von Billing-Daten wenden Sie sich bitte direkt an Ihre Ansprechpartner bei PayPal, welche die Rückgabe sowohl für den Live- als auch den Sandbox-Account aktivieren müssen.

BillingAddrCity

ans..40

Ortsname der bei PayPal hinterlegten Rechnungsadresse.

Für die Rückgabe von Billing-Daten wenden Sie sich bitte direkt an Ihre Ansprechpartner bei PayPal, welche die Rückgabe sowohl für den Live- als auch den Sandbox-Account aktivieren müssen.

BillingAddrState

ans..40

Bundesstaat der bei PayPal hinterlegten Rechnungsadresse.

Für die Rückgabe von Billing-Daten wenden Sie sich bitte direkt an Ihre Ansprechpartner bei PayPal, welche die Rückgabe sowohl für den Live- als auch den Sandbox-Account aktivieren müssen.

BillingAddrZIP

ans..20

Postleitzahl der bei PayPal hinterlegten Rechnungsadresse.

Für die Rückgabe von Billing-Daten wenden Sie sich bitte direkt an Ihre Ansprechpartner bei PayPal, welche die Rückgabe sowohl für den Live- als auch den Sandbox-Account aktivieren müssen.

BillingAddrCountryCode

an2

Ländercode in der Rechnungsadresse.

Für die Rückgabe von Billing-Daten wenden Sie sich bitte direkt an Ihre Ansprechpartner bei PayPal, welche die Rückgabe sowohl für den Live- als auch den Sandbox-Account aktivieren müssen.

payerStatus

an..10

Status des Käufers mit den möglichen Werten "verified" oder "unverified"

InfoText

ans..255

Nachricht an den Händler

PayerID

ans..13

(falls Antwort aktiviert ist): Eindeutige Identifikationsnummer des Kundenkontos bei PayPal

GrossAmount

an..9

Abgerechneter Endbetrag, einschließlich Versandkosten und Steuern aus Ihrem Händlerprofil

FeeAmount

an..9

Für die Transaktion berechneter Betrag der PayPal-Gebühr

SettleAmount

an..9

Auf Ihrem PayPal-Konto nach einer Währungsumrechnung eingezahlter Betrag

TaxAmount

an..9

Auf die Transaktion erhobene Steuer

ExchangeRate

an..17

Wechselkurs, falls eine Währungsumrechnung stattgefunden hat. Nur relevant, wenn Sie in ihrer Nicht-Hauptwährung abrechnen. Wenn der Käufer mit einer anderen Währung als der Nicht-Primärwährung bezahlt, erfolgt die Umrechnung im Konto des Käufers.

mc_fee

an..9

Nur bei einem separaten Notify von PayPal: Transaktionsgebühr im Zusammenhang mit der Zahlung. mc_gross minus mc_fee entspricht dem Betrag, der auf das Konto receiver_email eingezahlt wurde. Entspricht Payment_fee für USD-Zahlungen. Wenn dieser Betrag negativ ist, bedeutet dies eine Rückerstattung oder Stornierung, und jeder dieser Zahlungsstatus kann für den vollen oder einen Teilbetrag der ursprünglichen Transaktionsgebühr gelten.

mc_gross

an..9

Nur bei einem separaten Notify von PayPal: Gesamtbetrag der Zahlung des Kunden vor Abzug der Transaktionsgebühr. Äquivalent zu payment_gross für USD-Zahlungen. Wenn dieser Betrag negativ ist, bedeutet dies eine Rückerstattung oder Stornierung, und jeder dieser Zahlungsstatus kann für den gesamten oder einen Teilbetrag der ursprünglichen Transaktion gelten.

OrderStatus(n)

ans..255

Bei einer Multi-Seller-Zahlung (Funktionalität Marketplace) enthält jeder OrderStatus(n) den Status und die Capture-ID (bei einer Gutschrift zu verwenden) für die entsprechenden in der Anfrage gesendeten OrderDesc(n).JSON-Objekt (Base64-codiert) mit dem folgenden Format.

Beispiele:

1
{"status":"COMPLETED", "id":"3C679366HH908993F1", "invoiceid":"PU1_20230812"}

1
{"status":"FAILED", "id":"na", "invoiceid":""}

Der Status wurde analysiert, da ein Kunde nicht genug Geld für alle Händler haben könnte.In diesem Fall genehmigt PayPal nur einige OrderDesc(n) (nur für einige Händler).

TID

ans..17

Bei SALE enthält der Parameter eine eindeutige, von PayPal generierte Capture-ID.

Bei AUTH enthält der Parameter eine eindeutige, von PayPal generierte Autorisierungs-ID.

TransactionID

ans..17

The parameter contains unique PayPal-generated Order ID

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

Hinweis: Die Adress-Parameter werden immer an den Shop übergeben, sind aber leer, wenn keine Adressdaten ausgetauscht wurden.

Aufruf der Schnittstelle für Methode "shortcut"

Die PayPal-Methode "shortcut" ermöglicht einen geänderten Transaktionsablauf, bei dem der Kunde für die Zahlungsbestätigung in den Shop zurückgeleitet wird. Um im nächsten Schritt diese PayPal-Zahlung abzuschließen, nutzen Sie folgende URL und Parameter:

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

Bitte beachten Sie nachfolgende Prozessbeschreibung, welche durch das Senden "PayPalMethod=shortcut" ausgelöst wird.

Durch das Senden "PayPalMethod=shortcut" wird der Endkunde zu PayPal geleitet, dort führt dieser eine Vorabbestätigung aus (hier handelt es sich noch nicht um die abschließende Zahlungsbestätigung) und der Kunde wird zurück in den Shop geleitet.

Der Redirect / Rücksprung wird hier auf die URLFailure mit den nachfolgenden Response Parametern ausgeführt. Bitte beachten Sie, dass es hier eine Änderung zur älteren PayPal Classic API gibt. Für diese wird der Redirect / Rücksprung auf die URLSuccess prozessiert und via Response wird der offene Status wie folgt gemeldet "Status=AUTHORIZE_REQUEST&Code=00000000&Description=REQUEST".

Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie als Händler den Redirect auf die URLSuccess prozessieren möchten und Code und Description "Status=AUTHORIZE_REQUEST&Code=00000000&Description=REQUEST" lauten sollen.

PayPal V2 Response Parameter - offener Status:

Status=AUTHORIZE_REQUEST
Code=21500985
Description=PENDING

Des weiteren ist auch zu beachten, dass der Händler nach dem Rücksprung des Kunden zum offenen Status den Betrag für den paypalComplete Request verändern kann. Hier existieren allerdings PayPal-eigene Restriktionen, damit der Betrag nicht X-beliebig nach oben hin verändert werden kann. Genauere Details zu dem Thema besprechen Sie bitte mit Ihrem PayPal Account Manager.

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:

Key	Format	CND	Description
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
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. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
refnr	ans..30	O	Eindeutige Referenznummer des Händlers
PayID	an32	M	Vom Paygate vergebene ID für die Zahlung. Übergeben Sie hier die PayID aus der Antwort von paypal.aspx, die Sie im bisherigen Transaktionsablauf erhalten haben.
			Adressinformationen. Durch Übergabe dieser Werte ist auch eine Adress-Änderung möglich. Hinweis: Wenn FirstName übergeben wird, sollten auch alle anderen Werte übergeben werden. Wenn FirstName nicht übergeben wird, werden andere Adressparameter nicht berücksichtigt.
FirstName	ans..50	C	Pflicht, um Adressangaben zu übermitteln: Entweder nur der Vorname oder Vor- und Nachname, falls ein Firmenname als Lieferadresse genutzt wird.
LastName	ans..50	C	Pflicht, wenn FirstName übergeben wird: Nachname oder Firmenbezeichnung der Lieferadresse
AddrStreet	ans..100	C	Pflicht, wenn FirstName übergeben wird: Straßenname der Lieferadresse
AddrStreet2	ans..100	C	Pflicht, wenn FirstName übergeben wird: 2. Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vom Computop Helpdesk aktiviert werden.
AddrCity	ans..40	C	Pflicht, wenn FirstName übergeben wird: Ortsname der Lieferadresse
AddrState	ans..40	C	Pflicht, wenn FirstName übergeben wird: Bundesland (Bundesstaat) der Lieferadresse. Die in AddrCity übergebene Stadt muss im angegebenen Bundesstaat liegen, sonst lehnt PayPal die Zahlung ab. Mögliche Werte entnehmen Sie bitte der PayPal-API-Reference Dokumentation.
AddrZip	ans..20	C	Pflicht, wenn FirstName übergeben wird: Postleitzahl der Lieferadresse
AddrCountryCode	an2	C	Pflicht, wenn FirstName übergeben wird: Ländercode des Lieferlandes
Phone	n..20	C	Pflicht, wenn FirstName übergeben wird: Telefonnummer

Key

Format

CND

Description

MerchantID

ans..30

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

TransID

ans..64

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

Amount

n..10

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

refnr

ans..30

Eindeutige Referenznummer des Händlers

PayID

an32

Vom Paygate vergebene ID für die Zahlung.

Übergeben Sie hier die PayID aus der Antwort von paypal.aspx, die Sie im bisherigen Transaktionsablauf erhalten haben.

Adressinformationen. Durch Übergabe dieser Werte ist auch eine Adress-Änderung möglich.

Hinweis: Wenn FirstName übergeben wird, sollten auch alle anderen Werte übergeben werden. Wenn FirstName nicht übergeben wird, werden andere Adressparameter nicht berücksichtigt.

FirstName

ans..50

Pflicht, um Adressangaben zu übermitteln: Entweder nur der Vorname oder Vor- und Nachname, falls ein Firmenname als Lieferadresse genutzt wird.

LastName

ans..50

Pflicht, wenn FirstName übergeben wird: Nachname oder Firmenbezeichnung der Lieferadresse

AddrStreet

ans..100

Pflicht, wenn FirstName übergeben wird: Straßenname der Lieferadresse

AddrStreet2

ans..100

Pflicht, wenn FirstName übergeben wird: 2. Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vom Computop Helpdesk aktiviert werden.

AddrCity

ans..40

Pflicht, wenn FirstName übergeben wird: Ortsname der Lieferadresse

AddrState

ans..40

Pflicht, wenn FirstName übergeben wird: Bundesland (Bundesstaat) der Lieferadresse. Die in AddrCity übergebene Stadt muss im angegebenen Bundesstaat liegen, sonst lehnt PayPal die Zahlung ab. Mögliche Werte entnehmen Sie bitte der PayPal-API-Reference Dokumentation.

AddrZip

ans..20

Pflicht, wenn FirstName übergeben wird: Postleitzahl der Lieferadresse

AddrCountryCode

an2

Pflicht, wenn FirstName übergeben wird: Ländercode des Lieferlandes

Phone

n..20

Pflicht, wenn FirstName übergeben wird: Telefonnummer

Parameter für PayPal-Zahlungen mit Methode "shortcut"

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

Key	Format	CND	Description
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
CodeExt	n..10	O	Fehlercode des externen Partners, wenn mit dem Computop Helpdesk abgesprochen.

Key

Format

CND

Description

mid

ans..30

HändlerID, die von Computop vergeben wird

PayID

an32

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

XID

an32

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

TransID

ans..64

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

Status

a..50

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

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

Code

an8

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

refnr

ans..30

Eindeutige Referenznummer des Händlers

CodeExt

n..10

Fehlercode des externen Partners, wenn mit dem Computop Helpdesk abgesprochen.

Ergebnis-Parameter bei PayPal mit Methode "shortcut"

Aufruf der Schnittstelle für separate Autorisierung

Für eine PayPal Zahlung kann im Prozessablauf die ORDER von der anschließenden Autorisierung und nachfolgenden Schritten getrennt werden. Eine separate Autorisierung ist nur nach erfolgten Order (TxType=Order) möglich.

Für eine separate Autorisierung bei PayPal verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/Authorize.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:

Key	Format	CND	Description
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.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
TxType	ans..5	M	TransaktionstypAuth
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. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
FirstName	ans..50	O	Entweder nur der Vorname oder Vor- und Nachname, wenn ein Firmenname als Lieferadresse verwendet wird
LastName	ans..50	O	Nachname oder Firmenname der Lieferadresse
AddrStreet	ans..100	O	Straßenname in der Lieferadresse
AddrStreet2	ans..100	O	Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vomComputop Helpdesk aktiviert werden.
AddrCity	ans..40	O	Ort in der Lieferadresse
AddrState	ans..40	O	Bundesstaat der Lieferadresse. Der in AddrCity hinterlegte Ort muss im angegebenen Bundesland liegen, ansonsten lehnt PayPal diese Zahlung ab. Mögliche Werte entnehmen Sie bitte der PayPal-API-Referenzdokumentation.
AddrZip	ans..20	O	Postleitzahl in der Lieferadresse
AddrCountryCode	an2	O	Ländercode in der Lieferadresse
Phone	n..20	O	Telefonnummer

Key

Format

CND

Description

MerchantID

ans..30

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

PayID

an32

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

TransID

ans..64

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

TxType

ans..5

TransaktionstypAuth

Amount

n..10

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

FirstName

ans..50

Entweder nur der Vorname oder Vor- und Nachname, wenn ein Firmenname als Lieferadresse verwendet wird

LastName

ans..50

Nachname oder Firmenname der Lieferadresse

AddrStreet

ans..100

Straßenname in der Lieferadresse

AddrStreet2

ans..100

Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vomComputop Helpdesk aktiviert werden.

AddrCity

ans..40

Ort in der Lieferadresse

AddrState

ans..40

Bundesstaat der Lieferadresse. Der in AddrCity hinterlegte Ort muss im angegebenen Bundesland liegen, ansonsten lehnt PayPal diese Zahlung ab. Mögliche Werte entnehmen Sie bitte der PayPal-API-Referenzdokumentation.

AddrZip

ans..20

Postleitzahl in der Lieferadresse

AddrCountryCode

an2

Ländercode in der Lieferadresse

Phone

n..20

Telefonnummer

Parameter für PayPal-Autorisierung

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

Key	Format	CND	Description
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)
CodeExt	n..10	O	Fehlercode von PayPal, wenn mitComputop Helpdesk abgesprochen

Key

Format

CND

Description

mid

ans..30

HändlerID, die von Computop vergeben wird

PayID

an32

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

XID

an32

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

TransID

ans..64

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

Status

a..50

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

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

Code

an8

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

CodeExt

n..10

Fehlercode von PayPal, wenn mitComputop Helpdesk abgesprochen

Ergebnis-Parameter bei PayPal-Autorisierung

Aufruf der Schnittstelle für eine Buchung

Um eine Buchung (Capture) für PayPal ü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:

Key	REST	Format	CND	Description
MerchantID	BasicAuth.Username	ans..30	M	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	"paymentId": "..."	an32	M	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
TransID	"transactionId": "..."	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
MAC	–––	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
Amount	"amount": { "value": ...}	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	"amount": { "currency": "..."}	a3	M	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
RefNr	"referenceNumber": "..."	ans..30	O	Referenznummer des Händlers: hier kann eine separate Referenznummer übertragen werden, z.B. eine Rechnungsnummer
ReqId	"requestId": "..."	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.
TID	"payment": {"payPal": { "generatedCaptureId": "..." }}	ans..17	O	Eindeutige, von PayPal generierte Capture-ID.Der Wert wird für eine Rückerstattung nach mehreren Teilbuchungen benötigt. Beispiel: Ein Händler hat 3 Teilbuchungen für eine Autorisierung durchgeführt.Für jede Buchung wird eine eindeutige, von PayPal generierte Capture-ID in der TID zurückgegeben (z. B. TID=111, TID=222, TID=333).Dann sollte eine Rückerstattung für die zweite Buchung erfolgen.In diesem Fall muss der Händler TID=222 in der Anfrage der Rückerstattung senden.
CompleteType	"payment": {"payPal": { "completeType": "..." }}	ans..3	O	Wenn <YES> übergeben wird, wird die eventuell offene Bestellung von PayPal bei der Buchung geschlossen. (Grund: Seitens PayPal ist eine 115%ige Buchung zulässig. Wenn eine Buchung 100% erreicht, sendet das Computop Helpdesk automatisch eine Anfrage zum Schließen der Zahlung).

Key

REST

Format

CND

Description

MerchantID

BasicAuth.Username

ans..30

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

PayID

"paymentId": "..."

an32

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

TransID

"transactionId": "..."

ans..64

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

MAC

–––

an64

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

Amount

"amount": { "value": ...}

n..10

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

"amount": { "currency": "..."}

RefNr

"referenceNumber": "..."

ans..30

Referenznummer des Händlers: hier kann eine separate Referenznummer übertragen werden, z.B. eine Rechnungsnummer

ReqId

"requestId": "..."

ans..32

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

TID

"payment": {"payPal": { "generatedCaptureId": "..." }}

ans..17

Eindeutige, von PayPal generierte Capture-ID.Der Wert wird für eine Rückerstattung nach mehreren Teilbuchungen benötigt.

Beispiel: Ein Händler hat 3 Teilbuchungen für eine Autorisierung durchgeführt.Für jede Buchung wird eine eindeutige, von PayPal generierte Capture-ID in der TID zurückgegeben (z. B. TID=111, TID=222, TID=333).Dann sollte eine Rückerstattung für die zweite Buchung erfolgen.In diesem Fall muss der Händler TID=222 in der Anfrage der Rückerstattung senden.

CompleteType

"payment": {"payPal": { "completeType": "..." }}

ans..3

Wenn <YES> übergeben wird, wird die eventuell offene Bestellung von PayPal bei der Buchung geschlossen. (Grund: Seitens PayPal ist eine 115%ige Buchung zulässig. Wenn eine Buchung 100% erreicht, sendet das Computop Helpdesk automatisch eine Anfrage zum Schließen der Zahlung).

Parameter für PayPal-Buchungen

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

Key	REST	Format	CND	Description
mid	"merchantId": "..."	ans..30	M	HändlerID, die von Computop vergeben wird
PayID	"paymentId": "..."	an32	M	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	"xId": "..."	an32	M	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID	"transactionId": "..."	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Status	"status": "OK" "status": "FAILED"	a..50	M	OK (URLSuccess) oder FAILED (URLFailure)
Description	"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	"code": ...	an8	M	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
CodeExt	"externalErrorCode": ...	n..10	O	Fehlercode von PayPal, wenn mit Computop Helpdesk abgesprochen

Key

REST

Format

CND

Description

mid

"merchantId": "..."

ans..30

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

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

XID

"xId": "..."

an32

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

TransID

"transactionId": "..."

ans..64

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

Status

"status": "OK"

"status": "FAILED"

a..50

OK (URLSuccess) oder FAILED (URLFailure)

Description

"description": "..."

ans..1024

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

Code

"code": ...

an8

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

CodeExt

"externalErrorCode": ...

n..10

Fehlercode von PayPal, wenn mit Computop Helpdesk abgesprochen

Ergebnis-Parameter für PayPal-Buchungen

Aufruf der Schnittstelle für eine Gutschrift mit Referenz

Um eine Gutschrift (Credit) mit Referenztransaktion für PayPal 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:

Key	REST	Format	CND	Description
MerchantID	BasicAuth.Username	ans..30	M	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	"paymentId": "..."	an32	M	Vom Paygate vergebene ID für die gutzuschreibende Zahlung
TransID	"transactionId": "..."	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
MAC	–––	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
Amount	"amount": { "value": ...}	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	"amount": { "currency": "..."}	a3	M	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
RefNr	"referenceNumber": "..."	ans..30	O	Referenznummer des Händlers: hier kann eine separate Referenznummer übertragen werden, z.B. eine Rechnungsnummer
ReqId	"requestId": "..."	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.
TID	"payment": {"payPal": { "generatedCaptureId": "..." }}	ans..17	O	Eindeutige, von PayPal generierte Capture-ID.Der Wert wird für eine Rückerstattung nach mehreren Teilbuchungen benötigt. Beispiel: Ein Händler hat 3 Teilbuchungen für eine Autorisierung durchgeführt.Für jede Buchung wird eine eindeutige, von PayPal generierte Capture-ID in der TID zurückgegeben (z. B. TID=111, TID=222, TID=333).Dann sollte eine Rückerstattung für die zweite Buchung erfolgen.In diesem Fall muss der Händler TID=222 in der Anfrage der Rückerstattung senden.
Note	"reason": "..."	ans..768	C	Erläuterungstext für den Empfänger
Subject	"payment": {"payPal": { "massPayEmailSubject": "..." }}	ans..255	C	MassPay: E-Mail-Betreff an den Empfänger Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den Computop Helpdesk, um diese Funktion für Sie zu aktivieren.

Key

REST

Format

CND

Description

MerchantID

BasicAuth.Username

ans..30

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

PayID

"paymentId": "..."

an32

Vom Paygate vergebene ID für die gutzuschreibende Zahlung

TransID

"transactionId": "..."

ans..64

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

MAC

–––

an64

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

Amount

"amount": { "value": ...}

n..10

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

"amount": { "currency": "..."}

RefNr

"referenceNumber": "..."

ans..30

Referenznummer des Händlers: hier kann eine separate Referenznummer übertragen werden, z.B. eine Rechnungsnummer

ReqId

"requestId": "..."

ans..32

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

TID

"payment": {"payPal": { "generatedCaptureId": "..." }}

ans..17

Eindeutige, von PayPal generierte Capture-ID.Der Wert wird für eine Rückerstattung nach mehreren Teilbuchungen benötigt.

Note

"reason": "..."

ans..768

Erläuterungstext für den Empfänger

Subject

"payment": {"payPal": { "massPayEmailSubject": "..." }}

ans..255

MassPay: E-Mail-Betreff an den Empfänger

Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den Computop Helpdesk, um diese Funktion für Sie zu aktivieren.

Parameter für PayPal-Gutschriften mit Bezugstransaktion

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

Key	REST	Format	CND	Description
mid	"merchantId": "..."	ans..30	M	HändlerID, die von Computop vergeben wird
PayID	"paymentId": "..."	an32	M	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	"xId": "..."	an32	M	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID	"transactionId": "..."	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Status	"status": "OK" "status": "FAILED"	a..50	M	OK (URLSuccess) oder FAILED (URLFailure)
Description	"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	"code": ...	an8	M	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
CodeExt	"externalErrorCode": ...	n..10	O	Fehlercode von PayPal, wenn mit Computop Helpdesk abgesprochen
FeeRefundAmount	"payment": {"feeAmount": ...}	n..10	O	Der erstattete Betrag der PayPal-Transaktionsgebühren. Erforderlich für Teilgutschriften zu früheren Teilbuchungen.
GrossRefundAmount	"payment": {"grossAmount": ...}	n..10	O	Betrag, der dem Käufer bei dieser Gutschrift erstattet wird. Erforderlich für Teilgutschriften zu früheren Teilbuchungen.
NetRefundAmount	"payment": {"netAmount": ...}	n..10	O	Betrag, der von Ihrem PayPal-Konto abgezogen wird, um diese Gutschrift vorzunehmen. Erforderlich für Teilgutschriften zu früheren Teilbuchungen.

Key

REST

Format

CND

Description

mid

"merchantId": "..."

ans..30

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

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

XID

"xId": "..."

an32

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

TransID

"transactionId": "..."

ans..64

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

Status

"status": "OK"

"status": "FAILED"

a..50

OK (URLSuccess) oder FAILED (URLFailure)

Description

"description": "..."

ans..1024

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

Code

"code": ...

an8

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

CodeExt

"externalErrorCode": ...

n..10

Fehlercode von PayPal, wenn mit Computop Helpdesk abgesprochen

FeeRefundAmount

"payment": {"feeAmount": ...}

n..10

Der erstattete Betrag der PayPal-Transaktionsgebühren. Erforderlich für Teilgutschriften zu früheren Teilbuchungen.

GrossRefundAmount

"payment": {"grossAmount": ...}

n..10

Betrag, der dem Käufer bei dieser Gutschrift erstattet wird. Erforderlich für Teilgutschriften zu früheren Teilbuchungen.

NetRefundAmount

"payment": {"netAmount": ...}

n..10

Betrag, der von Ihrem PayPal-Konto abgezogen wird, um diese Gutschrift vorzunehmen. Erforderlich für Teilgutschriften zu früheren Teilbuchungen.

Ergebnis-Parameter für PayPal-Gutschriften mit Bezugstransaktion

Aufruf der Schnittstelle für nicht referenzierte Gutschriften

Um eine Gutschrift ohne Bezugstransaktion für PayPal abzuwickeln, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/paypalcreditEx.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:

Key	REST	Format	CND	Description
MerchantID	BasicAuth.Username	ans..30	M	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransID	"transactionId": "..."	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
refnr	"referenceNumber": "..."	ans..30	O	Eindeutige Referenznummer des Händlers
Amount	"amount": { "value": ...}	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	"amount": { "currency": "..."}	a3	M	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
PayerID		ans..13	O	Eindeutige Identifikationsnummer des Kundenkontos bei PayPal
ReqId	"requestId": "..."	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.
Account	"payment": {"payPal": { "accountId": "..." }}	ans..128	O	Für die Verwaltung mehrerer PayPal-Konten, Händlerkonto: ID oder E-Mail-Adresse, für die die Anfrage an PayPal gesendet werden soll
Note	"reason": "..."	ans..768	C	MassPay: Erläuterungstext für den Empfänger Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den Computop Helpdesk, um diese Funktion für Sie zu aktivieren.
Subject	"payment": {"payPal": { "massPayEmailSubject": "..." }}	ans..255	C	MassPay: E-Mail-Betreff an den Empfänger Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den Computop Helpdesk, um diese Funktion für Sie zu aktivieren.
Payer		ans..100	O	MassPay: E-Mail-Adresse des Käufers Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an denComputop Helpdesk, um diese Funktion für Sie zu aktivieren.

Key

REST

Format

CND

Description

MerchantID

BasicAuth.Username

ans..30

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

TransID

"transactionId": "..."

ans..64

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

refnr

"referenceNumber": "..."

ans..30

Eindeutige Referenznummer des Händlers

Amount

"amount": { "value": ...}

n..10

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

"amount": { "currency": "..."}

PayerID

ans..13

Eindeutige Identifikationsnummer des Kundenkontos bei PayPal

ReqId

"requestId": "..."

ans..32

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

Account

"payment": {"payPal": { "accountId": "..." }}

ans..128

Für die Verwaltung mehrerer PayPal-Konten, Händlerkonto: ID oder E-Mail-Adresse, für die die Anfrage an PayPal gesendet werden soll

Note

"reason": "..."

ans..768

MassPay: Erläuterungstext für den Empfänger

Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den Computop Helpdesk, um diese Funktion für Sie zu aktivieren.

Subject

"payment": {"payPal": { "massPayEmailSubject": "..." }}

ans..255

MassPay: E-Mail-Betreff an den Empfänger

Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den Computop Helpdesk, um diese Funktion für Sie zu aktivieren.

Payer

ans..100

MassPay: E-Mail-Adresse des Käufers

Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an denComputop Helpdesk, um diese Funktion für Sie zu aktivieren.

Parameter für PayPal-Gutschriften ohne Bezugstransaktion

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

Key	REST	Format	CND	Description
mid	"merchantId": "..."	ans..30	M	HändlerID, die von Computop vergeben wird
PayID	"paymentId": "..."	an32	M	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	"xId": "..."	an32	M	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID	"transactionId": "..."	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Status	"status": "OK" "status": "FAILED"	a..50	M	OK (URLSuccess) oder FAILED (URLFailure)
Description	"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	"code": ...	an8	M	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
CodeExt	"externalErrorCode": ...	n..10	O	Fehlercode von PayPal, wenn mit Computop Helpdesk abgesprochen
FeeRefundAmount	"payment": {"feeAmount": ...}	n..10	O	Der erstattete Betrag der PayPal-Transaktionsgebühren. Erforderlich für Teilgutschriften zu früheren Teilbuchungen.
GrossRefundAmount	"payment": {"grossAmount": ...}	n..10	O	Betrag, der dem Käufer bei dieser Gutschrift erstattet wird. Erforderlich für Teilgutschriften zu früheren Teilbuchungen.
NetRefundAmount	"payment": {"netAmount": ...}	n..10	O	Betrag, der von Ihrem PayPal-Konto abgezogen wird, um diese Gutschrift vorzunehmen. Erforderlich für Teilgutschriften zu früheren Teilbuchungen.

Key

REST

Format

CND

Description

mid

"merchantId": "..."

ans..30

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

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

XID

"xId": "..."

an32

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

TransID

"transactionId": "..."

ans..64

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

Status

"status": "OK"

"status": "FAILED"

a..50

OK (URLSuccess) oder FAILED (URLFailure)

Description

"description": "..."

ans..1024

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

Code

"code": ...

an8

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

CodeExt

"externalErrorCode": ...

n..10

Fehlercode von PayPal, wenn mit Computop Helpdesk abgesprochen

FeeRefundAmount

"payment": {"feeAmount": ...}

n..10

Der erstattete Betrag der PayPal-Transaktionsgebühren. Erforderlich für Teilgutschriften zu früheren Teilbuchungen.

GrossRefundAmount

"payment": {"grossAmount": ...}

n..10

Betrag, der dem Käufer bei dieser Gutschrift erstattet wird. Erforderlich für Teilgutschriften zu früheren Teilbuchungen.

NetRefundAmount

"payment": {"netAmount": ...}

n..10

Betrag, der von Ihrem PayPal-Konto abgezogen wird, um diese Gutschrift vorzunehmen. Erforderlich für Teilgutschriften zu früheren Teilbuchungen.

Ergebnis-Parameter für PayPal-Gutschriften ohne Bezugstransaktion

Aufruf der Schnittstelle für Stornierungen

Um eine Transaktion bei PayPal zu stornieren, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/reverse.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:

Key	REST	Format	CND	Description
MerchantID	BasicAuth.Username	ans..30	M	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	"paymentId": "..."	an32	M	Vom Paygate vergebene ID für die zu stornierende Zahlung
TransID	"transactionId": "..."	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
MAC	–––	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
Amount	"amount": { "value": ...}	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	"amount": { "currency": "..."}	a3	M	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
ReqId	"requestId": "..."	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.
ReqId	"requestId": "..."	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.

Key

REST

Format

CND

Description

MerchantID

BasicAuth.Username

ans..30

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

PayID

"paymentId": "..."

an32

Vom Paygate vergebene ID für die zu stornierende Zahlung

TransID

"transactionId": "..."

ans..64

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

MAC

–––

an64

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

Amount

"amount": { "value": ...}

n..10

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

"amount": { "currency": "..."}

ReqId

"requestId": "..."

ans..32

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

ReqId

"requestId": "..."

ans..32

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

Parameter für PayPal-Stornierungen

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

Key	REST	Format	CND	Description
mid	"merchantId": "..."	ans..30	M	HändlerID, die von Computop vergeben wird
PayID	"paymentId": "..."	an32	M	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	"xId": "..."	an32	M	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID	"transactionId": "..."	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Status	"status": "OK" "status": "FAILED"	a..50	M	OK (URLSuccess) oder FAILED (URLFailure)
Description	"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	"code": ...	an8	M	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
CodeExt	"externalErrorCode": ...	n..10	O	Fehlercode von PayPal, wenn mit Computop Helpdesk abgesprochen

Key

REST

Format

CND

Description

mid

"merchantId": "..."

ans..30

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

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

XID

"xId": "..."

an32

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

TransID

"transactionId": "..."

ans..64

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

Status

"status": "OK"

"status": "FAILED"

a..50

OK (URLSuccess) oder FAILED (URLFailure)

Description

"description": "..."

ans..1024

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

Code

"code": ...

an8

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

CodeExt

"externalErrorCode": ...

n..10

Fehlercode von PayPal, wenn mit Computop Helpdesk abgesprochen

Ergebnis-Parameter für PayPal-Stornierungen

Referenztransaktionen

Voraussetzungen

Die Option "Referenztransaktionen“ muss in Ihrem PayPal-Konto aktiviert sein. Beantragen Sie die Aktivierung bitte direkt bei PayPal.

Prozess

Der Prozess umfasst zwei Schritte.

Einrichten einer Abrechnungsvereinbarung (Anfangstransaktion der Abrechnungsvereinbarung)

Rufen Sie PayPalOrders.aspx mit TxType=BAID auf (siehe ). Als Antwort gibt das Paygate die URL zurück. Alle Parameter außer den folgenden sind im Fall von TxType=BAID optional.
Über die URL meldet sich der Kunde im PayPal-Konto an und genehmigt die Abrechnungsvereinbarung.
Sobald die Abrechnungsvereinbarung vom Kunden genehmigt ist, wird die Billing Agreement ID über URLNotify gesendet.

Nutzung der Abrechnungsvereinbarung

Rufen Sie PayPalRefTrans.aspx auf (unten als Server-zu-Server-Anfrage beschrieben) mit BillingAgreementID="Billing Agreement ID", die im vorigen Schritt erzeugt wurde. Der Kunde muss sich zur Genehmigung der Transaktion nicht mehr am PayPal-Konto anmelden.

Widerruf der Abrechnungsvereinbarung

Ein Kunde kann die Billing Agreement ID in seinem eigenen PayPal-Konto widerrufen.
Wenn ein Kunde die Billing Agreement ID widerruft, sind keine weiteren Referenztransaktionen (unter Verwendung dieser Billing Agreement ID) mehr möglich. Diese Billing Agreement ID kann auch nicht wieder reaktiviert werden.

Request

Um eine PayPal-Abonnementzahlung zu veranlassen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/paypalreftrans.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:

Key	Format	CND	Description
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
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. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
refnr	ans..30	O	Eindeutige Referenznummer des Händlers
OrderDesc	ans..30	O	Beschreibung der gekauften Waren, Einzelpreise usw.
BillingAgreementID	an19	M	Identifikationsnummer der Rechnungsvereinbarung. Wenn der Käufer die Rechnungsvereinbarung bestätigt, wird diese validiert und bleibt gültig, bis sie vom Käufer widerrufen wird.

Key

Format

CND

Description

MerchantID

ans..30

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

TransID

ans..64

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

Amount

n..10

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

refnr

ans..30

Eindeutige Referenznummer des Händlers

OrderDesc

ans..30

Beschreibung der gekauften Waren, Einzelpreise usw.

BillingAgreementID

an19

Identifikationsnummer der Rechnungsvereinbarung. Wenn der Käufer die Rechnungsvereinbarung bestätigt, wird diese validiert und bleibt gültig, bis sie vom Käufer widerrufen wird.

Parameter für PayPal-Referenztransaktionen

Antwort

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

Key	Format	CND	Description
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)
CodeExt	n..10	O	Fehlercode von PayPal, wenn mitComputop Helpdesk abgesprochen
refnr	ans..30	O	Eindeutige Referenznummer des Händlers
OrderID	ans..17	O	Eindeutige, von PayPal generierte OrderID
TID	ans..17	O	Eindeutige, von PayPal generierte CaptureID
Name	ans..50	M	Vorname und Nachname zusammen
FirstName	ans..50	M	Vorname des Zahlers (PayerInfo, kann vom Kontonamen abweichen)
LastName	ans..50	M	Nachname des Zahlers (PayerInfo, kann vom Kontonamen abweichen)
E-Mail	ans..100	M	E-Mail-Adresse des Käufers
BillingName	ans..32	O	Vorname und Nachname zusammen
BillingAddrCountryCode	an2	O	Ländercode in der Rechnungsadresse. Für die Rückgabe von Billing-Daten wenden Sie sich bitte direkt an Ihre Ansprechpartner bei PayPal, welche die Rückgabe sowohl für den Live- als auch den Sandbox-Account aktivieren müssen.
PayerID	ans..13	O	(falls Antwort aktiviert ist): Eindeutige Identifikationsnummer des Kundenkontos bei PayPal

Key

Format

CND

Description

mid

ans..30

HändlerID, die von Computop vergeben wird

PayID

an32

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

XID

an32

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

TransID

ans..64

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

Status

a..50

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

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

Code

an8

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

CodeExt

n..10

Fehlercode von PayPal, wenn mitComputop Helpdesk abgesprochen

refnr

ans..30

Eindeutige Referenznummer des Händlers

OrderID

ans..17

Eindeutige, von PayPal generierte OrderID

TID

ans..17

Eindeutige, von PayPal generierte CaptureID

Name

ans..50

Vorname und Nachname zusammen

FirstName

ans..50

Vorname des Zahlers (PayerInfo, kann vom Kontonamen abweichen)

LastName

ans..50

Nachname des Zahlers (PayerInfo, kann vom Kontonamen abweichen)

E-Mail

ans..100

E-Mail-Adresse des Käufers

BillingName

ans..32

Vorname und Nachname zusammen

BillingAddrCountryCode

an2

Ländercode in der Rechnungsadresse.

Für die Rückgabe von Billing-Daten wenden Sie sich bitte direkt an Ihre Ansprechpartner bei PayPal, welche die Rückgabe sowohl für den Live- als auch den Sandbox-Account aktivieren müssen.

PayerID

ans..13

(falls Antwort aktiviert ist): Eindeutige Identifikationsnummer des Kundenkontos bei PayPal

Ergebnis-Parameter für PayPal-Referenztransaktionen

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 einer PayPal-Zahlung übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.

Bei den Batch-Aufrufen ist die verwendete Batch-Version zu unterscheiden, wovon die optionalen Parameter abhängen. Alle mit „2.“ beginnen Versionsbezeichnungen betreffen Aufrufe für einen Konzern. Das bedeutet, innerhalb einer Batch-Datei mit einer bestimmten MerchantID können auch Transaktionen anderer Händler mit einer abweichenden Sub-MID übertragen werden.

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

Action

Version

Beschreibung

Authorize

1.0 / 2.0

Standardversion ohne Rückgabe von Parameter Code

1.4 / 2.4

mit TID

Capture

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)

1.4 / 2.4

mit TID

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)

1.4 / 2.4

mit TID

CreditEx

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)

Reverse

1.0 / 2.0

Standardversion ohne Rückgabe von Parameter Code

1.4 / 2.4

mit TID

ABO/REFTRANS

1.0 / 2.0

ABO - Classic PayPal API

REFTRANS - Order V2 PayPal API

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 PayPal-Zahlung in einer einzureichenden Batch-Datei sieht folgendermaßen aus:

1
HEAD,<MerchantID>,<Date>,<Version>
2
PAYPAL,Authorize,<Amount>,<Currency>,<TransID>,<PayID>
3
PAYPAL,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<TID>)
4
PAYPAL,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<TID>)
5
PAYPAL,CreditEx,<TransID>,(<RefNr>,)<Amount>,<Currency>,<payer>,<note>
6
PAYPAL,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<TID>)
7
PAYPAL,REFTRANS,<Amount>,<Currency>,<TransID>,(<RefNr>),(<OrderDesc>),(<Capture>),(<TxType>),<BillingAgreementId>
8
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

Hinweis: Bei Version 1.4 ist es auch möglich, bei einer Capture-Aktion den CompleteType zusätzlich mit zu übergeben:

PAYPAL,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>(,<CompleteType>,<TID>)

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

Key	Format	CND	Description
Type	a..11	M	HEAD für Header, FOOT für Footer, PAYPAL für PayPal
Action	a..20	M	Der Action-Parameter definiert die Art der Transaktion: Authorize (Autorisierung) Capture (Buchung) Credit (Gutschrift) CreditEx (Gutschrift ohne vorherige Buchung; bitte vereinbaren Sie das vorher mit dem Computop Helpdesk) Reverse (Storno) ABO (Abonnement, Classic API) REFTRANS (Abonnement, Order V2 API)
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. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
refnr	ans..30	O	Eindeutige Referenznummer des Händlers
payer	ans..100	O	MassPay: E-Mail-Adresse des Käufers: In diesem Fall übergeben Sie den empfangenen E-Mail-Parameter aus der Antwort Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den Computop Helpdesk, um diese Funktion für Sie zu aktivieren.
note	ans..758	O	Erläuterungstext für den Empfänger
PayID	an32	M	Vom Paygate vergebene ID für diese Transaktion
TID	ans..17	O	Eindeutige PayPal-Transaktionsnummer. Erforderlich für eine Reihe von Autorisierungen oder Teilbuchungen, Teilgutschriften oder Teilstornierungen.
OrderDesc	ans..127	O	Beschreibung der gekauften Waren, Einzelpreise usw.
Capture	a..6	O	Auto oder Manual: legt fest, ob der angeforderte Betrag sofort oder zu einem späteren Zeitpunkt abgerechnet wird. Für REFTRANS ist nur Auto möglich.
TxType	ans..5	OC	Pflicht bei Capture=Manual: Transaktionstyp mit den möglichen Werte Order und Auth
BillingAgreementID	an19	OC	Identifikationsnummer der Rechnungsvereinbarung. Wenn der Käufer die Rechnungsvereinbarung bestätigt, wird sie gültig und bleibt gültig, bis sie vom Käufer widerrufen wird. Pflicht bei X und Y.

Key

Format

CND

Description

Type

a..11

HEAD für Header, FOOT für Footer, PAYPAL für PayPal

Action

a..20

Der Action-Parameter definiert die Art der Transaktion:

Authorize (Autorisierung)

Capture (Buchung)

Credit (Gutschrift)

CreditEx (Gutschrift ohne vorherige Buchung; bitte vereinbaren Sie das vorher mit dem Computop Helpdesk)

Reverse (Storno)

ABO (Abonnement, Classic API)

REFTRANS (Abonnement, Order V2 API)

Amount

n..10

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

TransID

ans..64

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

refnr

ans..30

Eindeutige Referenznummer des Händlers

payer

ans..100

MassPay: E-Mail-Adresse des Käufers: In diesem Fall übergeben Sie den empfangenen E-Mail-Parameter aus der Antwort

Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den Computop Helpdesk, um diese Funktion für Sie zu aktivieren.

note

ans..758

Erläuterungstext für den Empfänger

PayID

an32

Vom Paygate vergebene ID für diese Transaktion

TID

ans..17

Eindeutige PayPal-Transaktionsnummer. Erforderlich für eine Reihe von Autorisierungen oder Teilbuchungen, Teilgutschriften oder Teilstornierungen.

OrderDesc

ans..127

Beschreibung der gekauften Waren, Einzelpreise usw.

Capture

a..6

Auto oder Manual: legt fest, ob der angeforderte Betrag sofort oder zu einem späteren Zeitpunkt abgerechnet wird.

Für REFTRANS ist nur Auto möglich.

TxType

ans..5

Pflicht bei Capture=Manual: Transaktionstyp mit den möglichen Werte Order und Auth

BillingAgreementID

an19

Identifikationsnummer der Rechnungsvereinbarung. Wenn der Käufer die Rechnungsvereinbarung bestätigt, wird sie gültig und bleibt gültig, bis sie vom Käufer widerrufen wird.

Pflicht bei X und Y.

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
PAYPAL,Authorize,<Amount>,<Currency>,<TransID>,<PayID>,<Status>,<Code>,<CodeExt>
3
PAYPAL,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<TID>,)<Status>,<Code>,<CodeExt>
4
PAYPAL,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<TID>,)<Status>,<Code>,<CodeExt>
5
PAYPAL,CreditEx,<TransID>,(<RefNr>,)<Amount>,<Currency>,<payer>,<note>,<Status>,<Code>,<CodeExt>
6
PAYPAL,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<TID>,)<Status>,<Code>,<CodeExt>
7
PAYPAL,REFTRANS,<Amount>,<Currency>,<TransID>,(<RefNr>),(<OrderDesc>),(<Capture>),(<TxType>),<BillingAgreementId>,<PayID>,<Status>,<Code>,<CodeExt>
8
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):

Key	Format	CND	Description
Action	a..20	M	Der Action-Parameter definiert die Art der Transaktion: Authorize (Autorisierung) Capture (Buchung) Credit (Gutschrift) CreditEx (Gutschrift ohne vorherige Buchung; bitte vereinbaren Sie das vorher mit dem Computop Helpdesk) Reverse (Storno) ABO (Abonnement, Classic API) REFTRANS (Abonnement, Order V2 API)
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)
CodeExt	n..10	O	Fehlercode von PayPal, wenn mitComputop Helpdesk abgesprochen

Key

Format

CND

Description

Action

a..20

Der Action-Parameter definiert die Art der Transaktion:

Authorize (Autorisierung)

Capture (Buchung)

Credit (Gutschrift)

CreditEx (Gutschrift ohne vorherige Buchung; bitte vereinbaren Sie das vorher mit dem Computop Helpdesk)

Reverse (Storno)

ABO (Abonnement, Classic API)

REFTRANS (Abonnement, Order V2 API)

PayID

an32

Vom Paygate vergebene ID für diese Transaktion

Status

a..50

OK (URLSuccess) oder FAILED (URLFailure)

Code

an8

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

CodeExt

n..10

Fehlercode von PayPal, wenn mitComputop Helpdesk abgesprochen

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien