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. Weiterhin müssen Sie die PayPal-Schnittstelle für die Nutzung über das Paygate freigeben und die nötigen Einstellungen für den Empfang von Zahlungen vornehmen.

PayPal-Geschäftskonto anlegen und konfigurieren

1. Bitte rufen Sie die URL http://www.paypal.com
2. Anschließend klicken Sie links in der Servicebox auf die Schaltfläche „Neu anmelden“.
   
3. Sie werden von PayPal auf die nächste Seite weitergeleitet.
4. Dort wählen Sie „Geschäftskonto“ aus und klicken auf „weiter“.
   
5. Nun werden Sie auf die Seite „Geschäftskonto eröffnen“ weitergeleitet. Bitte geben Sie dort Ihre E-Mail-Adresse ein, welche für den PayPal-Account verwendet werden soll und klicken dann auf die Schaltfläche „Weiter“.
   
6. Bitte geben Sie hier Ihre Daten ein, bestätigen per Option die PayPal-Nutzungsbedingungen und klicken dann auf die Schaltfläche „Weiter“.
   
7. Hinterlegen Sie auf den nächsten Seiten die benötigten Angaben zu Ihrem Unternehmen.
8. Sie erhalten jetzt eine E-Mail, welche Sie bestätigen müssen.
   
9. Ergänzen Sie bitte die weiteren notwendigen Angaben zu Ihrem Unternehmen.
   

PayPal-API freigeben

Damit über das Computop Paygate PayPal-Transaktionen abgewickelt werden können, muss die API-Genehmigung für Computop erteilt werden. Dazu führen Sie die nachfolgend erklärten sechs Schritte aus.

1. Wählen Sie im Menü „Mein Profil“ die „Kontoeinstellungen“ aus
   
2. Bitte wählen Sie nun links in der Servicebox „Verkäufer/Händler“ …
   
   … und anschließend mit der Schaltfläche „Aktualisieren“ den Punkt „API-Zugriff“ aus.
   
3. Klicken Sie dann bitte auf den Link „API-Genehmigung erteilen“
   
4. Bitte tragen Sie im Feld „Benutzername für Genehmigungen für Drittanbieter“ den nachfolgenden Wert ein und klicken dann auf die Schaltfläche „Nachschlagen“: frank.arnoldt_api1.computop.de
   
5. Bitte setzen Sie bei den folgenden Punkten das Häkchen, alle anderen Optionen lassen Sie deaktiviert. Anschließend bestätigen Sie die Eingaben per Schaltfläche „Hinzufügen“.
   - Verwenden der Express-Kaufabwicklung für Ihre Zahlungsvorgänge
   - Veranlassen einer Rückzahlung für bestimmte Transaktionen
   - Autorisieren und Einziehen Ihrer PayPal-Transaktionen
   - Abrufen von Informationen zu einer einzelnen Transaktion
   - Durchsuchen Ihrer Transaktionen nach Artikeln, die spezifische Kriterien entsprechen, und Anzeigen der Ergebnisse
   
6. Sie erhalten die Bestätigung darüber, dass der Drittanbieter „frank.arnoldt_api1.computop.de“ hinzugefügt wurde.
   

PayPal-API Genehmigungen für Sandbox erteilen

Für die PayPal Sandbox können die API-Genehmigungen folgendermaßen erteilt werden.

1. Auf https://developer.paypal.com finden Sie unter "Accounts" --> (Accountname) --> "Manage accounts" --> "View/ edit account" die Zugangsdaten des jeweiligen Händlerkontos.
   
2. Mit diesen Zugangsdaten melden Sie sich unter https://sandbox.paypal.com an.
   
   
3. Klicken Sie oben rechts auf den Namen und gehen zu den "Kontoeinstellungen".
   
   
4. Klicken Sie auf "API-Zugriff" --> "API-Genehmigung erteilen" --> Tragen Sie "test_paypal_api_api1.computop.com" ein.
   
   
5. Setzen Sie die Häkchen bei folgenden Berechtigungen:
   - Verwenden von PayPal Express für Ihre Zahlungsvorgänge
   - Veranlassen einer Rückzahlung für eine bestimmte Transaktion
   - Autorisieren und Einziehen Ihrer PayPal-Transaktionen
   - Abrufen von Informationen zu einer einzelnen Transaktion
   - Ihre Transaktionen nach bestimmte Kriterien durchsuchen und die Suchergebnisse anzeigen

Einstellungen für den Zahlungsempfang vornehmen

1. Im Menü wählen Sie „Mein Profil“ aus und klicken auf „Kontoeinstellungen“.
   
   
2. Bitte wählen Sie hier unter „Verkäufer/Händler“ den Punkt „Zahlungen sperren“ über den Link „Aktualisieren“ aus.
   
3. Bitte stellen Sie hier folgende Punkte ein.
   - Zahlungseingänge in einer nicht unterstützten Währung blockieren
   - Doppelte Zahlungen mit gleicher Invoice ID vermeiden
   - Automatische Zahlungen für eBay-Rückerstattungen einrichten
   - Texteingabefeld "Anweisungen für Verkäufer hinzufügen" anzeigen
   
   Bitte bestätigen Sie Ihre Eingaben mit einem Klick auf die Schaltfläche „Speichern“.

Paygate-Schnittstelle

Definitionen

Datenformate

Abkürzungen

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:

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: Bitte beachten Sie, dass eine PayPal-Anbindung im Shop per i-Frame aufgrund von PayPal-Regularien nicht möglich ist. Express Checkout funktioniert mit einer Weiterleitung des Kunden direkt zu PayPal.

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. mid, 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:

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Description
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

Key	Format	CND	Description
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment

Key	Format	CND	Description
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

Key	Format	CND	Description
Currency	a3	M	Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table. Please note the global PayPal supported currencies at https://developer.paypal.com/api/rest/reference/currency-codes/.

Key	Format	CND	Description
refnr	ans..30	O	Merchant’s unique reference number

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment. Enter the PayID from the response from paypal.aspx received in the previous transaction procedure.	Vom Paygate vergebene ID für die Zahlung. Übergeben Sie hier die PayID aus der Antwort von paypal.aspx, die Sie im bisherigen Transaktionsablauf erhalten haben.
OrderDesc(n)	ans..2048	O	Customers shopping basket in the form: OrderDesc(n)=Name,Amount,Number,Quantity,Description,Tax OrderDesc2 to max. OrderDesc99 permissible For correct execution of displaying function all OrderDesc(n) Amounts must equal to the parameter Amount. If OrderDesc(n) is used, there must be valid: Amount=ItemTotal+TaxTotal+SHAmount Notice: If OrderDesc(n) is changed also the Amount has to be modified.	Warenkorb des Kunden in der Form: OrderDesc(n)=Name,Amount,Number,Quantity,Description,Tax OrderDesc2 bis max. OrderDesc99 zulässig Zur korrekten Ausführung der Darstellungsfunktion müssen alle OrderDesc(n) Amounts mit dem übergebenen Parameter Amount übereinstimmen. Wenn OrderDesc(n) verwendet wird, muss gelten: Amount=ItemTotal+TaxTotal+ShAmount Hinweis: Bei Änderung von OrderDesc(n) muss auch der Amount angepasst werden.
			Address information. When you transfer these values you can also change an address. Notice: If transferring FirstName, all other values should also be entered. If not transferring FirstName, other address parameters are not taken into account.	Adressinformationen. Durch Übergabe dieser Werte ist auch eine Adress-Änderung möglich. Hinweis: Wenn FirstName übergeben wird, sollten auch alle anderen Werte übergeben werden. Wenn FirstName nicht übergeben wird, werden andere Adressparameter nicht berücksichtigt.
FirstName	ans..50	C	Mandatory in order to transfer address information Either the first name only or first and second name if a company name is used as a delivery address.	Pflicht, um Adressangaben zu übermitteln: Entweder nur der Vorname oder Vor- und Nachname, falls ein Firmenname als Lieferadresse genutzt wird.
LastName	ans..50	C	Obligatory if FirstName is transmitted: Surname or name of the company of the delivery address	Pflicht, wenn FirstName übergeben wird: Nachname oder Firmenbezeichnung der Lieferadresse
AddrStreet	ans..100	C	Obligatory if FirstName is transmitted: Street in the delivery address	Pflicht, wenn FirstName übergeben wird: Straßenname der Lieferadresse
AddrStreet2	ans..100	C	Obligatory if FirstName is transmitted: 2. Street name in the delivery address that contains additional information e.g. packing station or similar. In order to receive this as a response parameter, it needs to be activated separately by the Computop Helpdesk.	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 The page DE:Wording (veraltet) was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro aktiviert werden.
AddrCity	ans..40	C	Obligatory if FirstName is transmitted: Town/city in the delivery address	Pflicht, wenn FirstName übergeben wird: Ortsname der Lieferadresse
AddrState	ans..40	C	Obligatory if FirstName is transmitted: Federal state of the delivery address. The town submitted in AddrCity must be located in the given federal state, otherwise PayPal refused this payment. For possible values please refer to the PayPal-API-reference documentation.	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	Obligatory if FirstName is transmitted: Postcode in the delivery address	Pflicht, wenn FirstName übergeben wird: Postleitzahl der Lieferadresse
AddrCountryCode	an2	C	Obligatory if FirstName is transmitted: Country code of the delivery country	Pflicht, wenn FirstName übergeben wird: Ländercode des Lieferlandes
Phone	n..20	C	Obligatory if FirstName is transmitted: Telephone number	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

Ergebnis-Parameter bei PayPal mit Methode "shortcut"

Aufruf der Schnittstelle für separate Autorisierung

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

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

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. mid, 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:

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

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:

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. mid, 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 und Parameter:

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. mid, 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 und Parameter:

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

Ergebnis-Parameter für PayPal-Stornierungen

Aufruf der Schnittstelle für Abonnements

Voraussetzungen

• Die Option „Reference Transaction“ muss bei PayPal eingerichtet sein. Bitten Sie PayPal direkt um die Aktivierung.
• Bitte konfigurieren Sie zusätzlich die entsprechende Genehmigung in Ihrem Paypal-Händlerkonto
• Belasten bestehender Kunden auf der Grundlage einer früherer Transaktion
• Einholen der Autorisierung und initiieren von PayPal-Zahlungen per Händleranbindung
• Die Option „Reference Transaction“ muss für Ihre Computop MerchantID eingerichtet sein.

Ablauf

1. Zur Erstellung eines Abos wird zuerst eine normale PayPal-Zahlung mit dem zusätzlichen Parameter „RTF=I“ initiiert. Dies fügt ein Abo-Flag an die Transaktion an, damit diese von PayPal wiedererkannt wird. Möchten Sie in dem ersten Request nur die „BillingAgreementID“ holen, ohne dem Kunden einen Betrag anzuzeigen, übermitteln Sie bitte an das Paygate den Parameter "txtype=BAID". Wird der txtype=BAID gesendet, wird der eingereichte Betrag vom Paygate automatisch auf 0,00 gesetzt.
   Bitte beachten Sie, dass der Händler auf gar keinen Fall einen Betrag von 0,00€ senden darf, dies kann unser Paygate nicht verarbeiten.
   D.h. der Händler muss einen Betrag X >0,00 übertragen und wir setzen diesen dann in Richtung PayPal auf 0,00.
2. Unsere Response an den Händler enthält die normalen PayPal-Parameter sowie den zusätzlichen Parameter „BillingAgreementID“. Dieser muß in deren System an der Zahlung hinterlegt werden.
3. Zur Erstellung der zweiten/wiederkehrenden Abo-Zahlung verwenden Sie bitte die URL https://www.computop-paygate.com/paypalAbo.aspx durchgeführt werden. In dieser Server-zu-Server-Verbindung verwenden Sie bitte die normalen PayPal-Parameter zuzüglich des Parameters „BillingAgreementID“. Der zusätzliche Parameter löst die zweite/wiederkehrende Zahlung mit Bezug auf die ursprüngliche Zahlung aus Auf diese Weise ist kein Login des PayPal-Kunden notwendig und Sie können Beträge von dessen Konto abbuchen.

Hinweis

• Folgender Zusatz wird während des Bezahlprozesses im PayPal Account des Kunden angezeigt (Beispiel):
  "Hiermit genehmigen Sie –Händlername–, künftige Zahlungen direkt und ohne Ihr Zutun von Ihrem PayPal-Konto abzubuchen. Sie können diese Genehmigung für die Zukunft jederzeit in Ihrem Profil widerrufen."
• Der Kunde kann sich in seinem PayPal Account über diese Funktion informieren.

Capture on demand (capture=manual + txtype=Order oder Auth)

• Wenn die initiale Zahlung mit txtype=Order oder Auth ausgeführt wird, sendet Computop Paygate die „BillingAgreementID“ bereits im Notify auf diese Aktion mit zurück. Beim darauffolgenden Capture muss diese nicht mitgegeben werden, nur wenn wirklich ein komplett neues Payment ausgelöst wird.

Löschen der BillingAgreementID

• Grundsätzlich kann ein Kunde die generierte BillingAgreementID in seinem PayPal-Konto löschen/stornieren. Eine Info darüber kann ein Händler nur erhalten, wenn die zusätzliche Option IPN “instant payment notification” für sein Konto aktiviert ist. Diese Aktivierung muss sowohl im Konto bei Computop als auch bei PayPal erfolgen. Bitte beachten Sie, dass der Händler bei aktiviertem IPN auch Meldungen zu jeder Statusänderung einer PayPal-Zahlung erhält.
• Wenn ein Kunde die BillingAgreementID löscht, sind weitere Zahlungen mit dieser ID nicht mehr möglich. Eine gelöschte BillingAgreementID kann nicht mehr aktiviert werden.

Zahlungsabwicklung für Abonnements

Die Abwicklung von PayPal-Zahlungen per Abonnement setzt eine Initial-Transaktion voraus, die über die übliche Schnittstelle abgewickelt worden ist. Zudem muss die Möglichkeit von Abonnements zuvor sowohl bei PayPal als auch bei Computop aktiviert worden sein. Dazu muss die Option „Reference Transaction“ bei Computop und bei PayPal eingerichtet sein. Zudem sind im Bereich „Verfügbare Genehmigungen“ bei der Einrichtung (siehe Kapitel PayPal-API freigeben oben) folgende 3 Optionen zu aktivieren:

- Belasten bestehender Kunden auf der Grundlage früherer Transaktionen
- Erstellen und Verwalten von Abonnementzahlungen
- Einholen der Autorisierung und Initiierung von PayPal-Zahlungen per Händlerabbuchung

Um eine PayPal-Zahlung per Abonnement abzuwickeln, nutzen Sie folgende URL und Parameter:

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter für PayPal-Abonnements

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

Ergebnis-Parameter für PayPal-Abonnements

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,ABO,<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:

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,<Betrag>,<Währung>,<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,ABO,<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