Ü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. |
| 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 kann der Kunde auf der Seite des Händlers bleiben 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/.
Auf dieser Seite
Diagramm zum Prozessablauf
PayPal Prozessablauf
Konfiguration für PayPal
Damit Sie als Online-Anbieter PayPal-Transaktionen über das Computop Paygate abwickeln können, benötigen Sie ein Geschäftskonto bei PayPal. Sie müssen dem Computop auch API-Berechtigungen erteilen, um die Nutzung der PayPal-Schnittstelle über das Computop Paygate zu ermöglichen.
PayPal-Geschäftskonto anlegen und konfigurieren
1 Rufen Sie die URL https://developer.paypal.com auf und:
- erstellen ein neues PayPal-Geschäftskonto oder
- melden sich bei Ihrem bestehendem PayPal-Konto an und aktualisieren es auf ein PayPal-Geschäftskonto oder
- melden sich bei Ihrem bestehenden PayPal-Geschäftskonto an.
Erstellen und konfigurieren Sie eine REST-API-App und erhalten die REST-API-Zugangsdaten
1. Gehen Sie zu https://developer.paypal.com/developer/applications
2. Melden Sie sich mit Ihrem PayPal-Geschäftskonto beim Dashboard an und gehen Sie zu “My Apps & Credentials”
3. Erzeugen Sie eine REST-API-App per Klick auf die Schaltfläche “Create App”.
4. Geben Sie einen App Name ein und klicken auf die Schaltfläche “Create App”.
5. Die Webseite zeigt “Sandbox account”, “Client ID” und “Secret” für diese App.
6. Gehen Sie im Abschnitt SANDBOX zu “Accounts”.
7. Suchen Sie das Sandbox-Konto für die neu erstellte App (siehe Schritt 5), klicken dann auf die Schaltfläche “…” und wählen “View/edit account”.
8. Die Seite zeigt “Email ID” und “System Generated Password”, die später für die Anmeldung bei sandbox.paypal.com verwendet werden.
Dem Computop Paygate API-Berechtigungen erteilen
1. Gehen Sie zu https://www.paypal.com/US/cgi-bin/webscr?cmd=_profile-api-grant-authorization und geben frank.arnoldt_api1.computop.de als Third-Party Permission Username ein und klicken auf die Schaltfläche Lookup.
2. Erteilen Sie die folgenden Berechtigungen und klicken auf die Schaltfläche “Add”.
3. Nach dem Hinzufügen der Berechtigungen erscheint die folgende Seite mit einer Zusammenfassung der erteilten Berechtigungen.
Dem Computop Paygate auf der Sandbox API-Berechtigungen erteilen
1. Gehen Sie zu https://sandbox.paypal.com
2. Melden Sie sich mit “Email ID” und “System Generated Password” vom Entwicklerportal an (siehe Schritt 8 oben).
3. Die Seite zeigt Ihren Testshop.
4. Unter Ihrem Konto wählen Sie in der rechten oberen Ecke “Kontoeinstellungen” und dann “Website-Zahlungslösungen”.
5. Klicken Sie auf “Bearbeiten” vor “API-Zugriff”.
6. Klicken Sie auf “API-Genehmigung erteilen”.
7. Geben Sie test_paypal_api_api1.computop.com ein und klicken auf die Schaltfläche “Nachschlagen”. Erteilen Sie auf der Seite folgende Berechtigungen und klicken auf die Schaltfläche “Hinzufügen”.
8. Nach dem Hinzufügen der Berechtigungen erscheint die folgende Seite mit einer Zusammenfassung der erteilten Berechtigungen.
Zahlungseinstellungen in der Sandbox festlegen
1. Gehen Sie zu https://sandbox.paypal.com und melden sich mittels “Email ID” und “System Generated Password” vom Entwicklerportal an (siehe Schritte 1-3 oben).
2. Unter Ihrem Konto wählen Sie in der rechten oberen Ecke “Kontoeinstellungen” und dann “Zahlungseinstellungen”.
3. Klicken Sie auf “Bearbeiten” vor “Zahlungen blockieren”. Auf der Seite wählen Sie folgende Voreinstellungen.
4. Alle Änderungen auf der Seite werden “on fly” gespeichert, zum Speichern der Änderungen ist kein Klick auf eine Schaltfläche erforderlich.
PayPal Smart Button
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 -->
<!-- Replace <PayerID> with your value, available under your PayPal account -->
<!-- Replace <Currency> with the currency which should be used, e.g., EUR -->
<!-- When going live, replace client-id with the live client-id provided by Computop -->
<!-- When going live, replace data-partner-attribution-id with the live data-partner-attribution-id provided by Computop -->
<script type="text/javascript" src="https://www.paypal.com/sdk/js?client-id=ARCsDK7xBFxa5pnGxk8qvB0STB07fyi_yHDRrb5al6gxahj73Pxg9X2l7onP9J2IN-LqcVJojys94FLK&merchant-id=<PayerID>¤cy=<Currency>&disable-funding=giropay,sofort,sepa,card&intent=capture" data-partner-attribution-id="Computop_PSP_PCP_Test"></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({
// Call your server to set up the transaction
createOrder: function(data, actions) {
return fetch('https://www.computop-paygate.com/ExternalServices/paypalorders.aspx', {
method: 'POST',
body: params
}).then(function (res) {
return res.text();
}).then(function(orderData) {
let qData = new URLSearchParams(orderData)
payid = qData.get('PayID');
return qData.get('orderid');
});
},
// Call cbPayPal.aspx for continue sequence
onApprove: function (data, actions) {
var rd = "MerchantId=" + mid + "&PayId=" + payid + "&OrderId=" + data.orderID;
// Build an invisible form and directly submit it
const form = document.createElement('form');
form.method = 'POST';
form.action = 'https://www.computop-paygate.com/cbPayPal.aspx?rd=' + window.btoa(rd);
form.style.display = 'none';
// Add form to body
document.body.appendChild(form);
// Submit form
form.submit();
},
onCancel: function (data, actions) {
var rd = "MerchantId=" + mid + "&PayId=" + payid + "&OrderId=" + data.orderID;
// Build an invisible form and directly submit it
const form = document.createElement('form');
form.method = 'POST';
form.action = "https://www.computop-paygate.com/cbPayPal.aspx?rd=" + window.btoa(rd) + "&ua=cancel&token=" + data.orderID;
form.style.display = 'none';
// Add form to body
document.body.appendChild(form);
// Submit form
form.submit();
}
}).render('#paypal-button-container');
}
</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¤cy=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¤cy=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¤cy=EUR&disable-funding=giropay,sofort,sepa,card&intent=capture"></script>
Das Paygate bietet 3 mögliche Optionen für eine Zahlung.
- SALE (wenn das Paygate automatisch die Buchung für eine Zahlung sendet; das ist das Standardszenario, das den Anforderungen der meisten Händler entspricht)
- AUTHORIZE (wenn die Buchung später vom Händler als separater API-Aufruf gesendet werden soll)
- 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¤cy=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¤cy=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.
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
Datenformate: 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: CND Bedingung (condition) M Pflicht (mandatory) O optional C bedingt (conditional) Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.Definitionen
Format Beschreibung Abkürzung Beschreibung Kommentar Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist
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:
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. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
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 |
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:
Notice: If transferring FirstName, all other values should also be entered. If not transferring FirstName, other address parameters are not taken into account.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
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:
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:
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
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:
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
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:
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
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:
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
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:
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
Ergebnis-Parameter für PayPal-Stornierungen
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:
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>,<CodeExt>,<PayID>,<Status>,<Code> 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:
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>,<Status>,<Code>,<CodeExt> PAYPAL,REFTRANS,<Amount>,<Currency>,<TransID>,(<RefNr>),(<OrderDesc>),(<Capture>),(<TxType>),<BillingAgreementId>,<CodeExt>,<PayID>,<Status>,<Code> 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):
Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien