Über Ratepay

Allgemeines zu Ratepay

Mit Rechnungskauf reduzieren Sie als Händler die Bestellabbrüche in Ihrem Online-Shop um bis zu 81 Prozent. Dadurch erhöhen sich Ihre Konversionsrate und Ihr Umsatz. Deshalb ermöglicht das Computop Paygate in mehreren europäischen Ländern den Rechnungskauf mit Zahlungsgarantie. Der Ratenkauf im Online-Shop motiviert Ihre Kunden, hochwertige Warenkörbe zu bestellen. So erhöht sich auch Ihr Umsatz. Das Computop Paygate bietet deshalb Ratenkauf mit Zahlungsgarantie in mehreren europäischen Ländern an.

Bei Ratepay profitieren Sie als Händler von einem Fullservice für den Rechnungs- und Ratenkauf. Dafür übergeben Sie während der Bestellung nur alle Rechnungsdaten an den Dienstleister. Der übernimmt dann den gesamten Aufwand für Rechnungsstellung und Debitorenmanagement. Als Händler bekommen Sie eine Zahlungsgarantie. Außerdem bietet Ratepay klassische Ratenzahlung und SEPA-Lastschriftverfahren an.

Ratepay gewährt im Bestellprozess sekundenschnell eine Online-Zusage für den Ratenkauf. Ein PostIdent-Verfahren ist nicht nötig. Ratepay zahlt den Rechnungsbetrag kurzfristig an den Händler aus und trägt das Ausfallrisiko selbst.

Logo
Info	Ratepay bietet Payment-Lösungen für Rechnungskauf, Ratenzahlung und Lastschriftverfahren, übernimmt dabei die gesamte Ab-wicklung sowie das komplette Risiko von Zahlungsausfällen.
Typ	Zahlungen per Rechnungs- und Ratenkauf

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

Diagramm zum Prozessablauf

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6Ijk4MjA2MDc5IiwiZGlhZ3JhbU5hbWUiOiJSYXRlcGF5X0NUIiwiYXNwZWN0IjoiIiwibGlua3MiOiJhdXRvIiwiY2VvTmFtZSI6IlJhdGVwYXkiLCJ0YnN0eWxlIjoidG9wIiwiY2FuQ29tbWVudCI6ZmFsc2UsImRpYWdyYW1VcmwiOiIiLCJjc3ZGaWxlVXJsIjoiIiwiYm9yZGVyIjp0cnVlLCJtYXhTY2FsZSI6IjEiLCJvd25pbmdQYWdlSWQiOjI2MjQ3NTU2LCJlZGl0YWJsZSI6ZmFsc2UsImNlb0lkIjoyNjI0NzU1NiwicGFnZUlkIjoiIiwibGJveCI6dHJ1ZSwic2VydmVyQ29uZmlnIjp7ImVtYWlscHJldmlldyI6IjEifSwib2RyaXZlSWQiOiIiLCJyZXZpc2lvbiI6MCwibWFjcm9JZCI6IjBkMjViYzBiLWFkY2UtNDhjYi05MmY4LWYwOThkZjhjOGZmZiIsInByZXZpZXdOYW1lIjoiUmF0ZXBheV9DVC5wbmciLCJsaWNlbnNlU3RhdHVzIjoiT0siLCJzZXJ2aWNlIjoiIiwiaXNUZW1wbGF0ZSI6IiIsIndpZHRoIjoiMTEwOSIsInNpbXBsZVZpZXdlciI6ZmFsc2UsImxhc3RNb2RpZmllZCI6IkZlYiAxMCwgMjAyMywgODo1MjoyNSBBTSIsImV4Y2VlZFBhZ2VXaWR0aCI6ZmFsc2UsIm9DbGllbnRJZCI6IiJ9

Ratepay Prozessablauf

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.

Ratepay Rechnungs- und Ratenkauf

Ein Zahlungsvorgang mit Ratepay besteht aus mehreren Transaktionsschritten. Zu Anfang ist eine Initialisierung erforderlich, die als Ergebnis die zulässigen Zahlarten für den Kunden zurückliefert: Rechnungskauf, Ratenzahlung oder Lastschrift. Sofern der Kunde Ratenkauf wünscht, muss der Ratenrechner angezeigt werden. Anschließend wird die Zahlung angelegt, bestätigt, bei Bedarf geändert und schließlich gebucht. Gutschriften sind ebenfalls möglich.

Bei der Computop Ratepay-Anbindung gibt es 5 verschiedene Requests, welche je nach Situation und Fortschritt im Bezahlprozess durchgeführt werden müssen. Computop setzt diese Requests in die entsprechenden Ratepay-Requests um. Hierfür gilt folgendes Mapping:

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

Computop request	Ratepay request	Description	Beschreibung
INIT / Authorize	PAYMENT_INIT (PAYMENT_QUERY)	Computop executes automatically the request PAYMENT_INIT. If a merchant uses Integrated Payment Control (IBS) the PAYMENT_QUERY request is carried out. EventToken = A	Computop führt automatisiert den Request PAYMENT_INIT durch. Wenn ein Händler die integrierte Bezahlsteuerung (IBS) nutzt, wird der Request PAYMENT_QUERY ausgeführt. EventToken = A
Create payment (Authorize step 1)	PAYMENT_REQUEST	Initialises a purchase by instalment or purchase on account EventToken = R	Initialisiert einen Raten- bzw. Rechnungskauf EventToken = R
Verify (Authorize step 2)	PAYMENT_CONFIRM	Confirms the initialisation again. Computop can also automate this request. Please leave this request out in that case (contact our support for this). EventToken = V	Bestätigt die Initialisierung erneut. Computop kann diesen Request auch automatisieren. Dann lassen sie diesen Request bitte aus (Wenden sie sich hierfür an unseren Support). EventToken = V
Order change (before capture)	PAYMENT_CHANGE	Optional: Here the payment can be modified. Possible are: - Full cancellation / EventToken = FC - Partial cancellation / EventToken = PC - Order change / EventToken = CO	Optional: Hiermit kann die Zahlung bearbeitet werden. Möglich sind: - Vollstornierung / EventToken = FC - Teilstornierung / EventToken = PC - Auftragsänderung / EventToken = CO
Capture	CONFIRMATION_DELIVERY	Activates and/or carries out payment. This request must be given when the goods are shipped for reasons of liability and falling due! EventToken = C	Aktiviert bzw. führt die Zahlung durch. Aus Haftungs- und Fälligkeitsgründen muss dieser Request beim Versand der Ware erfolgen! EventToken = C
Order change (after capture)	PAYMENT_CHANGE	Optional: Here the payment can be modified. Possible are: - Full return / EventToken = FC - Partial return / EventToken = PR - Credit / EventToken = CR	Optional: Hiermit kann die Zahlung bearbeitet werden. Möglich sind: - Vollrückgabe / EventToken = FR - Teilrückgabe / EventToken = PR - Gutschrift / EventToken = CR

Ratepay-Zahlungen initialisieren

Um eine Zahlung mit Ratepay über eine Server-zu-Server-Verbindung zu initialisieren, verwenden Sie bitte folgende URL:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

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
refnr	ns..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

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	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

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
OrderDesc	ans..768	O	Description of the goods purchased	Beschreibung der gekauften Waren
E-mail	ans..255	M	eMail address of the card holder	E-Mail-Adresse des Karteninhabers
CustomerID	an..30	O	Unique customer ID in merchant system or the customer’s email address	Eindeutige ID des Kunden im Händlersystem oder die E-Mail-Adresse des Kunden
CustomerClassification	ans..8	O	Instruction to risk management about type of customer: negative, neutral, positive, vip	Anweisung an das Risikomanagement, um welchen Kundentyp es sich handelt: negative, neutral, positive, vip
Title	ans..45	O	Title	Titel
Salutation	ans..45	O	Salutation	Anrede
Gender	a1	M	Gender: Sex (M=male / F=female / U=unknown)	Geschlecht: M=male, F=female, U=unknown
DateOfBirth	dttm8	C	Date of birth in the format YYYYMMDD. Optional for B2B (CompanyName transmitted), otherwise mandatory.	Geburtsdatum im Format JJJJMMTT. Optional bei B2B (CompanyName angegeben), sonst Pflicht.
PhoneAreaCode	ans..30	C	Telephone code. Mandatory if MobileAreaCode is not transmitted.	Telefonvorwahl. Pflicht, wenn kein MobileAreaCode übergeben ist.
Phone	ans..30	C	Phone number. Mandatory if Mobile is not transmitted.	Rufnummer. Pflicht, wenn kein Mobile übergeben ist.
FaxAreaCode	ans..30	O	Fax area code	Fax-Vorwahl
Fax	ans..30	O	Fax number	Faxnummer
MobileAreaCode	ans..30	C	Mobile area code. Mandatory if PhoneAreaCode is not transmitted.	Mobil-Vorwahl. Pflicht, wenn kein PhoneAreaCode übergeben ist.
Mobile	ans..30	C	Mobile telephone number. Mandatory if Phone is not transmitted.	Mobiltelefonnummer. Pflicht, wenn kein Phone übergeben ist.
AccOwner	ans..55	C	Name of account holder. Mandatory for direct debit.	Name des Kontoinhabers. Pflicht bei DirectDebit.
IBAN	ans..34	C	International Bank Account Number. Mandatory for direct debit.	International Bank Account Number. Pflicht bei DirectDebit.
BIC	ans11	O	Bank Identifier Code	Bank Identifier Code
AccBank	ans..27	O	Name of the financial institution	Name des Kreditinstituts
Nationality	a2	M	Country code of customer's country of origin according to ISO-3166 alpha 2	Ländercode des Herkunftslandes des Kunden gemäß ISO-3166 alpha 2
AllowCredInq	a..3	M	Customer agrees to the passing on of his details for credit offers (yes/no)	Kunde stimmt der Weitergabe seiner Daten für Kreditangebote zu (yes/no)
ShopSystem	ans..127	O	Name of the shop system	Name des Shop-Systems
ShopSystemVersion	ans..127	O	Version name of the shop system	Versionsname des Shop-Systems
ShoppingBasket	ans..1024	M	Current shopping basket (for structure see table Shopping-Basket)	Aktueller Warenkorb (Aufbau siehe Tabelle Shopping-Basket)
ShoppingBasketAmount	n..10	M	Total value of shopping basket in smallest currency unit (less discount, incl. shipment etc.)	Gesamtwert des Warenkorbs in kleinster Währungseinheit (abzüglich Rabatte, inkl. Versand u.a.)
Discount	ans..100	O	Trans-shopping cart discount Format: DESCRIPTION; GROSS AMOUNT; VAT Example: Discount;1000;1900	Warenkorbübergreifender Rabatt. Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ Beispiel: Rabatt;1000;1900
ShippingProfile	ans..100	O	Shipping costs Format: DESCRIPTION; GROSS AMOUNT; VAT Example: Shipment;500;1900	Versandkosten Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ Beispiel: Versand;500;1900
Account	ans..10	O	Account identification to use separate logins (SubShops)	Account-Kennung, um gesonderte (SubShops) Logins zu nutzen
EventToken	a..2	M	„A“ for authorization	„A“ für Autorisierung
			Company data (B2B)	Firmendaten (B2B)
CompanyName	ans..100	C	Company name, obligatory for B2B	Firmenname, Pflicht bei B2B
VatID	ans..25	C	VAT-ID, obligatory for B2B	Umsatzsteuer-ID, Pflicht bei B2B
CompanyID	ans..50	O	Register of Companies number	Handelsregisternummer
LegalForm	ans..100	O	Legal form. The value to be transmitted must be coordinated with Ratepay!	Rechtsform. Zu übergebender Wert muss mit Ratepay abgestimmt werden!
RegistryLocation	ans..255	O	Company's principal office	Firmensitz
Homepage	ans..255	O	Homepage of the company	Homepage des Unternehmens
			Delivery data	Lieferdaten
sdFirstName	ans..100	O	First name of the customer	Vorname des Kunden
sdLastName	ans..100	O	Last name of the customer	Nachname des Kunden
sdStreet	ans..100	O	Street name and house number	Straßenname und Hausnummer
sdStreetHouseNumber	ans..10	O	Street number	Hausnummer
sdStreetAddition	ans..50	O	Addition in the delivery address	Zusatz in der Lieferadresse
sdZIPCode	ans..10	O	Postcode	Postleitzahl
sdCity	ans..255	O	City	Ort
sdCountryCode	a2	O	Two characters country code according to ISO 3166	Ländercode zweistellig gemäß ISO 3166
sdPhone	ns..32	O	Customer’s phone number	Telefonnummer des Kunden
			Invoice data (check address)	Rechnungsdaten (Prüfadresse)
bdFirstName	ans..100	M	First name of the custumer	Vorname des Kunden
bdLastName	ans..100	M	Last name of the customer	Nachname des Kunden
bdCompanyName	ans..100	O	Name of company	Firmenname
bdStreet	ans..50	M	Street name in the invoicing address	Straßenname der Rechnungsadresse
bdStreetNr	ans..10	M	Street number of the invoicing address	Hausnummer der Rechnungsadresse
bdStreetAddition	ans..50	O	Address addition in the billing address	Adresszusatz der Rechnungsadresse
bdZIP	ans..10	M	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdCity	ans..255	M	Town/city of the invoicing address	Ort der Rechnungsadresse
bdCountryCode	a2	M	Country code for the invoicing address, 2 characters according to ISO 3166	Ländercode der Rechnungsadresse zweistellig gemäß ISO 3166
bdPhone	ns..32	M	Customer’s phone number	Telefonnummer des Kunden
			Registration address (B2B)	Registrierungsadresse (B2B)
FirstName	ans..100	O	First name	Vorname
LastName	ans..100	O	Last name	Nachname
AddrStreet	ans..50	C	Street. Mandatory if B2B (CompanyName is given).	Straße. Pflicht wenn B2B (CompanyName angegeben).
AddrStreetNr	ans..10	C	Street number. Mandatory if B2B (CompanyName is given)	Hausnummer. Pflicht wenn B2B (CompanyName angegeben).
AddressAddition	ans..50	O	Address c/o	Adresszusatz
AddrZip	ans..10	C	Postcode. Mandatory if B2B (CompanyName is given).	Postleitzahl. Pflicht wenn B2B (CompanyName angegeben).
AddrCity	ans..32	C	City. Mandatory if B2B (CompanyName is given).	Ort. Pflicht wenn B2B (CompanyName angegeben).
AddrCountryCode	a2	C	Two characters country code according to ISO 3166. Mandatory if B2B (CompanyName is given).	Ländercode zweistellig gemäß ISO 3166. Pflicht wenn B2B (CompanyName angegeben).
			Fraud prevention	Betrugsprävention
IPAddr	ans..15	M	With the transferred IP address Paygate can determine in which country and in which town your customer has connected with the Internet (see also IPZone). Format: 123,456,789,012	Durch die übergebene IP-Adresse kann das Paygate ermitteln, in welchem Land und in welcher Stadt Ihr Kunde mit dem Internet verbunden ist (vgl. IPZone). Format: 123.456.789.012
DeviceToken	ans..100	O	Device token, see external documentation from Ratepay	Geräte-Token, siehe externe Dokumentation von Ratepay

Parameter für Ratepay-Zahlungen

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	INIT or FAILED	INIT oder FAILED

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	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

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

Key	Format	CND	Description	Beschreibung
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)	Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)
ExternalMessage	ans..256	O	Error text from Ratepay, if agreed with Computop Helpdesk	Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen
ExternalCode	ans..64	O	Error code from Ratepay, if agreed with Computop Helpdesk	Fehlercode von Ratepay, wenn mit Computop Helpdesk abgesprochen
Installment	a..5	O	For IBS: True / False, if installment is allowed	Bei IBS: True / False, ob installment erlaubt ist
Prepayment	a..5	O	For IBS: True / False, if prepayment is allowed	Bei IBS: True / False, ob prepayment erlaubt ist
Invoice	a..5	O	For IBS: True / False, if invoice is allowed	Bei IBS: True / False, ob invoice erlaubt ist
ELV	a..5	O	For IBS: True / False, if ELV is allowed	Bei IBS: True / False, ob ELV erlaubt ist
RPTransID	ans..50	O	Unique reference number from Ratepay	Eindeutige Referenznummer von Ratepay

Antwort-Parameter für Ratepay-Zahlungen

Ratepay-Ratenrechner

Für einen beabsichtigen Ratenkauf des Endkunden muss der Ratepay-Ratenrechner (vom Händler implementierte Oberfläche) angezeigt werden. Hier kann anhand des Betrages + z.B. der Dauer die Höhe der Raten (oder auch anhand der Raten die Laufzeit) ermittelt werden.

Um den Ratenrechner für Ratepay anzuzeigen, rufen Sie folgende URL auf:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

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	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

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
Month	ans.255	C	Duration in months. Obligatory for EventToken RT.	Laufzeit in Monaten. Pflicht bei EventToken RT.
Rate	n..8	C	Monthly instalment in the smallest currency unit. Obligatory for EventToken RR.	Monatliche Rate in kleinster Währungseinheit. Pflicht bei EventToken RR.
FirstDay	n..2	O	Calendar day of first payment. Possible values are: 1, 15, 28. Default value = 28.	Kalendertag der ersten Zahlung. Mögliche Werte sind: 1, 15, 28. Standardwert = 28.
StartDate	dttm8	O	Start date of instalment payment in the format YYYYMMDD	Startdatum der Ratenzahlung im Format JJJJMMTT
DueDate	dttm8	O	Due date in the format YYYYMMDD	Fälligkeitsdatum im Format JJJJMMTT
InterestRate	n..5	O	Debit interest rate, e.g. 1370 for 13,70%	Sollzinssatz, zum Beispiel 1370 für 13,70%
EventToken	a..2	M	RT (CalculationbyTime) or RR (CalculationbyRate)	RT (CalculationbyTime) oder RR (CalculationbyRate)
Account	ans..10	O	Account identification to use separate logins (SubShops)	Account-Kennung, um gesonderte (SubShops) Logins zu nutzen

Parameter für Ratepay-Ratenrechner

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	INIT or FAILED	INIT oder FAILED

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	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

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

Key	Format	CND	Description	Beschreibung
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)	Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)
ExternalMessage	ans..256	O	Error text from Ratepay, if agreed with Computop Helpdesk	Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen
ExternalCode	ans..64	O	Error code from Ratepay, if agreed with Computop Helpdesk	Fehlercode von Ratepay, wenn mit Computop Helpdesk abgesprochen
TotalAmount	n..10	M	Total amount to be financed in the smallest currency unit	Zu finanzierender Gesamtbetrag in der kleinsten Währungseinheit
InterestAmount	n..10	M	Sum of all monthly instalments in the smallest currency unit	Summe aller monatlich gezahlten Raten in der kleinsten Währungseinheit
ServiceCharge	n..10	M	Additional financing costs in the smallest currency unit	Zusätzliche Finanzierungskosten in der kleinsten Währungseinheit
InterestRate	n..5	M	Debit interest rate, e.g. 1370 for 13,70%	Sollzinssatz, zum Beispiel 1370 für 13,70%
AnnualPercentageRate	n..5	M	Annual interest based on ServiceCharge and InterestRate	Jahreszins basierend auf ServiceCharge und InterestRate
MonthlyDebitInterest	n..5	M	Monthly debit interest based on AnnualPercentageRate	Monatlicher Zins basierend auf AnnualPercentageRate
InstallmentNumber	n..2	M	Number of monthly instalments	Anzahl Monate der Ratenzahlung
InstallmentAmount	n..10	M	Monthly amount payable in the smallest currency unit	Monatlich zu bezahlender Betrag in der kleinsten Währungseinheit
InstallmentLastAmount	n..10	M	Amount of the last rate in the smallest currency unit	Betrag der letzten Rate in der kleinsten Währungseinheit
FirstDay	n..2	O	Calendar day of first payment. Possible values are 1, 15, 28. Default value = 28.	Kalendertag der ersten Zahlung. Mögliche Werte sind 1, 15, 28. Standardwert = 28.

Antwort-Parameter für Ratepay-Ratenrechner

Die Konfiguration des Ratenrechners ist zwar von Ratepay fest vorgegeben, dennoch kann es zur Vermeidung von Folgefehlern hilfreich sein, diese Konfiguration vor der weiteren Verarbeitung abzufragen. Dazu rufen Sie folgende URL auf:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

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
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
EventToken	a..2	M	RC for Rateconfiguration	RC für Rateconfiguration
Account	ans..10	O	Account identification to use separate logins (SubShops)	Account-Kennung, um gesonderte (SubShops) Logins zu nutzen

Parameter zur Abfrage der Konfiguration des Ratepay-Ratenrechners

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	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
MinRate	n..2	O	Minimum number of instalments	Mindestanzahl der Raten
DefaultRate	n..12	O	Default rate in the smallest currency unit	Standardrate in der kleinsten Währungseinheit
MaxInterestRate	n..5	O	Maximum interest rate	Maximaler Zinssatz
MinMonth	n..2	O	Minimum running time in months	Mindestlaufzeit in Monaten
MaxMonth	n..2	O	Maximum running time in months	Maximallaufzeit in Monaten
MonthLongrun	n..2	O	Minimum running time for a long time financing	Mindestlaufzeit für eine Langzeitfinanzierung
MonthAllowed	ans..50	O	Comma-separated list of permissible running times in months	Kommaseparierte Liste mit erlaubten Laufzeiten in Monaten
FirstDay	ans..20	O	Comma-separated list of permissible start days (1, 15, 28)	Kommaseparierte Liste mit möglichen Starttagen (1, 15, 28)
LastRate	n..10	O	Minimum amount for the final instalment in the smallest currency unit	Mindestbetrag für die Abschlussrate in der kleinsten Währungseinheit
MinRateNormal	n..10	O	Minimum rate in the smallest currency unit	Mindestrate in der kleinsten Währungseinheit
MinRateLongrun	n..10	O	Minimum rate for a long term financing in the smallest currency unit	Mindestrate einer Langzeitfinanzierung in der kleinsten Währungseinheit
ServiceCharge	n..10	O	Additional financing costs in the smallest currency unit	Zusätzliche Finanzierungskosten in der kleinsten Währungseinheit
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)	Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)
ExternalMessage	ans..256	O	Error text from Ratepay, if agreed with Computop Helpdesk	Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen
ExternalCode	ans..64	O	Error code from Ratepay, if agreed with Computop Helpdesk	Fehlercode von Ratepay, wenn mit Computop Helpdesk abgesprochen

Antwort-Parameter der Konfigurationsabfrage des Ratepay-Ratenrechners

Zahlungsvorgang anlegen

Um einen Zahlungsvorgang mit Ratepay anzulegen, verwenden Sie bitte folgende URL:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

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	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

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
RPMethod	ans..10	M	Type of payment: INVOICE, INSTALLMENT or ELV	Zahlungsweise: INVOICE, INSTALLMENT oder ELV
ShoppingBasketAmount	n..10	M	Total value of shopping basket in smallest currency unit (less discount, incl. shipment etc.)	Gesamtwert des Warenkorbs in kleinster Währungseinheit (abzüglich Rabatte, inkl. Versand u.a.)
Account	ans..10	O	Account identification to use separate logins (SubShops)	Account-Kennung, um gesonderte (SubShops) Logins zu nutzen
DeviceToken	ans..100	O	Device token, see external documentation from Ratepay	Geräte-Token, siehe externe Dokumentation von Ratepay
ShopSystem	ans..127	O	Name of the shop system	Name des Shop-Systems
ShopSystemVersion	ans..127	O	Version name of the shop system	Versionsname des Shop-Systems
EventToken	a..2	M	R for RateInit	R für RateInit
			SEPA (ELV)	SEPA (ELV)
AccOwner	ans..55	C	Name of account holder. Mandatory for direct debit.	Name des Kontoinhabers. Pflicht bei DirectDebit.
IBAN	ans..34	C	International Bank Account Number. Mandatory for direct debit.	International Bank Account Number. Pflicht bei DirectDebit.
BIC	ans11	O	Bank Identifier Code	Bank Identifier Code. Pflicht bei DirectDebit.
AccBank	ans..27	O	Name of the financial institution	Name des Kreditinstituts
DebitPayType	a2	C	Type of payment. Mandatory for direct debit. BT = BankTransfer ; DD = DirectDebit	Zahlungsweise. Pflicht bei DirectDebit. BT = BankTransfer ; DD = DirectDebit
			Instalment payment (INSTALLMENT)	Ratenzahlung (INSTALLMENT)
InterestRate	n..5	C	Reference interest rate (value is taken from the instalment calculator). Mandatory for instalment.	Sollzinssatz (Wert ist dem Ratenrechner zu entnehmen). Pflicht bei Ratenzahlung.
InstallmentNumber	n..12	C	Number of monthly instalments (value is taken from the instalment calculator). Mandatory for instalment.	Anzahl Monate der Ratenzahlung (Wert ist dem Ratenrechner zu entnehmen). Pflicht bei Ratenzahlung.
InstallmentAmount	n..10	C	Amount payable monthly (value is taken from the instalment calculator). Mandatory for instalment.	Monatlich zu bezahlender Betrag (Wert ist dem Ratenrechner zu entnehmen). Pflicht bei Ratenzahlung.
InstallmentLastAmount	n..10	C	Amount of final instalment (value is taken from the instalment calculator). Mandatory for instalment.	Betrag der letzten Rate (Wert ist dem Ratenrechner zu entnehmen). Pflicht bei Ratenzahlung.
FirstDay	n..2	O	Calendar day of first payment. Possible values are 1, 15, 28. Default value = 28.	Kalendertag der ersten Zahlung. Mögliche Werte sind 1, 15, 28. Standardwert = 28.
TotalAmount	n..10	C	Total amount to be financed. Mandatory for instalment.	Zu finanzierender Gesamtbetrag. Pflicht bei Ratenzahlung.

Parameter zum Anlegen einer Ratepay-Zahlung

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	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)	Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)
ExternalMessage	ans..256	O	Error text from Ratepay, if agreed with Computop Helpdesk	Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen
ExternalCode	ans..64	O	Error code from Ratepay, if agreed with Computop Helpdesk	Fehlercode von Ratepay, wenn mit Computop Helpdesk abgesprochen

Antwort-Parameter beim Anlegen einer Ratepay-Zahlung

Zahlungsvorgang bestätigen (Confirm)

Um einen Zahlungsvorgang mit Ratepay zu bestätigen, verwenden Sie bitte folgende URL:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

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
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
Account	ans..10	O	Account identification to use separate logins (SubShops)	Account-Kennung, um gesonderte (SubShops) Logins zu nutzen
EventToken	a..2	M	V for verify	V für verify

Parameter zum Bestätigen einer Ratepay-Zahlung

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	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)	Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)
ExternalMessage	ans..256	O	Error text from Ratepay, if agreed with Computop Helpdesk	Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen
ExternalCode	ans..64	O	Error code from Ratepay, if agreed with Computop Helpdesk	Fehlercode von Ratepay, wenn mit Computop Helpdesk abgesprochen

Antwort-Parameter beim Bestätigen einer Ratepay-Zahlung

Ratepay-Zahlungsvorgang buchen (Komplett- / Teilbuchung)

Um einen Zahlungsvorgang mit Ratepay zu buchen, verwenden Sie bitte folgende URL:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

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 to be captured	Vom Paygate vergebene ID für die zu buchende Zahlung

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	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

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
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
ShoppingBasket	ans..1024	M	Shopping cart with items to be posted (structure - see ShoppingBasket table)	Warenkorb mit den zu buchenden Artikeln (Aufbau siehe Tabelle ShoppingBasket)
ShoppingBasketAmount	n..10	M	Total value of the present shopping basket in smallest currency unit (less discount, incl. shipment etc.)	Gesamtwert des aktuellen Warenkorbs in kleinster Währungseinheit (abzüglich Rabatte, inkl. Versand u.a.)
Discount	ans..100	O	Trans-shopping cart discount Format: DESCRIPTION; GROSS AMOUNT; VAT Example: Discount;1000;1900	Warenkorbübergreifender Rabatt. Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ Beispiel: Rabatt;1000;1900
ShippingProfile	ans..100	O	Shipping costs Format: DESCRIPTION; GROSS AMOUNT; VAT Example: Shipment;500;1900	Versandkosten Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ Beispiel: Versand;500;1900
Account	ans..10	O	Account identification to use separate logins (SubShops)	Account-Kennung, um gesonderte (SubShops) Logins zu nutzen
InvoiceID	ans..50	O	Invoice number	Rechnungsnummer
TrackingID	ans..100	O	List of shipment service providers with associated parcel number. Format: SERVICE PROVIDER; PACKAGE NUMBER Example: DHL;Paket1 Other service providers/dispatch numbers are respectively delimited with a “+”. Example: DHL;Paket1+DHL;Paket2+GLS;Paket9 Caution: The shortcodes for providers are to coordinate with Ratepay!	Liste der Versanddienstleister mit zugehöriger Paketnummer. Format: DIENSTLEISTER;PAKETNUMMER Beispiel: DHL;Paket1 Weitere Dienstleister/Versandnummern werden jeweils mit einem „+“ abgegrenzt. Beispiel: DHL;Paket1+DHL;Paket2+GLS;Paket9 Achtung: Die Kürzel für die Provider sind mit Ratepay abzustimmen!
ShopSystem	ans..127	O	Name of the shop system	Name des Shop-Systems
ShopSystemVersion	ans..127	O	Version name of the shop system	Versionsname des Shop-Systems
EventToken	a..2	M	C for capture	C für Capture (Buchung)

Parameter zum Buchen einer Ratepay-Zahlung

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	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)	Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)
ExternalMessage	ans..256	O	Error text from Ratepay, if agreed with Computop Helpdesk	Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen
ExternalCode	ans..64	O	Error code from Ratepay, if agreed with Computop Helpdesk	Fehlercode von Ratepay, wenn mit Computop Helpdesk abgesprochen

Antwort-Parameter beim Buchen einer Ratepay-Zahlung

Storno / Rückgabe von Ratepay-Zahlungen

Um einen Zahlungsvorgang mit Ratepay teilweise oder vollständig zu stornieren oder Änderungen daran durchzuführen, verwenden Sie bitte folgende URL:

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

Hinweis: Für die verschiedenen Aktionen (Eventtoken) gibt es Einschränkungen, wann welche Aktion durchgeführt werden darf. Nur vor der Buchung erlaubt sind: FC (Voll-Stornierung), PC (Teil-Stornierung), CO (Änderung). Nur nach der Buchung erlaubt sind FR (Voll-Rückgabe) und PR (Teil-Rückgabe).

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
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	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

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
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
RPMethod	ans..10	M	Type of payment: INVOICE, INSTALLMENT or ELV	Zahlungsweise: INVOICE, INSTALLMENT oder ELV
ShoppingBasket	ans..1024	C	Shopping cart with items to be cancelled (structure - see ShoppingBasket table) for EventToken FC / FR either ShoppingBasket or ShoppingBasketAmount is required	Warenkorb mit den zu stornierenden Artikeln (Aufbau siehe Tabelle ShoppingBasket) für EventToken FC / FR ist entweder ShoppingBasket oder ShoppingBasketAmount erforderlich
ShoppingBasketAmount	n..10	C	Total value of the present shopping basket in smallest currency unit (less discount, incl. shipment etc.) for EventToken FC / FR either ShoppingBasket or ShoppingBasketAmount is required	Gesamtwert des aktuellen Warenkorbs in kleinster Währungseinheit (abzüglich Rabatte, inkl. Versand u.a.) für EventToken FC / FR ist entweder ShoppingBasket oder ShoppingBasketAmount erforderlich
Discount	ans..100	O	Trans-shopping cart discount Format: DESCRIPTION; GROSS AMOUNT; VAT Example: Discount;1000;1900	Warenkorbübergreifender Rabatt. Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ Beispiel: Rabatt;1000;1900
ShippingProfile	ans..100	O	Shipping costs Format: DESCRIPTION; GROSS AMOUNT; VAT Example: Shipment;500;1900	Versandkosten Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ Beispiel: Versand;500;1900
Account	ans..10	O	Account identification to use separate logins (SubShops)	Account-Kennung, um gesonderte (SubShops) Logins zu nutzen
ShopSystem	ans..127	O	Name of the shop system	Name des Shop-Systems
ShopSystemVersion	ans..127	O	Version name of the shop system	Versionsname des Shop-Systems
EventToken	a..2	M	FC for full-cancellation PC for partial-cancellation CO for change-order FR for full-return PR for partial-return	FC für full-cancellation PC für partial-cancellation CO für change-order FR für full-return PR für partial-return

Parameter für Storno / Änderung einer Ratepay-Zahlung

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	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)	Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)
ExternalMessage	ans..256	O	Error text from Ratepay, if agreed with Computop Helpdesk	Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen
ExternalCode	ans..64	O	Error code from Ratepay, if agreed with Computop Helpdesk	Fehlercode von Ratepay, wenn mit Computop Helpdesk abgesprochen

Antwort-Parameter bei Storno / Änderung einer Ratepay-Zahlung

Gutschrift von Ratepay-Zahlungen

Um eine Gutschrift mit Ratepay durchzuführen, verwenden Sie bitte folgende URL:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

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 to be credited	Vom Paygate vergebene ID für die gutzuschreibende Zahlung

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	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

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
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
ShoppingBasket	ans..1024	M	Shopping cart with a “CREDIT” item (structure - see ShoppingBasket table)	Warenkorb mit einem „CREDIT“-Artikel (Aufbau siehe Tabelle ShoppingBasket)
ShoppingBasketAmount	n..10	M	Total value of the present shopping basket in smallest currency unit (less discount, incl. shipment etc.)	Gesamtwert des aktuellen Warenkorbs in kleinster Währungseinheit (abzüglich Rabatte, inkl. Versand u.a.)
Discount	ans..100	O	Trans-shopping cart discount Format: DESCRIPTION; GROSS AMOUNT; VAT Example: Discount;1000;1900	Warenkorbübergreifender Rabatt. Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ Beispiel: Rabatt;1000;1900
ShippingProfile	ans..100	O	Shipping costs Format: DESCRIPTION; GROSS AMOUNT; VAT Example: Shipment;500;1900	Versandkosten Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ Beispiel: Versand;500;1900
Account	ans..10	O	Account identification to use separate logins (SubShops)	Account-Kennung, um gesonderte (SubShops) Logins zu nutzen
ShopSystem	ans..127	O	Name of the shop system	Name des Shop-Systems
ShopSystemVersion	ans..127	O	Version name of the shop system	Versionsname des Shop-Systems
EventToken	a..2	M	CR for Credit	CR für Credit (Gutschrift)

Parameter für Gutschrift einer Ratepay-Zahlung

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	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)	Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)
ExternalMessage	ans..256	O	Error text from Ratepay, if agreed with Computop Helpdesk	Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen
ExternalCode	ans..64	O	Error code from Ratepay, if agreed with Computop Helpdesk	Fehlercode von Ratepay, wenn mit Computop Helpdesk abgesprochen

Antwort-Parameter bei Gutschrift einer Ratepay-Zahlung

Erläuterung zum Parameter ShoppingBasket

Der Parameter ShoppingBasket erklärt die betreffenden Artikel der Transaktion und setzt sich aus mehreren Werten zusammen. Die einzelnen Parameter innerhalb eines Warenkorbs werden mit „;“ getrennt. Es sind nur die Werte einzutragen, nicht der zugehörige Parametername. Ungenutzte optionale Parameter sind als leeres Feld zu übergeben. Jeder weitere Artikel wird durch ein „+“ vom vorherigen abgegrenzt. Beispiel siehe unterhalb der Tabelle.

Folgende Tabelle beschreibt die einzelnen Werte innerhalb des ShoppingBasket:

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
ArtNr	ans..255	C	Unique article number. Each item in the shopping cart must be clearly identifiable. Either via ArtNr or a combination of ArtNr and UniqueArticleNumber.	Eindeutige Artikelnummer. Jeder Artikel im Warenkorb muss eindeutig identifizierbar sein. Entweder über ArtNr oder eine Kombination aus ArtNr und UniqueArticleNumber.
Quantity	n..12	M	Quantity	Anzahl
Category	n..2	O	Article category (as agreed with Ratepay)	Artikelkategorie (nach Absprache mit Ratepay)
Item	ans..255	M	Article description	Artikelbeschreibung
UnitPriceGross	n..12	M	Unit price gross in smallest currency unit	Stückpreis brutto in kleinster Währungseinheit
TaxRate	n..5	M	VAT rate with 2 decimal places, e.g. 1900 for 19%	Steuersatz mit 2 Nachkommastellen, z.B. 1900 für 19%
UniqueArticleNumber	ans..50	C	Unique article number. Each item in the shopping cart must be clearly identifiable. Either via ArtNr or a combination of ArtNr and UniqueArticleNumber.	Eindeutige Artikelnummer. Jeder Artikel im Warenkorb muss eindeutig identifizierbar sein. Entweder über ArtNr oder eine Kombination aus ArtNr und UniqueArticleNumber.
Discount	n..12	O	Article-specific discount in smallest currency unit	Artikelbezogener Nachlass in kleinster Währungseinheit
DescriptionAddition	ans..511	O	Additional text for further description. Can be used in communication between Ratepay and the end customer.	Zusatztext für weitere Beschreibung. Kann in der Kommunikation zwischen Ratepay und dem Endkunden genutzt werden.

Parameter innerhalb des Warenkorbes

Beispiel eines Warenkorbs mit 3 Artikeln:

ShoppingBasket=A;1;1;Bett;10000;1900;01233;1000;Blau+B;2;1;Handtuch;3000;1900;0234;;180x200+C;5;1;Kissen;1000;1900;;;

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 Buchung oder Änderung bei Ratepay ü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:

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

Action	Version	Description	Beschreibung
Capture	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)
	1.1.2 / 2.1.2	with discount and shipping	mit discount und shipping
Change	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)
	1.1.2 / 2.1.2	with discount and shipping	mit discount und shipping

Beschreibung der möglichen Batch-Versionen

Der Aufbau für eine Buchung oder Gutschrift in einer einzureichenden Batch-Datei sieht folgendermaßen aus:

HEAD,<MerchantID>,<Date>,<Version>
Ratepay,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<ShoppingBasket>,<ShoppingBasketAmount>,<EventToken>,<RPMethod>(,<Discount>,<Shipping>)
Ratepay,Change,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<ShoppingBasket>,<ShoppingBasketAmount>,<EventToken>,<RPMethod>(,<Discount>,<Shipping>)
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

Die folgende Tabelle beschreibt die einzelnen Felder und Werte, die im Datensatz (Record) innerhalb der Batch-Datei verwendet 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

Type

a..11

M

HEAD for Header, FOOT for Footer, Ratepay for the transactions

HEAD für Header, FOOT für Footer, Ratepay für Transaktionen

Action

a..20

M

The parameter Action defines the type of transaction:

Capture

Change (credit / change)

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Change (Gutschrift / Änderung)

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	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

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
refnr	ns..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 this transaction	Vom Paygate vergebene ID für diese Transaktion

Key	Format	CND	Description	Beschreibung
ShoppingBasket	ans..1024	M	Shopping cart with items to be cancelled (structure - see ShoppingBasket table) for EventToken FC / FR either ShoppingBasket or ShoppingBasketAmount is required	Warenkorb mit den zu stornierenden Artikeln (Aufbau siehe Tabelle ShoppingBasket) für EventToken FC / FR ist entweder ShoppingBasket oder ShoppingBasketAmount erforderlich
ShoppingBasketAmount	n..12	M	Total value of the present shopping basket in smallest currency unit (less discount, incl. shipment etc.) for EventToken FC / FR either ShoppingBasket or ShoppingBasketAmount is required	Gesamtwert des aktuellen Warenkorbs in kleinster Währungseinheit (abzüglich Rabatte, inkl. Versand u.a.) für EventToken FC / FR ist entweder ShoppingBasket oder ShoppingBasketAmount erforderlich
EventToken	a..2	M	R for RateInit CR for Credit FC for full-cancellation PC for partial-cancellation CO for change-order FR for full-return PR for partial-return	R für RateInit (Initialisierung) CR für Credit (Gutschrift) FC für full-cancellation (Vollstornierung) PC für partial-cancellation (Teilstornierung) CO für change-order (Änderung) FR für full-return (Vollrücksendung) PR für partial-return (Teilrücksendung)
RPMethod	ans..10	C	Type of payment: INVOICE, INSTALLMENT or ELV. Is not needed for capture!	Zahlungsweise: INVOICE, INSTALLMENT oder ELV. Wird bei Buchung (Capture) nicht benötigt!
Discount	ans..100	O	Trans-shopping cart discount Format: DESCRIPTION; GROSS AMOUNT; VAT Example: Discount;1000;1900	Warenkorbübergreifender Rabatt Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ Beispiel: Rabatt;1000;1900
ShippingProfile	ans..100	O	Shipping costs Format: DESCRIPTION; GROSS AMOUNT; VAT Example: Shipment;500;1900	Versandkosten Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ Beispiel: Versand;500;1900

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>
Ratepay,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<ShoppingBasket>,<ShoppingBasketAmount>,<EventToken>,<RPMethod>(,<Discount>,<Shipping>),<Status>,<Code>
Ratepay,Change,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<ShoppingBasket>,<ShoppingBasketAmount>,<EventToken>,<RPMethod>(,<Discount>,<Shipping>),<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>

Die folgende Tabelle beschreibt die Antwort-Parameter, die der Batch-Manager im Record-Bereich zu jeder Transaktion speichert (hier nicht erklärte Standardparameter wie etwa <TransID> oder <RefNR> und Aufrufparameter werden unverändert zum Aufruf wieder zurückgegeben und sind vorstehend beschrieben):

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
Action	a..20	M	The parameter Action defines the type of transaction: Capture Change (credit / change)	Der Action-Parameter definiert die Art der Transaktion: Capture (Buchung) Change (Gutschrift / Änderung)

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for this transaction	Vom Paygate vergebene ID für diese Transaktion

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

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

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien

Space shortcuts

Page tree

Über Ratepay

Allgemeines zu Ratepay

Diagramm zum Prozessablauf

Paygate-Schnittstelle

Definitionen

Ratepay Rechnungs- und Ratenkauf

Ratepay-Zahlungen initialisieren

Ratepay-Ratenrechner

Zahlungsvorgang anlegen

Zahlungsvorgang bestätigen (Confirm)

Ratepay-Zahlungsvorgang buchen (Komplett- / Teilbuchung)

Storno / Rückgabe von Ratepay-Zahlungen

Gutschrift von Ratepay-Zahlungen

Erläuterung zum Parameter ShoppingBasket

Batch-Nutzung der Schnittstelle

Paygate

Computop

Help

Intranet Tools