Info	Typ
Die First Cash Solution wickelt PayPal-Zahlungen ab, die Ihnen weltweiten Verkäuferschutz sowie ein Potenzial von 179 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.	Zahlungen per eWallet

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

1.1.1 PayPal Shortcut (früher “Express Chechout Shortcut (ECS)”)

Das 1cs Onlinebezahlsystem 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 1cs Online Bezahlsystem sendet dann die Lieferadresse als Ergebnisparameter an Ihren Shop zurück.

1.1.2 Käufer- und Verkäufer sind geschützt

PayPal bietet Käufern wie auch Händlern einen umfangreichen Käufer- bzw. Verkäuferschutz. So erhalten Käufer die Möglichkeit, bei Nichterfüllung eines Kaufvertrages das Geld über PayPal zurückzuverlangen. Mit Adressverifikation und PayPal-Verkäuferschutz trägt PayPal für die Händler das Zahlungsausfallrisiko bei Lastschriftzahlungen, innerdeutschen Kreditkartenzahlungen und ungerechtfertigten Käuferbeschwerden. Der Verkäuferschutz ist stets an PayPal-Regularien und Bedingungen geknüpft. Das PayPal-Risikomanagement mit Käuferschutz und Adressverifikation steht Ihnen über das 1cs Online Bezahlsystem zur Verfügung.

1.1.3 Weltweit online bezahlen

Besonders nützlich ist PayPal für die Kundenakquise im Ausland. Das 1cs Online Bezahlsystem 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 oft die dort typischen Zahlungsmethoden wie Prepaid-Karten in Italien oder Debit-Karten in Großbritannien nutzen. 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.

1.1.4 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 auch auf der Webseite von PayPal (http://www.paypal.com).

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

Hinweis: Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den 1cs Support, um diese Funktion für Sie zu aktivieren.

1.3 Diagramme zum Prozessablauf

PayPal Prozessablauf

2 Konfiguration für PayPal

2.1 PayPal Sandbox Geschäftskonto

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

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.

2.2 Dem 1cs Online Bezahlsystem API-Berechtigungen erteilen

Damit 1cs Bezahlsystem-Transaktionen in Ihrem Namen verarbeiten darf, bitten wir Sie, die 1cs Online Bezahlsysteme die entsprechenden Berechtigungen zu erteilen.

Berechtigungen können die 1cs Online Bezahlsysteme 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

2.3 PayerID an 1cs Bezahlsystem Merchant Services senden

Um die Händlereinrichtung auf 1cs OBS-Seite abzuschließen, bitten wir Sie, die PayerID an den 1cs Online Bezahlsystem Merchant Services zu senden.

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. Für die Sandbox- und Live Umgebung lautet die PayerID identisch.

3 PayPal Smart Button

3.1 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>

<head>

</head>

<body>

<!– Set up a container element for the button –>

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

<!– Initialize and show PayPal button –>

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

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

3.2 Aktivierung der PayPal-Schaltfläche Später Bezahlen

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

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

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

Im Ergebnis erscheinen folgende zwei Schaltflächen.

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

3.2.1 Parameter intent

Der obige Codeabschnitt enthält die folgende Zeile.

Das 1cs Online Bezahlsystem bietet 3 mögliche Optionen für eine Zahlung.

SALE (wenn das 1cs OBS 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.

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

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

3.3 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/

4 1cs Online Bezahlsystem-Schnittstelle

4.1 Definitionen

4.1.1 Datenformate

Format	Beschreibung
a	alphabetisch
as	alphabetisch mit Sonderzeichen
n	numerisch
an	alphanumerisch
ans	alphanumerisch mit Sonderzeichen
ns	numerisch mit Sonderzeichen
bool	Bool’scher Ausdruck (true oder false)
3	feste Länge mit 3 Stellen/Zeichen
..3	variable Länge mit maximal 3 Stellen/Zeichen
enum	Aufzählung erlaubter Werte
dttm	ISODateTime (JJJJ-MM-TTThh:mm:ss)

4.1.2 Abkürzungen

Abkürzung	Beschreibung	Kommentar
CND	Bedingung (condition)
M	Pflicht (mandatory)	Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein
O	optional	Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich
C	bedingt (conditional)	Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist

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

4.2 Aufruf der Schnittstelle

Um eine PayPal-Zahlung im 1cs Online Bezahlsystem-Formular abzuwickeln, nutzen Sie folgende URL und Parameter:

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

Mit dieser URL unterstützt das 1cs Online Bezahlsystem 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 1cs Online Bezahlsystem unterstützt auch für PayPal Express Checkout das Auseinanderfallen von Autorisierung und Buchung. Sie können über das 1cs Online Bezahlsystem ü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 1cs Online Bezahlsystem 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 1cs Online Bezahlsystem 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 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss.
RefNr			Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
Amount	ns..30	O	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency	a3	M	Währungskürzel, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
Capture	a..6	O	Auto oder Manual: bestimmt, ob der angefragte Betrag sofort oder erst später abgebucht wird. Wichtiger Hinweis: Bitte kontaktieren Sie den First Cash Solution Support für Manual, um die unterschiedlichen Einsatzmöglichkeiten abzuklären.
TxType	ans..5	C	Pflicht bei Capture=Manual: Transaktionstyp mit den möglichen Werten Order oder Auth
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 zünftige Verwendungen reserviert.
OrderDesc	ans..127	M	Beschreibung der gekauften Waren, Einzelpreise usw.
OrderDesc(n)	ans..2048	O	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 1cs Online Bezahlsystem-Parameter Amount übereinstimmen.
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.
URLSuccess	ans..256	M	Vollständige URL, die das 1cs Online Bezahlsystem aufruft, wenn die Zahlung erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise: Wir empfehlen, den Parameter “response=encrypt” zu verwenden, um eine verschlüsselte Antwort von 1cs OBS 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.
URLFailure	ans..256	M	Vollständige URL, die das 1cs Online Bezahlsystem aufruft, wenn die Zahlung gescheitert ist. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise: Wir empfehlen, den Parameter “response=encrypt” zu verwenden, um eine verschlüsselte Antwort von 1cs OBS 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.
Response	a7	O	Die Status-Rückmeldung, die das 1cs Online Bezahlsystem an URLSuccess und URLFailure sendet, sollte verschlüsselt werden. Dazu übergeben Sie den Parameter Response=encrypt.
URLNotify	ans..256	M	Vollständige URL, die das 1cs Online Bezahlsystem 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. Allgemeine Hinweise: Wir empfehlen, den Parameter “response=encrypt” zu verwenden, um eine verschlüsselte Antwort von 1cs OBS 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.
UserData	ans..1024	O	Wenn beim Aufruf angegeben, übergibt das 1cs Online Bezahlsystem die Parameter mit dem Zahlungsergebnis an den Shop
ReqID	ans..32	O	Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs Online Bezahlsystem keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs Online Bezahlsystem gelöscht.
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.
LandingPage	ans..	O	Steuert, wie die PayPal-Seite angezeigt wird. Mögliche Werte „Login“ oder „Billing“
Language	an2	O	AU, DE, FR, IT, GB, ES, US; Standard DE
FirstName	ans..50	OC	(Pflicht für USA und Kanada): Entweder nur der Vorname oder Vor- und Nachname, falls ein Firmenname als Lieferadresse verwendet wird.
LastName	ans..50	OC	(Pflicht für USA und Kanada): Nachname oder Firmenbezeichnung der Lieferadresse
AddrStreet	ans..100	OC	(Pflicht für USA und Kanada): Straßenname 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 1cs Support aktiviert werden.
AddrCity	ans..40	OC	(Pflicht für USA und Kanada): Ort der Lieferadresse
AddrState	ans..40	OC	(Pflicht für USA und Kanada): Bundesstaat der Lieferadresse. er 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 der Lieferadresse
AddrCountryCode	an2	O	Ländercode des Lieferlandes
Phone	n..20	O	Telefonnummer
NoShipping	n1	O	Die Übergabe von NoShipping=1 verhindert, dass die bei Paypal hinterlegte Lieferadresse angezeigt wird

Parameter für PayPal-Zahlungen

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

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

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

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird.
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Order, Sale, Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Status	a..50	M	OK, AUTHORIZE_REQUEST oder Timeout (nur bei Capture=Manual) auf der URLSuccess-Seite oder FAILED auf der URLFailure-Seite. AUTHORIZE_REQUEST – Wird nur beim Aufrufparameter “TxType=auth” bzw. “PayPalMethod=shortcut” aktiv versendet. Bei Verwendung von TxType=auth oder ohne TxType wird direkt der finale Status zurückgegeben. Timeout – Alle offenen Zahlungsvorgänge im Status AUTHORIZE_REQUEST werden nach ~ 3h automatisiert geschlossen und als Timeout gemeldet.
Description	ans..1024	M	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Code	n8	M	Fehlercode gemäß Excel-Datei 1cs Online Bezahlsystem Antwort Codes
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
RefNr	ns..30	O	Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
UserData	ans..1024	O	Wenn beim Aufruf angegeben, übergibt das 1cs Online Bezahlsystem die Parameter mit dem Zahlungsergebnis an den Shop
CodeExt	n..10	O	Fehlercode von PayPal, wenn mit dem First Cash Solution Support abgesprochen
Name	ans..32	M	Vorname und Nachname zusammen
FirstName	ans..50	M	Vorname vom Bezahler (PayerInfo, kann vom Account-Namen abweichen)
LastName	ans..50	M	Nachname vom Bezahler (PayerInfo, kann vom Account-Namen abweichen)
E-Mail	ans..100	M	E-Mail-Adresse des Käufers.
AddrStreet	ans..100	O	Straßenname der Lieferadresse
AddrStreet2	ans..100	O	2. Straßenname der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat von der First Cash Solution aktiviert werden.
AddrCity	ans..40	O	Ortsname der Lieferadresse
AddrState	ans..40	O	Bundesstaat der Lieferadresse
AddrZIP	ans..20	O	Postleitzahl der Lieferadresse
AddrCountryCode	an2	O	Ländercode des Lieferlandes
Phone	n..20	O	Telefonnummer
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 1cs OBS Helpdesk aktiviert werden.
BillingAddrCity	ans..40	O	Ortsname der bei PayPal hinterlegten Rechnungsadresse
BillingAddrState	ans..40	O	Bundesstaat der bei PayPal hinterlegten Rechnungsadresse
BillingAddrZIP	ans..20	O	Postleitzahl der bei PayPal hinterlegten Rechnungsadresse
BillingAddrCountryCode	an2	O	Ländercode des Lieferlandes
payerStatus	an..10	O	Status des Käufers mit den möglichen Werten “verified” oder “unverified”
InfoText	ans..255	M	Nachricht an den Händler
PayerID	ans..13	O	(Falls Antwort aktiviert ist): Eindeutige Identifikationsnummer des Kundenkontos bei PayPal.
GrossAmount	an..9	O	Abgerechneter Endbetrag, einschließlich Versandkosten und Steuern aus Ihrem Händlerprofil
FeeAmount	an..9	O	Für die Transaktion berechneten Betrag der PayPal-Gebühr
SettleAmount	an..9	O	Ihrem PayPal-Konto nach einer Währungsumrechnung eingezahlter Betrag
TaxAmount	an..9	O	Für 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 separatem Notify von PayPal: Transaktionsgebühr für die 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.

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.

4.3 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 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Amount	n..10	M	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs OBS, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency	a3	M	Währungskürzel, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung. Übergeben Sie hier die PayID aus der Antwort von paypal.aspx im bisherigen Transaktionsablauf erhalten haben.
RefNr	ns..30	O	Eindeutige Referenznummer Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
Adressinformationen. Durch Übergabe dieser Werte ist auch eine Adress-Änderung möglich. Hinweis: Wenn FirstName übergeben wird, sollten auch alle anderen Werte übergeben werden. Wenn FirstName nicht übergeben wird, werden andere Adressparameter nicht berücksichtigt.
FirstName	ans..50	C	Pflicht, um Adressangaben zu übermitteln: Entweder nur der Vorname oder Vor- und Nachname, falls ein Firmenname als Lieferadresse genutzt wird.
LastName	ans..50	C	Pflicht, wenn FirstName übergeben wird: Nachname oder Firmenbezeichnung der Lieferadresse
AddrStreet	ans..100	C	Pflicht, wenn FirstName übergeben wird: Straßenname der Lieferadresse
AddrStreet2	ans..100	C	Pflicht, wenn FirstName übergeben wird: 2. Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vom 1cs Support 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 Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

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

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

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird.
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Status	a..50	M	OK (URLSuccess) oder FAILED (URLFailure)
Description	ans..1024	M	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Code	n8	M	Fehlercode gemäß 1cs Online Bezahlsystem Antwort Codes (Fehlercodes)
RefNr	ns..30	O	Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
CodeExt	n..10	O	Fehlercode von PayPal, wenn mit dem First Cash Solution Support abgesprochen

Ergebnis-Parameter bei PayPal mit Methode “shortcut”

4.4 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 rufen Sie folgende URL auf:

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

nweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	an32	M	vom 1cs Online Bezahlsystem vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Amount	n..10	M	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency	a3	M	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/
TxType	ans..5	M	Transaktionstyp Auth
FirstName	ans..50	O	Entweder nur der Vorname oder Vor- und Nachname, falls ein Firmenname als Lieferadresse genutzt wird.
LastName	ans..50	O	Nachname oder Firmenname der Lieferadresse
AddrStreet	ans..100	O	Straßenname 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 von der First Cash Solution aktiviert werden.
AddrCity	ans..40	O	Ort der Lieferadresse
AddrState	ans..40	O	Bundesstaat der Lieferadresse. Die in AddrCity übergebene Stadt muss im angegebenen Bundesstaat liegen, sonst lehnt 1cs OBS die Zahlung ab. Mögliche Werte entnehmen Sie bitte der PayPal-API-Reference Dokumentation.
AddrZip	ans..20	O	Postleitzahl der Lieferadresse
AddrCountryCode	an2	O	Ländercode des Lieferlandes
Phone	n..20	O	Telefonnummer

Parameter für PayPal-Autorisierung

Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

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

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

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird.
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Status	a..50	M	OK (URLSuccess) oder FAILED (URLFailure)
Description	ans..1024	M	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Code	n8	M	Fehlercode gemäß Excel-Datei 1cs Online Bezahlsystem Antwort Codes (Fehlercodes)
CodeExt	n..10	O	Fehlercode von PayPal, wenn mit dem First Cash Solution Support abgesprochen

Ergebnis-Parameter bei PayPal-Autorisierung

4.5 Aufruf der Schnittstelle für eine Buchung

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

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Amount	n..10	M	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency	a..3	M	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
ReqId	ans..32	O	Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion / Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs OBS keine Zahlung / weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion / Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs OBS gelöscht.
RefNr	ans..30	O	Referenznummer des Händlers: hier kann eine separate Referenznummer wie z.B. Rechnungsnummer übergeben werden Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
TID	ans..17	O	Eindeutige PayPal Capture ID.
CompleteType	ans..3	O	Wird <YES> übergeben, wird bei der Buchung die mögliche offene Order von PayPal geschlossen. (Hintergrund: seitens PayPal ist eine 115% Buchung zulässig. Bei Buchung ab 100% sendet das 1cs Online Bezahlsystem automatisch einen Aufruf zum Schließen der Zahlung an PayPal.)

Parameter für PayPal-Buchungen

Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

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

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

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Status	a..50	M	OK (URLSuccess) oder FAILED (URLFailure)
Description	ans..1024	M	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Code	n8	M	Fehlercode gemäß 1cs Online Bezahlsystem Antwort Codes (Fehlercodes)
CodeExt	n..10	O	Fehlercode von PayPal, wenn mit dem First Cash Solution Support abgesprochen

Ergebnis-Parameter für PayPal-Buchungen

4.6 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 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die gutzuschreibende Zahlung.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Amount	n..10	M	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency	a3	M	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
ReqId	ans..32	O	Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion / Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs OBS keine Zahlung / weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion / Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs OBS gelöscht.
RefNr	ans..30	O	Referenznummer des Händlers: hier kann eine separate Referenznummer wie z.B. Rechnungsnummer übergeben werden Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
TID	ans..17	O	Eindeutige PayPal Capture ID
Note	ans..768	C	Erklärungstext für den Empfänger
Subject	ans..255	C	MassPay: Betreff für E-Mail an Empfänger Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den 1cs Support, um diese Funktion für Sie zu aktivieren.

Parameter für PayPal-Gutschriften mit Bezugstransaktion

Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

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

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

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Status	a..50	M	OK (URLSuccess) oder FAILED (URLFailure)
Description	ans..1024	M	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Code	n8	M	Fehlercode gemäß Excel-Datei 1cs Online Bezahlsystem Antwort Codes
CodeExt	n..10	O	Fehlercode von PayPal, wenn mit dem First Cash Solution Support 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

4.7 Aufruf der Schnittstelle für nicht referenzierte Gutschriften

Um eine Gutschrift ohne Bezugstransaktion für PayPal abzuwickeln, nutzen Sie folgende URL und Parameter:
https://www.computop-paygate.com/paypalcreditEx.aspx

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransID	ans..64	M	TransaktionsID, die für jede Zahlung eindeutig sein muss
Amount	n..10	M	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency	a3	M	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
ReqID	ans..32	O	Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion / Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs OBS keine Zahlung / weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion / Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs OBS gelöscht.
RefNr	ns..30	O	Eindeutige Referenznummer des Händlers. Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
PayerID	ans..13	O	Eindeutige Identifikationsnummer des Kundenkontos bei PayPal
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
Note	ans..768	C	MassPay: Hinweistext für Empfänger Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den 1cs Support, um diese Funktion für Sie zu aktivieren.
Subject	ans..255	C	MassPay: Betreff für E-Mail an Empfänger Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den 1cs Support, um diese Funktion für Sie zu aktivieren.
Payer	ans..100	O	MassPay: E-Mail-Adresse des Käufers Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den 1cs Support, um diese Funktion für Sie zu aktivieren.

Parameter für PayPal-Gutschriften ohne Bezugstransaktion

Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

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

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

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Status	a..50	M	OK (URLSuccess) oder FAILED (URLFailure)
Description	ans..1024	M	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Code	n8	M	Fehlercode gemäß Excel-Datei 1cs Online Bezahlsystem Antwort Codes
CodeExt	n..10	O	Fehlercode von PayPal, wenn mit dem First Cash Solution Support 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 ohne Bezugstransaktion

4.8 Aufruf der Schnittstelle für Stornierungen

Um eine Transaktion bei PayPal zu stornieren, nutzen Sie folgende URL und Parameter:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die zu stornierende Zahlung
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Amount	n..10	M	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent) Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency	a..3	M	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
ReqId	ans..32	O	Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion / Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs OBS keine Zahlung / weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion / Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs Online Bezahlsystem gelöscht.

Parameter für PayPal-Stornierungen

Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

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

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

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Status	a..50	M	OK (URLSuccess) oder FAILED (URLFailure)
Description	ans..1024	M	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Code	n8	M	Fehlercode gemäß Excel-Datei 1cs Online Bezahlsystem Antwort Codes (Fehlercodes)
CodeExt	n..10	O	Fehlercode von PayPal, wenn mit dem First Cash Solution Support abgesprochen

Ergebnis-Parameter für PayPal-Stornierungen

4.9 Referenztransaktionen

Voraussetzungen

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

Prozess

Der Prozess umfasst zwei Schritte.

Einrichten einer Abrechnungsvereinbarung (Anfangstransaktion der Abrechnungsvereinbarung)

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

Nutzung der Abrechnungsvereinbarung

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

Widerruf der Abrechnungsvereinbarung

Ein Kunde kann die Billing Agreement ID in seinem eigenen PayPal-Konto widerrufen. Der Händler kann nur dann über die Kündigung informiert werden, wenn für das Händlerkonto die Zusatzoption IPN „Sofortzahlungsbenachrichtigung“ aktiviert ist. Die Freischaltung muss über den 1cs OBS Helpdesk erfolgen. Bitte beachten Sie, dass der Händler nach der IPN-Aktivierung Benachrichtigungen über jede Statusänderung einer PayPal-Zahlung erhält.
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:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die vom 1cs Online Bezahlsystem vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Amount	n..10	M	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs OBS Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency	a3	M	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
RefNr	ns..30	O	Eindeutige Referenznummer des Händlers
Order Desc	ans..30	O	Beschreibung der gekauften Waren, Einzelpreise usw.
BillingAgreementID	an19	M	Identifikationsnummer der Rechnungsvereinbarung. Wenn der Käufer die Rechnungsvereinbarung bestätigt, wird diese validiert und bleibt gültig, bis sie vom Käufer widerrufen wird.

Parameter für PayPal-Referenztransaktionen

Antwort

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

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

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

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die vom 1cs Online Bezahlsystem vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Status	a..50	M	OK (URLSuccess) oder FAILED (URLFailure)
Description	ans..1024	M	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!
Code	n8	M	Fehlercode gemäß 1cs OBS Antwort-Codes (A4 Fehlercodes)
CodeExt	n..10	O	Fehlercode von PayPal, wenn mit dem 1cs OBS Helpdesk abgesprochen
RefNr	ns..30	O	Eindeutige Referenznummer des Händlers
OrderID	ans..17	O	Eindeutige, von PayPal generierte OrderID
TID	ans..17	O	Eindeutige, von PayPal generierte CaptureID
Name	ans..32	O	Vor- 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-Mail	ans100	O	E-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

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

Aktion	Version	Beschreibung
Authorize	1.0 / 2.0	Standardversion ohne Rückgabe von Code
	1.4 / 2.4	mit TID
Capture	1.0 / 2.0	Standardversion ohne Rückgabe von 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 Code
	1.x / 2.x	mit RefNr (gilt für alle Versionen außer 1.0)
	1.4 / 2.4	mit TID
CreditEx	1.0 / 2.0	Standardversion ohne Rückgabe von 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 Code
	1.4 / 2.4	mit TID
Abo	1.0 / 2.0	Standardversion ohne Rückgabe von 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>) 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 1cs OBS Support) Reverse (Storno) Abo (Abonnement)
Amount	n..10	M	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency	a3	M	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
RefNr	ns..30	O	Eindeutige Referenznummer Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
payer	ans..100	O	MassPay: E-Mail-Adresse des Käufers: Übergeben Sie hier den erhaltenen Parameter E-Mail aus der Antwort. Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den 1cs Support, um diese Funktion für Sie zu aktivieren.
note	ans..758	O	Erläuterungstext für den Empfänger
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für diese Transaktion
TID	ans..17	O	Eindeutige Transaktionsnummer bei PayPal. Notwendig bei mehreren Autorisierungen oder Teilbuchungen, Teilgutschriften, Teilstornierungen.
OrderDesc	ans..127	O	Beschreibung der gekauften Waren, Einzelpreise etc.
Capture	a..6	O	Auto oder Manual: bestimmt, ob der angefragte Betrag sofort oder zzu einem späteren Zeitpunkt abgerechnet wird.
TxType	ans..5	OC	Pflicht bei Capture=Manual: Transaktionstyp mit den möglichen Werten Order sowie Auth

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>

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.
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für diese Transaktion
Status	a..50	M	OK (URLSuccess) oder FAILED (URLFailure)
Code	n8	M	Fehlercode gemäß 1cs Online Bezahlsystem Antwort Codes. (Fehlercodes)
CodeExt	n..10	O	Fehlercode von PayPal, wenn mit 1cs OBS Support abgesprochen

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien

Name	Anbieter	Zweck	Ablauf
cookie_status	www.firstcashsolution.de	Speichert Ihren Zustimmungsstatus für Cookies auf der aktuellen Domäne.	1 Jahr
pll_language	www.firstcashsolution.de	Speichert Ihre Spracheinstellungen.	1 Jahr
PHPSESSID	www.firstcashsolution.de	In diesem Cookie wird die Session-ID, also eine zufällig generierte Identifikationsnummer für Ihre Sitzung, gespeichert. Dieser Cookie wird – abhängig von Ihrer Browser-Einstellung – beim Schließen eines Tabs oder Fensters, das diesen Cookie gesetzt hat, gelöscht. Dadurch ist es zum Beispiel möglich, zuvor bereits ausgefüllte Felder eines Formulars vom Browser automatisch eintragen zu lassen.	Session
wordpress_test_cookie	www.firstcashsolution.de	Prüft ob Cookies gesetzt werden können	1 Jahr
pum-*	www.firstcashsolution.de	Speichert die Information welches PopUp geschlossen wurde	1 Monat