PayPal Classic API. Die Implementierung wird nur für bestehende Händler und die Händler unterstützt, die Hosted Payment Page (HPP) oder Shop Extensions verwenden.

Über PayPal

Allgemeines zu PayPal

PayPal ist eines der weltweit führenden eWallets für E- und M-Commerce. Etwa 179 Millionen aktive Mitglieder in über 200 Ländern begleichen mittels PayPal ihre Online-Bestellungen. In Deutschland können Kunden per Lastschrift, giropay oder Kreditkarte (American Express, Diners Club, Discover, MasterCard, Visa) bezahlen. PayPal PLUS bietet zudem neben den genannten Zahlarten den Kauf u.a. auf Rechnung. Mitglieder können sich während eines Checkouts mit ihrer E-Mail-Adresse und einem Passwort an ihrem PayPal-Konto anmelden und die gewünschte Zahlungsart (Lastschrift, PayPal-Guthaben, Kreditkarte und ggf. Rechnungskauf) auswählen. Der zu zahlende Betrag wird Ihnen unmittelbar im eigenen PayPal-Konto gutgeschrieben. Die ansonsten üblichen Banklaufzeiten von Überweisungen oder die Verzögerung bei der Ausschüttung von Collecting-Services entfallen. Dies ermöglicht eine Echtzeit-Zahlungsabwicklung im Internet.

PayPal Express Checkout

Für verkürzte Bestellungen bietet das Computop Paygate den PayPal Express Checkout an: Ihr Kunde muss keine Adressdaten eingeben, sondern klickt schon im Warenkorb auf Checkout mit PayPal, meldet sich dort an und wählt seine Rechnungs- und Lieferadresse bei PayPal aus. Das Paygate gibt dann die Lieferadresse als Ergebnisparameter an Ihren Shop zurück.

Käufer- und Verkäuferschutz inbegriffen

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 Computop Paygate zur Verfügung.

Weltweit online bezahlen

Besonders nützlich ist PayPal 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 oft die dort typischen Zahlungsmethoden wie Prepaid-Karten in Italien oder Debit-Karten in Großbritannien nutzen. Durch die Einbindung von PayPal in Ihren Shop stehen Ihren Kunden deshalb gleich mehrere Zahlungsmethoden zur Verfügung.

Logo
Info	Computop 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.
Typ	Zahlungen per eWallet

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

Diagramme zum Prozessablauf

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6Ijg3NTIzODE3IiwiZGlhZ3JhbU5hbWUiOiJQYXlwYWwgUGF5bWVudCBDVCIsImFzcGVjdCI6IiIsImxpbmtzIjoiYXV0byIsImNlb05hbWUiOiJQYXlQYWwiLCJ0YnN0eWxlIjoidG9wIiwiY2FuQ29tbWVudCI6ZmFsc2UsImRpYWdyYW1VcmwiOiIiLCJjc3ZGaWxlVXJsIjoiIiwiYm9yZGVyIjp0cnVlLCJtYXhTY2FsZSI6IjEiLCJvd25pbmdQYWdlSWQiOjI2MjQ3MzcyLCJlZGl0YWJsZSI6ZmFsc2UsImNlb0lkIjoyNjI0NzM3MiwicGFnZUlkIjoiIiwibGJveCI6dHJ1ZSwic2VydmVyQ29uZmlnIjp7ImVtYWlscHJldmlldyI6IjEifSwib2RyaXZlSWQiOiIiLCJyZXZpc2lvbiI6MCwibWFjcm9JZCI6IjI0MjFlY2JkLTRlODAtNDc4My1hMjFmLTYyYjI1YzhlYzgwMiIsInByZXZpZXdOYW1lIjoiUGF5cGFsIFBheW1lbnQgQ1QucG5nIiwibGljZW5zZVN0YXR1cyI6Ik9LIiwic2VydmljZSI6IiIsImlzVGVtcGxhdGUiOiIiLCJ3aWR0aCI6IjExMDkiLCJzaW1wbGVWaWV3ZXIiOmZhbHNlLCJsYXN0TW9kaWZpZWQiOiJNYXIgMjMsIDIwMjMsIDE6NTg6MTkgUE0iLCJleGNlZWRQYWdlV2lkdGgiOmZhbHNlLCJvQ2xpZW50SWQiOiIifQ==

Wichtige Hinweise

Bitte beachten Sie, dass entgegen der Darstellung in unserer Währungstabelle die Währungen HUF (Ungarn - Forint) 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.

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

Auf dieser Seite

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

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

Wählen Sie im Menü „Mein Profil“ die „Kontoeinstellungen“ aus
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.
Klicken Sie dann bitte auf den Link „API-Genehmigung erteilen“
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
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
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.

Auf https://developer.paypal.com finden Sie unter "Accounts" --> (Accountname) --> "Manage accounts" --> "View/ edit account" die Zugangsdaten des jeweiligen Händlerkontos.
Mit diesen Zugangsdaten melden Sie sich unter https://sandbox.paypal.com an.
Klicken Sie oben rechts auf den Namen und gehen zu den "Kontoeinstellungen".
Klicken Sie auf "API-Zugriff" --> "API-Genehmigung erteilen" --> Tragen Sie "test_paypal_api_api1.computop.com" ein.
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

Im Menü wählen Sie „Mein Profil“ aus und klicken auf „Kontoeinstellungen“.
Bitte wählen Sie hier unter „Verkäufer/Händler“ den Punkt „Zahlungen sperren“ über den Link „Aktualisieren“ aus.
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

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)

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.

Aufruf der Schnittstelle

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

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

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

Key	Format	CND	Description	Beschreibung
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
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).	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits 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/.	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key Format CND Description Beschreibung
refnr
ans..30
O
Merchant’s unique reference number
Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
Capture	a..6	O	Auto or Manual: determines whether the requested amount is settled immediately or at a later stage. Important Note: Please contact Computop Helpdesk for Manual, to discuss different possibilities of usage.	Auto oder Manual: bestimmt, ob der angefragte Betrag sofort oder erst später abgebucht wird. Wichtiger Hinweis: Bitte kontaktieren Sie den Computop Helpdesk für Manual, um die unterschiedlichen Einsatzmöglichkeiten abzuklären.
TxType	ans..5	C	Obligatory for Capture=Manual: Transaction type with possible values Order or Auth and BAID (BillingAgreementID)	Pflicht bei Capture=Manual: Transaktionstyp mit den möglichen Werten Order oder Auth sowie BAID (BillingAgreementID)
PayPalMethod	enum	O	The "shortcut" value selects the changed transaction procedure which takes the customer back to the shop for payment confirmation. You then need to call up the interface paypalcomplete.aspx to complete the sale.	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	For repeat payments (subscriptions): I = Initial payment of a new subscription R = Routine payment (Recurring) In this case only RTF=I is allowed, other subscription payments are carried out via the separate paypalAbo.aspx interface.	Für wiederkehrende Zahlungen (Abos): I = Initialzahlung eines neuen Abos, R = Wiederkehrende Zahlung (Recurring) Hier nur RTF=I zulässig, weitere Abo-Zahlungen werden über die separate Schnittstelle paypalAbo.aspx ausgeführt.
OrderDesc	ans..127	M	Description of purchased goods, unit prices etc. If OrderDesc(n) is used, there must be valid: Amount=ItemTotal+TaxTotal+SHAmount	Beschreibung der gekauften Waren, Einzelpreise etc. Wenn OrderDesc(n) verwendet wird, muss gelten: Amount=ItemTotal+TaxTotal+ShAmount
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.	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.
TaxTotal	n..10	C	Mandatory, if +Tax is given in description of OrderDesc(n): Total amount of taxes of all single articles in the smallest currency unit (e.g. EUR Cent) = Sum(Tax*Number)	Pflicht, wenn bei OrderDesc(n) die Beschreibung +Tax angegeben wird. Gesamtbetrag der Steuern aller einzelnen Artikel in der kleinsten Währungseinheit (z.B. EUR Cent) = Summe(Tax*Number)
ItemTotal	n..10	C	Mandatory, if +tax is given in description of OrderDesc(n): Gross amount of all single articles in the smallest currency unit (e.g. EUR Cent) = Sum(Amount*Number)	Pflicht, wenn bei OrderDesc(n) die Beschreibung +Tax angegeben wird. Gesamtbetrag der einzelnen Artikel in der kleinsten Währungseinheit (z.B. EUR Cent) = Summe(Amount*Number)
ShAmount	n..10	O	Shipping costs in the smallest currency unit (e.g. EUR Cent). Can be uses only in connection with parameters ItemTotal and TaxTotal.	Versandkosten in der kleinsten Währungseinheit (z.B. EUR Cent). Kann nur in Verbindung mit den Parametern ItemTotal und TaxTotal verwendet werden.

Key	Format	CND	Description	Beschreibung
ReqId	ans..32	O	To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action. Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly. Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.	Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Key	Format	CND	Description	Beschreibung
URLSuccess	ans..256	M	Complete URL which calls up Paygate if payment has been successful. The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values between Paygate and shop, please use the parameter UserData. Common notes: We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.	Vollständige URL, die das Paygate aufruft, wenn die Zahlung erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise: Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von Paygate zu erhalten Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Key	Format	CND	Description	Beschreibung
URLFailure	ans..256	M	Complete URL which calls up Paygate if payment has been unsuccessful. The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values between Paygate and shop, please use the parameter UserData. Common notes: We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.	Vollständige URL, die das Paygateaufruft, 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 Paygate zu erhalten Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Key	Format	CND	Description	Beschreibung
Response	a7	O	Status response sent by Paygate to URLSuccess and URLFailure, should be encrypted. For this purpose, transmit Response=encrypt parameter.	Die Status-Rückmeldung, die das Paygate an URLSuccess und URLFailure sendet, sollte verschlüsselt werden. Dazu übergeben Sie den Parameter Response=encrypt.

Key	Format	CND	Description	Beschreibung
URLNotify	ans..256	M	Complete URL which Paygate calls up in order to notify the shop about the payment result. The URL may be called up only via port 443. It may not contain parameters: Use the UserData parameter instead. Common notes: Fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.	Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise: Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Key	Format	CND	Description	Beschreibung
UserData	ans..1024	O	If specified at request, Paygate forwards the parameter with the payment result to the shop.	Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

Key	Format	CND	Description	Beschreibung
Account	ans..128	O	For managing multiple PayPal accounts, Merchant account: ID or e-Mail address for which the request should be submitted to PayPal	Zur Steuerung mehrerer PayPal-Accounts, Händler-Account: ID oder E-Mail-Adresse, für die die Anfrage an PayPal gesendet werden soll
LandingPage	ans	O	Controls how the PayPal page is displayed. Possible values are “Login” or “Billing”	Steuert, wie die PayPal-Seite angezeigt wird. Mögliche Werte „Login“ oder „Billing“
Language	an2	O	AU, DE, FR, IT, GB, ES, US ; default DE	AU, DE, FR, IT, GB, ES, US; Standard DE
FirstName	ans..50	OC	(obligatory for USA and Canada): Either the first name only or first and second name if a company name is used as a delivery address.	(Pflicht für USA und Kanada): Entweder nur der Vorname oder Vor- und Nachname, falls ein Firmenname als Lieferadresse genutzt wird.
LastName	ans..50	OC	(obligatory for USA and Canada): Surname or name of the company of the delivery address	(Pflicht für USA und Kanada): Nachname oder Firmenbezeichnung der Lieferadresse
AddrStreet	ans..100	OC	(obligatory for USA and Canada): Street in the delivery address	(Pflicht für USA und Kanada): Straßenname der Lieferadresse
AddrStreet2	ans..100	O	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.	2. Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vom Computop Helpdesk aktiviert werden.
AddrCity	ans..40	OC	(obligatory for USA and Canada): Town/city in the delivery address	(Pflicht für USA und Kanada): Ortsname der Lieferadresse
AddrState	ans..40	OC	(obligatory for USA and Canada): 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 für USA und Kanada): 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	OC	(obligatory for USA and Canada): Postcode in the delivery address	(Pflicht für USA und Kanada): Postleitzahl der Lieferadresse
AddrCountryCode	an2	O	Country code of the delivery country	Ländercode des Lieferlandes
Phone	n..20	O	Telephone number	Telefonnummer
NoShipping	n1	O	Handover NoShipping=1 prevents the delivery address registered with Paypal from being displayed. Computop Paygate also offers the option to permanently suppress the delivery address for you on your MID. Please note that the delivery address should only be suppressed in the case of digital goods, as the seller protection is also linked to this. Please contact the Computop Helpdesk for this.	Übergabe NoShipping=1 verhindert die Anzeige der bei PayPal hinterlegten Lieferadresse. Zusätzlich bietet das Computop Paygate die Variante an, dass wir an Ihrer MID die Unterdrückung der Adresse fest für Sie hinterlegen. Bitte beachten Sie, dass die Lieferadresse nur im Fall digitaler Güter unterdrückt werden sollte, da daran auch der Verkäuferschutz geknüpft ist. Bitte wenden Sie sich dafür an den Computop Helpdesk.
AllowNote	ans..2	O	The value “no” prevents the option of sending a message to the merchant. As standard a possible message is returned in the Infotext parameter.	Wert „no“ verhindert die Möglichkeit, eine Nachricht an den Händler zu übermitteln. Standardmäßig wird eine eventuelle Mitteilung im Parameter Infotext zurückgegeben.
BuyerEMail	ans..127	OC	Pre-completion of an email address on the PayPal login page	Vorbelegung einer E-Mail-Adresse auf der Login-Seite von PayPal
NoteToBuyer	ans..165	O	Notice for the buyer	Hinweistext für den Käufer

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

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

Key Format CND Description Beschreibung
mid
ans..30
M
MerchantID, assigned by Computop
HändlerID, die von Computop vergeben wird

Key Format CND Description Beschreibung
PayID
an32
M
ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.
Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key Format CND Description Beschreibung
XID
an32
M
ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate
Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key Format CND Description Beschreibung
TransID
ans..64
M TransactionID provided by you which should be unique for each payment Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key

Format

CND

Description

Beschreibung

Status

a..30

M

OK, AUTHORIZE_REQUEST or Timeout (only if Capture=Manual) on the URLSuccess page or FAILED on the URLFailure page.

AUTHORIZE_REQUEST – Is returned actively only for request parameter "TxType=auth" or "PayPalMethod=shortcut". When using TxType=auth or without TxType the final status is returned directly.
Timeout – All open payments with status AUTHORIZE_REQUEST will be closed ~ 3hours later automatically and are reported as Timeout.

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 abschließende Status gemeldet.
Timeout – Alle offenen Zahlungsvorgänge im Status AUTHORIZE_REQUEST werden nach ~ 3h automatisiert geschlossen und als Timeout gemeldet.

Key Format CND Description Beschreibung
Description
ans..1024
M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Key Format CND Description Beschreibung
Code
an8
M
Error code according to Paygate Response Codes (A4 Error codes)
Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key Format CND Description Beschreibung
MAC
an64
M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
HMAC Authentication (Request)
HMAC Authentication (Notify)
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:
HMAC-Authentisierung (Anfrage)
HMAC-Authentisierung (Notify)

Key Format CND Description Beschreibung
refnr
ans..30
O
Merchant’s unique reference number
Eindeutige Referenznummer des Händlers

Key Format CND Description Beschreibung
UserData
ans..1024
O
If specified at request, Paygate forwards the parameter with the payment result to the shop.
Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

Key Format CND Description Beschreibung
CodeExt
n..10
O
Error code from external partner. Needs to be agreed with Computop Helpdesk.
Fehlercode des externen Partners, wenn mit dem Computop Helpdesk abgesprochen.

Key	Format	CND	Description	Beschreibung
Name	ans..32	M	First name and surname joined	Vorname und Nachname zusammengenommen
Firstname	ans..50	M	First name of payer (PayerInfo, may differ from the account name)	Vorname vom Bezahler (PayerInfo, kann vom Account-Namen abweichen)
Lastname	ans..50	M	Last name of payer (PayerInfo, may differ from the account name)	Nachname vom Bezahler (PayerInfo, kann vom Account-Namen abweichen)
E-Mail	ans..100	M	Email address of the purchaser.	E-Mail-Adresse des Käufers.
AddrStreet	ans..100	O	Street in the delivery address	Straßenname der Lieferadresse
AddrStreet2	ans..100	O	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.	2. Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vom Computop Helpdesk aktiviert werden.
AddrCity	ans..40	O	Town/city in the delivery address	Ortsname der Lieferadresse
AddrState	ans..40	O	Federal State in the delivery address	Bundesland (Bundesstaat) der Lieferadresse
AddrZIP	ans..20	O	Postcode in the delivery address	Postleitzahl der Lieferadresse
AddrCountryCode	an2	O	Country code of the delivery country	Ländercode des Lieferlandes
Phone	n..20	O	Telephone number	Telefonnummer
BillingAgreementID	an19	M	Identification number of the invoice agreement. When the buyer confirms the invoice agreement it is validated and remains valid until revoked by the buyer.	Identifikationsnummer der Rechnungsvereinbarung. Wenn der Käufer die Rechnungsvereinbarung bestätigt, wird sie gültig und bleibt gültig, bis sie vom Käufer widerrufen wird.
BillingName	ans..32	O	First name and surname joined	Vorname und Nachname zusammengenommen
BillingAddrStreet	ans..100	O	Street name of the invoicing address lodged with PayPal	Straßenname der bei PayPal hinterlegten Rechnungsadresse
BillingAddrStreet2	ans..100	O	2. Street name of the invoicing address lodged with PayPal 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.	2. Straßenname der bei PayPal hinterlegten Rechnungsadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vom Computop Helpdesk aktiviert werden.
BillingAddrCity	ans..40	O	Town/city name of the invoicing address saved with PayPal	Ortsname der bei PayPal hinterlegten Rechnungsadresse
BillingAddrState	ans..40	O	Federal state of the invoicing address saved with PayPal	Bundesland der bei PayPal hinterlegten Rechnungsadresse
BillingAddrZIP	ans..20	O	Postcode of the invoicing address saved with PayPal	Postleitzahl der bei PayPal hinterlegten Rechnungsadresse
BillingAddrCountryCode	an2	O	Country code of the delivery country	Ländercode des Lieferlandes
TransactionID	an..19	O	Unique transaction number from PayPal for a transaction (PayPal Order)	Eindeutige Transaktionsnummer von PayPal für eine Transaktion (PayPal Order)
TID	an..19	O	Unique transaction number from PayPal for an authorisation (PayPal Auth): Only for automatic PayPal configuration or if TxType=Auth	Eindeutige Transaktionsnummer von PayPal für eine Autorisierung (PayPal Auth): Nur bei automatischer PayPal-Konfiguration oder sonst wenn TxType=Auth
payerStatus	an..10	O	Status of buyer with possible values "verified" or "unverified"	Status des Käufers mit den möglichen Werten "verified" oder "unverified"
InfoText	ans..255	M	Message to the merchant	Nachricht an den Händler
PayerID	ans..13	O	Unique identification number of customer account at PayPal. (Additional response has to be first activated. Please contact the Computop Helpdesk, if you need the additional values in the response)	Eindeutige Identifikationsnummer des Kundenkontos bei PayPal. (Die Rückgabe dieses Parameters muss aktiviert werden. Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie diesen Wert in der Antwort benötigen.)
GrossAmount	an..9	O	Final amount charged, including any shipping and taxes from your Merchant Profile	Endgültig berechneter Betrag einschließlich Lieferkosten und Steuern von Ihrem Händlerprofil
FeeAmount	an..9	O	PayPal fee amount charged for the transaction	Betrag der für die Transaktion berechneten PayPal-Gebühr
SettleAmount	an..9	O	Amount deposited in your PayPal account after a currency conversion	Ihrem PayPal-Konto nach einer Währungsumrechnung gutgeschriebener Betrag
TaxAmount	an..9	O	Tax charged on the transaction	Für die Transaktion berechnete Steuer
ExchangeRate	an..17	O	Exchange rate if a currency conversion occurred. Relevant only if you are billing in their non-primary currency. If the buyer chooses to pay with a currency other than the non-primary currency, the conversion occurs in the buyer's account	Wechselkurs bei einer Währungsumrechnung. Nur relevant, wenn die Rechnung nicht in der primären Währung ausgestellt ist. Wenn der Käufer in einer anderen als der nicht primären Währung bezahlt, erfolgt die Umrechnung im Händlerkonto.
mc_fee	an..9	C	Only in case of separate Notify from PayPal: Transaction fee associated with the payment. mc_gross minus mc_fee equals the amount deposited into the receiver_email account. Equivalent to payment_fee for USD payments. If this amount is negative, it signifies a refund or reversal, and either of those payment statuses can be for the full or partial amount of the original transaction fee	Nur bei separatem Notify von PayPal: Transaktionsgebühr für die Zahlung. mc_gross minus mc_fee entspricht dem Betrag, der dem Empfängerkonto gutgeschrieben wird. Ist äquivalent zur payment_fee bei Zahlung in US-Dollar. Ein negativer Betrag signalisiert ein Storno oder eine Gutschrift. Beide Zahlungs-Status können für den vollständigen oder teilweisen Betrag der ursprünglichen Transaktionsgebühr sein.
mc_gross	an..9	C	Only in case of separate Notify from PayPal: Full amount of the customer's payment, before transaction fee is subtracted. Equivalent to payment_gross for USD payments. If this amount is negative, it signifies a refund or reversal, and either of those payment statuses can be for the full or partial amount of the original transaction.	Nur bei separatem Notify von PayPal: Gesamtbetrag der Zahlung des Kunden vor Abzug der Transaktionsgebühr. Ist äquivalent zu payment_gross bei Zahlung in US-Dollar. Ein negativer Betrag signalisiert ein Storno oder eine Gutschrift. Beide Zahlungs-Status können für den vollständigen oder teilweisen Betrag der ursprünglichen Transaktionsgebühr sein.

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

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

Key Format CND Description Beschreibung
MerchantID
ans..30
M
MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.
HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key Format CND Description Beschreibung
TransID
ans..64
M TransactionID provided by you which should be unique for each payment Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key Format CND Description Beschreibung
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).
Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key Format CND Description Beschreibung
Currency
a3
M
Currency, three digits 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/.
Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.

Key Format CND Description Beschreibung
refnr
ans..30
O
Merchant’s unique reference number
Eindeutige Referenznummer des Händlers

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

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

Key Format CND Description Beschreibung
mid
ans..30
M
MerchantID, assigned by Computop
HändlerID, die von Computop vergeben wird

Key Format CND Description Beschreibung
PayID
an32
M
ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.
Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key Format CND Description Beschreibung
XID
an32
M
ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate
Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key Format CND Description Beschreibung
TransID
ans..64
M TransactionID provided by you which should be unique for each payment Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key Format CND Description Beschreibung
Status
a..50
M
OK (URLSuccess) or FAILED (URLFailure)
OK (URLSuccess) oder FAILED (URLFailure)

Key Format CND Description Beschreibung
Description
ans..1024
M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Key Format CND Description Beschreibung
Code
an8
M
Error code according to Paygate Response Codes (A4 Error codes)
Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key Format CND Description Beschreibung
refnr
ans..30
O
Merchant’s unique reference number
Eindeutige Referenznummer des Händlers

Key Format CND Description Beschreibung
CodeExt
n..10
O
Error code from external partner. Needs to be agreed with Computop Helpdesk.
Fehlercode des externen Partners, wenn mit dem Computop Helpdesk abgesprochen.

Ergebnis-Parameter bei PayPal mit Methode "shortcut"

Aufruf der Schnittstelle für separate Autorisierung

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

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

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

Key Format CND Description Beschreibung
MerchantID
ans..30
M
MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.
HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key Format CND Description Beschreibung
PayID
an32
M
ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.
Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key Format CND Description Beschreibung
TransID
ans..64
M TransactionID provided by you which should be unique for each payment Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key Format CND Description Beschreibung
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).
Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key Format CND Description Beschreibung
Currency
a3
M
Currency, three digits 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/.
Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle. Bitte beachten Sie die weltweit von PayPal unterstützten Währungen unter https://developer.paypal.com/api/rest/reference/currency-codes/.

Key	Format	CND	Description	Beschreibung
TxType	ans..5	M	Transaction type Auth	Transaktionstyp Auth
FirstName	ans..50	O	Either the first name only or first and second name if a company name is used as a delivery address.	Entweder nur der Vorname oder Vor- und Nachname, falls ein Firmenname als Lieferadresse genutzt wird.
LastName	ans..50	O	Surname or name of the company of the delivery address	Nachname oder Firmenbezeichnung der Lieferadresse
AddrStreet	ans..100	O	Street in the delivery address	Straßenname der Lieferadresse
AddrStreet2	ans..100	O	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.	2. Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vom Computop Helpdesk aktiviert werden.
AddrCity	ans..40	O	Town/city in the delivery address	Ortsname der Lieferadresse
AddrState	ans..40	O	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.	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	O	Postcode in the delivery address	Postleitzahl der Lieferadresse
AddrCountryCode	an2	O	Country code of the delivery country	Ländercode des Lieferlandes
Phone	n..20	O	Telephone number	Telefonnummer

Parameter für PayPal-Autorisierung