Über PayPal


Logo

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.

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

Auf dieser Seite


Diagramm zum Prozessablauf


 



Konfiguration für PayPal

PayPal Sandbox-Testkonto

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.

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

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

3. Wählen Sie „Konto anzeigen/bearbeiten“

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

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.


Sign up for PayPal Sandbox


Sign up for PayPal Production


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 gehen zu "Testing tools" --> "Sandbox Accounts".

2. Select the appropriate Sandbox merchant account and notify Merchant Services about "Account ID".


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.

image2023-3-29_21-32-47.png



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 lässt sich schnell mit nur einem Befehl installieren 
  • Die Konfiguration erfolgt zentral
  • Geeignet für alle Plattformen mit JS-Unterstützung

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.

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.

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8"/>
</head>
 
<body>
    <!-- Set up a container element for the button -->
    <div id="paypal-button-container"></div>
 
    <!-- Include the PayPal JavaScript SDK -->
    <!-- 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 --> 
    <script type="text/javascript" src="https://www.paypal.com/sdk/js?client-id=myClientID&currency=EUR&intent=capture"></script>
     
    <!-- Initialize and show PayPal button -->
    <script type="text/javascript">
    let mid = "YOUR MERCHANTID";
    let len = "LEN OF UNENCRYPTED BLOWFISH STRING";
    let data = "BLOWFISH ENCRYPTED STRING";
 	let payid;
     
        if (len != '' && data != '') {
            // Set the request parameter MerchantID, Len and Data
            const params = new URLSearchParams({
                MerchantID: mid,
                Len: len,
                Data: data
            });
 
            // Render the PayPal button into #paypal-button-container
            paypal.Buttons({
 		        // Choose either 'paypal.FUNDING.PAYPAL' or 'paypal.FUNDING.PAYLATER'
		        fundingSource: paypal.FUNDING.PAYPAL, 
                // Call your server to set up the transaction
                createOrder: function(data, actions) {
                    return fetch('https://paymentpage.axepta.bnpparibas/ExternalServices/paypalorders.aspx', {
                        method: 'POST',
                        body: params
                    }).then(function (res) {
                        return res.text();
                    }).then(function(orderData) {
                        var json = stringToObj(orderData);
						 	payid = json.PayID;
                        return json.orderid;
                    });
                },
                // Call cbPayPal.aspx for continue sequence
                onApprove: function (data, actions) {
                    var rd = "MerchantId=" + mid + "&PayId=" + payid + "&OrderId=" + data.orderID;
                    window.location = "https://epayment.axepta.bnpparibas/cbPayPal.aspx?rd=" + window.btoa(rd);
                    }
                        }).render('#paypal-button-container');
                    }
 
            function stringToObj (string) {
                var newobj = {};
                string.split('&').forEach(function (value) {
                var keypair = value.split('=');
                newobj[keypair[0]] = keypair[1];
            });
 
            return newobj;
        }
         
    </script>
     
</body>
</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.

<script type="text/javascript" src="https://www.paypal.com/sdk/js?client-id=sb&currency=EUR&disable-funding=giropay,sofort,sepa,card&intent=capture"></script>

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


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.

<script type="text/javascript" src="https://www.paypal.com/sdk/js?client-id=sb&currency=EUR&disable-funding=giropay,sofort,sepa,card&enable-funding=paylater"></script>

Im Ergebnis erscheinen folgende zwei Schaltflächen.


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.

<script type="text/javascript" src="https://www.paypal.com/sdk/js?client-id=sb&currency=EUR&disable-funding=giropay,sofort,sepa,card&intent=capture"></script>

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

  • SALE (capture=Auto) (wenn das Platform 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.

<script type="text/javascript" src="https://www.paypal.com/sdk/js?client-id=sb&currency=EUR&disable-funding=giropay,sofort,sepa,card&intent=capture"></script>

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

<script type="text/javascript" src="https://www.paypal.com/sdk/js?client-id=sb&currency=EUR&disable-funding=giropay,sofort,sepa,card&intent=authorize"></script>

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

Banner

Es ist möglich, direkt unter der Schaltfläche „Später bezahlen“ ein Banner mit zusätzlichen Details zur Verwendung der Option „Später bezahlen“ anzuzeigen.

Hierzu sollte der folgende Code zum Hauptteil der Produktseite hinzugefügt und der Parameter „data-pp-amount“ mit dem tatsächlichen Betragswert aktualisiert werden.

<div
      data-pp-message
      data-pp-style-layout="text"
      data-pp-style-logo-type="inline"
      data-pp-style-text-color="black"
      data-pp-style-text-size="12"
      data-pp-amount=<amount-value> 
      data-pp-placement="product"
</div>

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.


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

FormatBeschreibung

a

alphabetisch

as

alphabetisch mit Sonderzeichen

n

numerisch

an

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

ns

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

3

feste Länge mit 3 Stellen/Zeichen

..3

variable Länge mit maximal 3 Stellen/Zeichen

enum

Aufzählung erlaubter Werte

dttm

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


Abkürzungen

AbkürzungBeschreibungKommentar

CND

Bedingung (condition)


M

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

O

optional

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

C

bedingt (conditional)

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


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


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:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Key

Format

CND

Beschreibung

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.

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

KeyFormatCNDBeschreibung
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/.

KeyFormatCNDBeschreibung

MAC

an64

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

Key

Format

CND

Beschreibung

Capture

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

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

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

ans..127

M

Beschreibung der gekauften Waren, Einzelpreise usw.

OrderDesc(n)

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

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

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

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.

KeyFormatCNDBeschreibung
URLSuccess

ans..256

M

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

(info) Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von 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 senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

KeyFormatCNDBeschreibung
URLFailure

ans..256

M

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

(info) Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von 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.

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

KeyFormatCNDBeschreibung
URLNotify

ans..256

M

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

(info) 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.

KeyFormatCNDBeschreibung
UserData

ans..1024

O

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

KeyFormatCNDBeschreibung
ReqId

ans..32

O

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

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

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

Key

Format

CND

Beschreibung

Account

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
Languageans5O

Sprache. Bitte verwenden Sie ausschließlich die von PayPal in der Dokumentation unter https://developer.paypal.com/reference/locale-codes/ bereitgestellten Language-Werte aus der Spalte "BCP-47 code for REST APIs", zum Beispiel de-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.

  1. 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).
  2. 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/.
  3. Der Parameter ShipToCountry aus der Lieferadresse (sofern eine Lieferadresse übergeben wird)
  4. Der Parameter Localcode Parameter Language am Paygate mit einem 2-stelligen Ländercode (FR)
  5. 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

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

ans..50

OC

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

AddrStreet

ans..100

OC

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

AddrStreet2

ans..100

O

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

OC

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

AddrState

ans..40

OC

(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

ans..20

OC

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

AddrCountryCode

an2

O

Ländercode in der Lieferadresse

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.

RiskEvaluationans..2048O

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:

{
 "additional_data": [
    {
      "key": "sender_first_name",
      "value": "John"
    },
    {
      "key": "sender_last_name",
      "value": "Doe"
    }
]
}

 

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:

{
        merchantemailaddress: "merchant@example.com",
        merchantid: "XVRKM94GQDXB2",
        amount: "11000",
        itemtotal: "8000",
        taxtotal: "2000",
        shippingamount: "1000",
        invoiceid: "xxxxx",
        orderdescription: "yyyyy",
        orderitems: [
        {
            name: "zzzzz",
            quantity: "1",
            unitamount: "3000",
            tax: "1000",
            description: "xxxx",
            category: "PHYSICAL_GOODS"
        },
        {
            name: "xxxxx",
            quantity: "2",
            unitamount: "2500",
            tax: "500",
            description: "yyyyy",
            category: "DIGITAL_GOODS"
        }
    ]
}
  • 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.
modean8O

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

(info) Allgemeine Hinweise:

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

Wird nur im Zusammenhang mit PayPal Vault verwendet (Funktionsbeschreibung siehe unten).

Von PayPal generierte eindeutige Kunden-ID (Beispiel: CwCmvBGJhW).

Wenn PayPal Vault auf Händlerebene bei Computop aktiviert ist und der Parameter CustomeriD in der Anfrage angegeben ist, zeigt der PayPal-Minibrowser bereits gespeicherte Zahlungsoptionen an.


Parameter für PayPal-Zahlungen


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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

Key

Format

CND

Beschreibung

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

KeyFormatCNDBeschreibung
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!

KeyFormatCNDBeschreibung
Code

an8

M

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

KeyFormatCNDBeschreibung

MAC

an64

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

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung
UserData

ans..1024

O

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

Key

Format

CND

Beschreibung

CodeExtans..128O

Fehlercode (SCREAMING_SNAKE_CASE) von PayPal, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..512O

Fehlerbeschreibung von PayPal, wenn mit Computop Helpdesk abgesprochen

Nameans..50MVorname 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-Mailans..100ME-Mail-Adresse des Käufers

AddrStreet

ans..100

O

Straßenname in der Lieferadresse

AddrStreet2

ans..100

O

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

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
BillingAgreementIDans..19OBilling 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

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

payerStatusan..10OStatus 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..255O

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:

{"status":"COMPLETED", "id":"3C679366HH908993F1", "invoiceid":"PU1_20230812"}
{"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).

TIDans..17O

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.

TransactionIDans..17OThe parameter contains unique PayPal-generated Order ID
CustomerIDans..10O

Wird nur im Zusammenhang mit PayPal Vault verwendet (Funktionsbeschreibung siehe unten).

Von PayPal generierte eindeutige Kunden-ID (Beispiel: CwCmvBGJhW).

Wenn PayPal Vault auf Händlerebene bei Computop aktiviert ist und der Kunde im PayPal-Minibrowser die Speicherung der Zahlungsmethode gewählt oder einer Abrechnungsvereinbarung mit dem Händler zugestimmt hat (dem Händler die Berechtigung erteilt hat, in Zukunft Zahlungen ohne Kundenbeteiligung zu generieren).

VaultIDans..17O

Wird nur im Zusammenhang mit PayPal Vault verwendet (Funktionsbeschreibung siehe unten).

Von PayPal generierte eindeutige Vault-ID (Beispiel: 6xc41489mf360280l).

Wenn PayPal Vault auf Händlerebene bei Computop aktiviert ist und der Kunde im PayPal-Minibrowser die Speicherung der Zahlungsmethode gewählt oder einer Abrechnungsvereinbarung mit dem Händler zugestimmt hat (dem Händler die Berechtigung erteilt hat, in Zukunft Zahlungen ohne Kundenbeteiligung zu generieren).

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.


Funktion PayPal Vault

Die Funktion PayPal Vault bietet zwei Anwendungsfälle.

Anwendungsfall 1: Anzeige gespeicherter Zahlungsmethoden im PayPal Minibrowser

Wenn PayPal Vault auf Händlerebene bei Computop aktiviert ist und der Parameter CustomerID in der Anfrage angegeben ist, zeigt der PayPal-Minibrowser die bereits gespeicherten Zahlungsoptionen wie folgt an.

So funktioniert es:

  • Der Händler ist bei Computop für PayPal Vault konfiguriert.
  • In diesem Fall sendet Computop durch Aufruf von paypalorders.aspx ein Flag an PayPal, um dem Kunden die Option „Zahlungsmethode für weitere Verwendung speichern“ im PayPal-Minibrowser anzubieten.
  • Falls der Kunde der Option zustimmt, erhält der Händler als Antwort die Parameter CustomerID und VaultID.
  • Wenn der Händler beim nächsten Mal die CustomerID in einer Anfrage an paypayorders.aspx sendet, werden dem Kunden die zuvor gespeicherten Zahlungsmethoden angezeigt (siehe Abbildung oben).

Anwendungsfall 2: Referenztransaktionen (oder Abrechnungsvereinbarung)

So funktioniert es:

  • Der Händler ist bei Computop für PayPal Vault konfiguriert.
  • In diesem Fall sendet Computop durch Aufruf von paypalorders.aspx ein Flag an PayPal, dass es sich um die erste Zahlung in einer Reihe von Zahlungen handelt. PayPal fordert den Kunden auf, die Transaktionen im PayPal-Browser zu bestätigen.
  • Falls der Kunde dem zustimmt, erhält der Händler als Antwort die Parameter CustomerID und VaultID.
  • Um die nächste Zahlung (aus der Reihe der bestätigten Zahlungen) einzuleiten, ruft der Händler paypalvault.aspx auf und sendet die VaultID im Parameter BillingAgreementID.

Wichtiger Hinweis

In beiden Anwendungsfällen werden zwei Benachrichtigungen für die Anfrage paypalorders.aspx an URLNotify gesendet. Dies liegt daran, dass PayPal die Anfrage im Fall von PayPal Vault in zwei Schritten verarbeitet. Im ersten Schritt wird auf PayPal-Seite ein Vault erstellt. Dabei konnten die Parameter CustomerID und VaultID nicht zurückgegeben werden. Im zweiten Schritt wird der Vault auf PayPal-Seite genehmigt. Dabei werden die Parameter CustomerID und VaultID erstellt und zurückgegeben.

Es ist daher möglich, dass die Parameter CustomerID und VaultID in der ersten Benachrichtigung fehlen. Warten Sie in diesem Fall bitte auf die zweite Benachrichtigung (in den meisten Fällen erfolgt diese innerhalb von 5-10 Sekunden). 


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:

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:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

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

KeyFormatCNDBeschreibung
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/.

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Key

Format

CND

Beschreibung

PayID

an32

M

Vom Platform vergebene ID für die Zahlung.

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




(info) Adressinformationen. Durch Übergabe dieser Werte ist auch eine Adress-Änderung möglich.
(warning) 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

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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDBeschreibung
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!

KeyFormatCNDBeschreibung
Code

an8

M

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

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung
CodeExt

n..10

O

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

 

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:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

Key

Format

CND

Description

Beschreibung

TxTypeans..5MTransaction type AuthTransaktionstyp Auth

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

KeyFormatCNDBeschreibung
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/.

Key

Format

CND

Beschreibung

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

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

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

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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDBeschreibung
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!

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung

CodeExtans..128O

Fehlercode (SCREAMING_SNAKE_CASE) von PayPal, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..512O

Fehlerbeschreibung von PayPal, wenn mit Computop Helpdesk abgesprochen

Ergebnis-Parameter bei PayPal-Autorisierung


Buchung

Um eine Buchung (Capture) für PayPal über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

 

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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung

MAC

an64

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

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

KeyFormatCNDBeschreibung
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/.

Key

Format

CND

Beschreibung

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

KeyFormatCNDBeschreibung
ReqId

ans..32

O

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

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

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

Key

Format

CND

Beschreibung

TIDans..17O

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.

CompleteTypeans..3O

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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDBeschreibung
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!

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung

CodeExtans..128O

Fehlercode (SCREAMING_SNAKE_CASE) von PayPal, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..512O

Fehlerbeschreibung von PayPal, wenn mit Computop Helpdesk abgesprochen

Ergebnis-Parameter für PayPal-Buchungen


Gutschrift mit Referenz

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

 

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:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
PayID

an32

M

Vom Paygate vergebene ID für die gutzuschreibende Zahlung

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung

MAC

an64

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

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

KeyFormatCNDBeschreibung
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/.

Key

Format

CND

Beschreibung

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

KeyFormatCNDBeschreibung
ReqId

ans..32

O

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

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

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

Key

Format

CND

Beschreibung

TIDans..17O

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.

Noteans..768CErläuterungstext für den Empfänger
Subjectans..255C

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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDBeschreibung
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!

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung

CodeExtans..128O

Fehlercode (SCREAMING_SNAKE_CASE) von PayPal, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..512O

Fehlerbeschreibung von PayPal, wenn mit Computop Helpdesk abgesprochen

FeeRefundAmount

n..10

O

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

GrossRefundAmount

n..10

O

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

NetRefundAmount

n..10

O

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


Storno

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

 

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:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
PayID

an32

M

Vom Paygate vergebene ID für die zu stornierende Zahlung

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung

MAC

an64

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

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

KeyFormatCNDBeschreibung
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/.

KeyFormatCNDBeschreibung
ReqId

ans..32

O

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

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

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

Parameter für 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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDBeschreibung
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!

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung

CodeExtans..128O

Fehlercode (SCREAMING_SNAKE_CASE) von PayPal, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..512O

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

  1. 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.
  2. Über die URL meldet sich der Kunde im PayPal-Konto an und genehmigt die Abrechnungsvereinbarung.
  3. Sobald die Abrechnungsvereinbarung vom Kunden genehmigt ist, wird die Billing Agreement ID über URLNotify gesendet.

Nutzung der Abrechnungsvereinbarung

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

Anfrage

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


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:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

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

KeyFormatCNDBeschreibung
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/.

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Key

Format

CND

Beschreibung

OrderDescans..30OBeschreibung der gekauften Waren, Einzelpreise usw.
BillingAgreementIDan19MIdentifikationsnummer 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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDBeschreibung
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!

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung

CodeExtans..128O

Fehlercode (SCREAMING_SNAKE_CASE) von PayPal, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..512O

Fehlerbeschreibung von PayPal, wenn mit Computop Helpdesk abgesprochen

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Key

Format

CND

Beschreibung

OrderIDans..17OEindeutige, von PayPal generierte OrderID
TIDans..17OEindeutige, von PayPal generierte CaptureID
Nameans..32OVor- und Nachname zusammengefügt

FirstName

ans..50

O

Vorname des Zahlers (PayerInfo, kann vom Kontonamen abweichen)

LastName

ans..50

O

Nachname des Zahlers (PayerInfo, kann vom Kontonamen abweichen)
E-Mailans..100OE-Mail-Adresse des Käufers

BillingName

ans..32

O

Vor- und Nachname zusammengefügt

BillingAddrCountryCode

an2

O

Ländercode der Rechnungsadresse

PayerID

ans..13

O

(bei aktivierter Antwort): Eindeutige ID des Kundenkontos bei PayPal

Ergebnis-Parameter für PayPal-Referenztransaktionen


Vault

Voraussetzungen

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

Prozess

Der Prozess umfasst zwei Schritte.

Einrichten eines Vault (Anfangstransaktion des Vault)

  1. Rufen Sie PayPalOrders.aspx auf. Falls die Funktion für Ihre MID aktiviert ist, gibt Paypal/Computop Paygate die VaultID zurück.
  2. Über die URL meldet sich der Kunde im PayPal-Konto an und genehmigt den Vault.
  3. Sobald der Vault vom Kunden genehmigt ist, wird die VaultID über URLNotify gesendet.

Nutzung des Vault

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

Widerruf des Vault

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

Anfrage

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


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:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

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

KeyFormatCNDBeschreibung
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/.

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Key

Format

CND

Beschreibung

OrderDescans..30OBeschreibung der gekauften Waren, Einzelpreise usw.
VaultIDan19MIdentifikationsnummer 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-Vault-Transaktionen


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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDBeschreibung
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!

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung

CodeExtans..128O

Fehlercode (SCREAMING_SNAKE_CASE) von PayPal, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..512O

Fehlerbeschreibung von PayPal, wenn mit Computop Helpdesk abgesprochen

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Key

Format

CND

Beschreibung

OrderIDans..17OEindeutige, von PayPal generierte OrderID
TIDans..17OEindeutige, von PayPal generierte CaptureID
Nameans..32OVor- und Nachname zusammengefügt

FirstName

ans..50

O

Vorname des Zahlers (PayerInfo, kann vom Kontonamen abweichen)

LastName

ans..50

O

Nachname des Zahlers (PayerInfo, kann vom Kontonamen abweichen)
E-Mailans..100OE-Mail-Adresse des Käufers

BillingName

ans..32

O

Vor- und Nachname zusammengefügt

BillingAddrCountryCode

an2

O

Ländercode der Rechnungsadresse

PayerID

ans..13

O

(bei aktivierter Antwort): Eindeutige ID des Kundenkontos bei PayPal
Ergebnis-Parameter für PayPal-Vault-Transaktionen


Paketverfolgung

Mit der Paketverfolgungsfunktion können Sie PayPal-Bestellungen nach dem Erstellen eines Versandetiketts Sendungsverfolgungsnummern zuweisen. Die Angabe der Versanddetails erleichtert die Identifizierung von Artikeln während des Transports und verbessert das Zahlungserlebnis in der App. Die Versandinformationen werden von PayPal außerdem im Streitbeilegungsprozess verwendet.

Um Versanddetails über eine Server-zu-Server-Verbindung hinzuzufügen oder zu entfernen, verwenden Sie bitte die folgende URL:


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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung

MAC

an64

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

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

KeyFormatCNDBeschreibung
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/.

Key

Format

CND

Beschreibung

EventToken

a..6

M

Mögliche Werte: „add“, „remove“

TrackingNumber

ans..64

C

Vom Spediteur bereitgestellte Sendungsnummer.

Muss im Fall von EventToken="add" angegeben werden.

CarrierName

ans..128

C

Entweder Name des Spediteurs aus der von PayPal bereitgestellten Liste der Spediteure (Link) oder „OTHER“.

Muss im Fall von EventToken="add" angegeben werden.

CarrierNameOther

ans..128

C

Muss im Fall von EventToken="add" und CarrierName="OTHER" angegeben werden.

TID

ans..17

O

Bei Mehrfachbuchungen (z. B. Teilbuchungen) ist es möglich, für jede einzelne Buchung eine Sendungsnummer anzugeben.

Nur gültig im Fall von EventToken="add".

OrderItems

ans..2048

O

Array von JSON-Objekten OrderItem.

Nur gültig im Fall von EventToken="add".

Parameter für PayPal-Paketverfolgung


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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDBeschreibung
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!

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung

CodeExt

ans..128

O

Fehlercode (SCREAMING_SNAKE_CASE) von PayPal, wenn mit dem Computop Helpdesk abgesprochen.

ErrorTextans..512O

Fehlerbeschreibung von PayPal, wenn mit Computop Helpdesk abgesprochen

TrackerID

ans..30

M

Von PayPal generierte eindeutige Tracker-ID.

Dieser Wert sollte im Parameter TrackerID mit EventToken="remove" gesendet werden (z. B. wenn Tracking-Informationen versehentlich gesendet wurden und entfernt werden sollen).

Antwort-Parameter für PayPal-Paketverfolgung


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.4mit 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:

HEAD,<MerchantID>,<Date>,<Version>
PAYPAL,Authorize,<Amount>,<Currency>,<TransID>,<PayID>
PAYPAL,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<TID>)
PAYPAL,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<TID>)
PAYPAL,CreditEx,<TransID>,(<RefNr>,)<Amount>,<Currency>,<payer>,<note>
PAYPAL,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<TID>)
PAYPAL,REFTRANS,<Amount>,<Currency>,<TransID>,(<RefNr>),(<OrderDesc>),(<Capture>),(<TxType>),<BillingAgreementId>
FOOT,<CountRecords>,<SumAmount>


Beispiel für Master-MID-Funktion:

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
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

Beschreibung

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)

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

KeyFormatCNDBeschreibung
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/.

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Key

Format

CND

Beschreibung
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

OErläuterungstext für den Empfänger

KeyFormatCNDBeschreibung
PayID

an32

M

Vom Paygate vergebene ID für diese Transaktion

Key

Format

CND

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

Beschreibung der Felder im Datensatz von Batch-Dateien


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

HEAD,<MerchantID>,<Date>,<Version>
PAYPAL,Authorize,<Amount>,<Currency>,<TransID>,<PayID>,<Status>,<Code>,<CodeExt>
PAYPAL,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<TID>,)<Status>,<Code>,<CodeExt>
PAYPAL,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<TID>,)<Status>,<Code>,<CodeExt>
PAYPAL,CreditEx,<TransID>,(<RefNr>,)<Amount>,<Currency>,<payer>,<note>,<Status>,<Code>,<CodeExt>
PAYPAL,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<TID>,)<Status>,<Code>,<CodeExt>
PAYPAL,REFTRANS,<Amount>,<Currency>,<TransID>,(<RefNr>),(<OrderDesc>),(<Capture>),(<TxType>),<BillingAgreementId>,<PayID>,<Status>,<Code>,<CodeExt>
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

Beschreibung

Action

a..20

M

Der Action-Parameter definiert die Art der Transaktion wie Buchung oder Gutschrift.

KeyFormatCNDBeschreibung
PayID

an32

M

Vom Paygate vergebene ID für diese Transaktion

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung
CodeExtans..128O

Fehlercode (SCREAMING_SNAKE_CASE) von PayPal, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..512O

Fehlerbeschreibung von PayPal, wenn mit Computop Helpdesk abgesprochen

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien