Skip to end of metadata
Go to start of metadata


Ü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.

TypZahlungen per Rechnungs- und Ratenkauf

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


Diagramm zum Prozessablauf

Ratepay Prozessablauf


Paygate-Schnittstelle

Definitionen

Datenformate:

FormatBeschreibung

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ürzungBeschreibungKommentar

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.

The table is being loaded. Please wait for a bit ...

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

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


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung

OrderDescans..768ODescription of the goods purchasedBeschreibung der gekauften Waren
E-mailans..255MeMail address of the card holderE-Mail-Adresse des Karteninhabers
CustomerIDan..30OUnique customer ID in merchant system or the customer’s email addressEindeutige ID des Kunden im Händlersystem oder die E-Mail-Adresse des Kunden
CustomerClassificationans..8OInstruction to risk management about type of customer: negative, neutral, positive, vipAnweisung an das Risikomanagement, um welchen Kundentyp es sich handelt: negative, neutral, positive, vip
Titleans..45OTitleTitel
Salutationans..45OSalutationAnrede
Gendera1MGender: Sex (M=male / F=female / U=unknown)Geschlecht: M=male, F=female, U=unknown
DateOfBirthdttm8C

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.

PhoneAreaCodeans..30CTelephone code. Mandatory if MobileAreaCode is not transmitted.Telefonvorwahl. Pflicht, wenn kein MobileAreaCode übergeben ist.
Phoneans..30CPhone number. Mandatory if Mobile is not transmitted.Rufnummer. Pflicht, wenn kein Mobile übergeben ist.
FaxAreaCodeans..30OFax area codeFax-Vorwahl
Faxans..30OFax numberFaxnummer
MobileAreaCodeans..30CMobile area code. Mandatory if PhoneAreaCode is not transmitted.Mobil-Vorwahl. Pflicht, wenn kein PhoneAreaCode übergeben ist.
Mobileans..30CMobile telephone number. Mandatory if Phone is not transmitted.Mobiltelefonnummer. Pflicht, wenn kein Phone übergeben ist.
AccOwner

ans..55

CName of account holder. Mandatory for direct debit.Name des Kontoinhabers. Pflicht bei DirectDebit.
IBAN

ans..34

CInternational Bank Account Number. Mandatory for direct debit.International Bank Account Number. Pflicht bei DirectDebit.
BIC

ans11

OBank Identifier CodeBank Identifier Code
AccBank

ans..27

OName of the financial institutionName des Kreditinstituts
Nationality

a2

MCountry code of customer's country of origin according to ISO-3166 alpha 2Ländercode des Herkunftslandes des Kunden gemäß ISO-3166 alpha 2
AlloowCredInq

a..3

MCustomer 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

OName of the shop systemName des Shop-Systems
ShopSystemVersion

ans..127

OVersion name of the shop systemVersionsname des Shop-Systems
ShoppingBasket

ans..1024

MCurrent shopping basket (for structure see table Shopping-Basket)Aktueller Warenkorb (Aufbau siehe Tabelle Shopping-Basket)
ShoppingBasketAmount

n..10

MTotal 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.)
Discountans..100O

Trans-shopping cart discount

Format: DESCRIPTION; GROSS AMOUNT; VAT

Example: Discount;1000;1900

Warenkorbübergreifender Rabatt.

Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ

Beispiel: Rabatt;1000;1900

ShippingProfileans..100O

Shipping costs

Format: DESCRIPTION; GROSS AMOUNT; VAT

Example: Shipment;500;1900

Versandkosten

Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ

Beispiel: Versand;500;1900

Accountans..10OAccount identification to use separate logins (SubShops)Account-Kennung, um gesonderte (SubShops) Logins zu nutzen
EventTokena..2M„A“ for authorization„A“ für Autorisierung



Company data (B2B)Firmendaten (B2B)
CompanyName

ans..100

CCompany name, obligatory for B2BFirmenname, Pflicht bei B2B
VatID

ans..25

CVAT-ID, obligatory for B2BUmsatzsteuer-ID, Pflicht bei B2B
CompanyID

ans..50

ORegister of Companies numberHandelsregisternummer
LegalForm

ans..100

OLegal form. The value to be transmitted must be coordinated with Ratepay!Rechtsform. Zu übergebender Wert muss mit Ratepay abgestimmt werden!
RegistryLocation

ans..255

OCompany's principal officeFirmensitz
Homepage

ans..255

OHomepage of the companyHomepage des Unternehmens



Delivery dataLieferdaten
sdFirstName

ans..100

O

First name of the customerVorname des Kunden
sdLastName

ans..100

O

Last name of the customerNachname des Kunden
sdStreet

ans..100

O

Street name and house numberStraßenname und Hausnummer
sdStreetHouseNumber

ans..10

O

Street numberHausnummer
sdStreetAddition

ans..50

O

Addition in the delivery addressZusatz in der Lieferadresse
sdZIPCode

ans..10

O

PostcodePostleitzahl
sdCity

ans..255

O

CityOrt
sdCountryCode

a2

O

Two characters country code according to ISO 3166Ländercode zweistellig gemäß ISO 3166
sdPhone

ns..32

O

Customer’s phone numberTelefonnummer 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 nameVorname
LastName

ans..100

O

Last nameNachname
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/oAdresszusatz
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 preventionBetrugsprävention
IPAddrans..15M

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

DeviceTokenans..100ODevice token, see external documentation from RatepayGerä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:

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

(info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre 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

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

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

KeyFormatCNDDescriptionBeschreibung
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)
ExternalMessageans..256O

Error text from Ratepay, if agreed with Computop Helpdesk

Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen

ExternalCodeans..64O

Error code from Ratepay, if agreed with Computop Helpdesk

Fehlercode von Ratepay, wenn mit Computop Helpdesk abgesprochen

Installmenta..5OFor IBS: True / False, if installment is allowedBei IBS: True / False, ob installment erlaubt ist
Prepaymenta..5OFor IBS: True / False, if prepayment is allowedBei IBS: True / False, ob prepayment erlaubt ist
Invoicea..5OFor IBS: True / False, if invoice is allowedBei IBS: True / False, ob invoice erlaubt ist
ELVa..5OFor IBS: True / False, if ELV is allowedBei IBS: True / False, ob ELV erlaubt ist
RPTransIDans..50OUnique reference number from RatepayEindeutige 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:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung

Month

ans.255

C

Duration in months. Obligatory for EventToken RT.

Laufzeit in Monaten. Pflicht bei EventToken RT.
Raten..8CMonthly instalment in the smallest currency unit. Obligatory for EventToken RR.Monatliche Rate in kleinster Währungseinheit. Pflicht bei EventToken RR.
FirstDayn..2O

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.

StartDatedttm8OStart date of instalment payment in the format YYYYMMDDStartdatum der Ratenzahlung im Format JJJJMMTT
DueDatedttm8ODue date in the format YYYYMMDDFälligkeitsdatum im Format JJJJMMTT
InterestRaten..5ODebit interest rate, e.g. 1370 for 13,70%Sollzinssatz, zum Beispiel 1370 für 13,70%
EventTokena..2MRT (CalculationbyTime) or RR (CalculationbyRate)RT (CalculationbyTime) oder RR (CalculationbyRate)
Accountans..10OAccount 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:

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

(info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre 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

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

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

KeyFormatCNDDescriptionBeschreibung
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)
ExternalMessageans..256O

Error text from Ratepay, if agreed with Computop Helpdesk

Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen

ExternalCodeans..64O

Error code from Ratepay, if agreed with Computop Helpdesk

Fehlercode von Ratepay, wenn mit Computop Helpdesk abgesprochen

TotalAmountn..10MTotal amount to be financed in the smallest currency unitZu finanzierender Gesamtbetrag in der kleinsten Währungseinheit
InterestAmountn..10MSum of all monthly instalments in the smallest currency unitSumme aller monatlich gezahlten Raten in der kleinsten Währungseinheit
ServiceChargen..10MAdditional financing costs in the smallest currency unitZusätzliche Finanzierungskosten in der kleinsten Währungseinheit
InterestRaten..5MDebit interest rate, e.g. 1370 for 13,70%Sollzinssatz, zum Beispiel 1370 für 13,70%
AnnualPercentageRaten..5MAnnual interest based on ServiceCharge and InterestRateJahreszins basierend auf ServiceCharge und InterestRate
MonthlyDebitInterestn..5MMonthly debit interest based on AnnualPercentageRateMonatlicher Zins basierend auf AnnualPercentageRate
InstallmentNumbern..2MNumber of monthly instalmentsAnzahl Monate der Ratenzahlung
InstallmentAmountn..10MMonthly amount payable in the smallest currency unitMonatlich zu bezahlender Betrag in der kleinsten Währungseinheit
InstallmentLastAmountn..10MAmount of the last rate in the smallest currency unitBetrag der letzten Rate in der kleinsten Währungseinheit
FirstDayn..2O

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:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung

EventTokena..2MRC for RateconfigurationRC für Rateconfiguration
Accountans..10OAccount 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:

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

(info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

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

KeyFormatCNDDescriptionBeschreibung
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

MinRaten..2OMinimum number of instalmentsMindestanzahl der Raten
DefaultRaten..12ODefault rate in the smallest currency unitStandardrate in der kleinsten Währungseinheit
MaxInterestRaten..5OMaximum interest rateMaximaler Zinssatz
MinMonthn..2OMinimum running time in monthsMindestlaufzeit in Monaten
MaxMonthn..2OMaximum running time in monthsMaximallaufzeit in Monaten
MonthLongrunn..2OMinimum running time for a long time financingMindestlaufzeit für eine Langzeitfinanzierung
MonthAllowedans..50OComma-separated list of permissible running times in monthsKommaseparierte Liste mit erlaubten Laufzeiten in Monaten
FirstDayans..20OComma-separated list of permissible start days (1, 15, 28)Kommaseparierte Liste mit möglichen Starttagen (1, 15, 28)
LastRaten..10OMinimum amount for the final instalment in the smallest currency unitMindestbetrag für die Abschlussrate in der kleinsten Währungseinheit
MinRateNormaln..10OMinimum rate in the smallest currency unitMindestrate in der kleinsten Währungseinheit
MinRateLongrunn..10OMinimum rate for a long term financing in the smallest currency unitMindestrate einer Langzeitfinanzierung in der kleinsten Währungseinheit
ServiceChargen..10OAdditional financing costs in the smallest currency unitZusä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)
ExternalMessageans..256O

Error text from Ratepay, if agreed with Computop Helpdesk

Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen

ExternalCodeans..64O

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:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung

RPMethodans..10MType of payment: INVOICE, INSTALLMENT or ELVZahlungsweise: INVOICE, INSTALLMENT oder ELV
ShoppingBasketAmountn..10MTotal 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.)
Accountans..10OAccount identification to use separate logins (SubShops)Account-Kennung, um gesonderte (SubShops) Logins zu nutzen
DeviceTokenans..100ODevice token, see external documentation from RatepayGeräte-Token, siehe externe Dokumentation von Ratepay
ShopSystemans..127OName of the shop systemName des Shop-Systems
ShopSystemVersionans..127OVersion name of the shop systemVersionsname des Shop-Systems
EventTokena..2MR for RateInitR 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 CodeBank Identifier Code. Pflicht bei DirectDebit.
AccBank

ans..27

O

Name of the financial institutionName 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:

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

(info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

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

KeyFormatCNDDescriptionBeschreibung
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)
ExternalMessageans..256O

Error text from Ratepay, if agreed with Computop Helpdesk

Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen

ExternalCodeans..64O

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:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung

Accountans..10OAccount identification to use separate logins (SubShops)Account-Kennung, um gesonderte (SubShops) Logins zu nutzen
EventTokena..2MV for verifyV für verify

Parameter zum Bestätigen einer Ratepay-Zahlung


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

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

(info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

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

KeyFormatCNDDescriptionBeschreibung
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)
ExternalMessageans..256O

Error text from Ratepay, if agreed with Computop Helpdesk

Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen

ExternalCodeans..64O

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:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment to be captured

Vom Paygate vergebene ID für die zu buchende Zahlung

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDDescriptionBeschreibung
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. Submissions with identical ReqID for an open status will be processed regularly. 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 einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Key

Format

CND

Description

Beschreibung

ShoppingBasketans..1024MShopping cart with items to be posted (structure - see ShoppingBasket table)Warenkorb mit den zu buchenden Artikeln (Aufbau siehe Tabelle ShoppingBasket)
ShoppingBasketAmountn..10MTotal 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.)
Discountans..100O

Trans-shopping cart discount

Format: DESCRIPTION; GROSS AMOUNT; VAT

Example: Discount;1000;1900

Warenkorbübergreifender Rabatt.

Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ

Beispiel: Rabatt;1000;1900

ShippingProfileans..100O

Shipping costs

Format: DESCRIPTION; GROSS AMOUNT; VAT

Example: Shipment;500;1900

Versandkosten

Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ

Beispiel: Versand;500;1900

Accountans..10OAccount identification to use separate logins (SubShops)Account-Kennung, um gesonderte (SubShops) Logins zu nutzen
InvoiceIDans..50OInvoice numberRechnungsnummer
TrackingIDans..100O

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!

ShopSystemans..127OName of the shop systemName des Shop-Systems
ShopSystemVersionans..127OVersion name of the shop systemVersionsname des Shop-Systems
EventTokena..2MC for captureC für Capture (Buchung)

Parameter zum Buchen einer Ratepay-Zahlung


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

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

(info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

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

KeyFormatCNDDescriptionBeschreibung
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)
ExternalMessageans..256O

Error text from Ratepay, if agreed with Computop Helpdesk

Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen

ExternalCodeans..64O

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:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDDescriptionBeschreibung
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. Submissions with identical ReqID for an open status will be processed regularly. 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 einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Key

Format

CND

Description

Beschreibung

RPMethodans..10MType of payment: INVOICE, INSTALLMENT or ELVZahlungsweise: INVOICE, INSTALLMENT oder ELV
ShoppingBasketans..1024C

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
ShoppingBasketAmountn..10C

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
Discountans..100O

Trans-shopping cart discount

Format: DESCRIPTION; GROSS AMOUNT; VAT

Example: Discount;1000;1900

Warenkorbübergreifender Rabatt.

Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ

Beispiel: Rabatt;1000;1900

ShippingProfileans..100O

Shipping costs

Format: DESCRIPTION; GROSS AMOUNT; VAT

Example: Shipment;500;1900

Versandkosten

Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ

Beispiel: Versand;500;1900

Accountans..10OAccount identification to use separate logins (SubShops)Account-Kennung, um gesonderte (SubShops) Logins zu nutzen
ShopSystemans..127OName of the shop systemName des Shop-Systems
ShopSystemVersionans..127OVersion name of the shop systemVersionsname des Shop-Systems
EventTokena..2M

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:

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

(info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

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

KeyFormatCNDDescriptionBeschreibung
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)
ExternalMessageans..256O

Error text from Ratepay, if agreed with Computop Helpdesk

Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen

ExternalCodeans..64O

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:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment to be credited

Vom Paygate vergebene ID für die gutzuschreibende Zahlung

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDDescriptionBeschreibung
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. Submissions with identical ReqID for an open status will be processed regularly. 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 einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Key

Format

CND

Description

Beschreibung

ShoppingBasketans..1024MShopping cart with a “CREDIT” item (structure - see ShoppingBasket table)Warenkorb mit einem „CREDIT“-Artikel (Aufbau siehe Tabelle ShoppingBasket)
ShoppingBasketAmountn..10MTotal 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.)
Discountans..100O

Trans-shopping cart discount

Format: DESCRIPTION; GROSS AMOUNT; VAT

Example: Discount;1000;1900

Warenkorbübergreifender Rabatt.

Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ

Beispiel: Rabatt;1000;1900

ShippingProfileans..100O

Shipping costs

Format: DESCRIPTION; GROSS AMOUNT; VAT

Example: Shipment;500;1900

Versandkosten

Format: BEZEICHNUNG;BRUTTOBETRAG;STEUERSATZ

Beispiel: Versand;500;1900

Accountans..10OAccount identification to use separate logins (SubShops)Account-Kennung, um gesonderte (SubShops) Logins zu nutzen
ShopSystemans..127OName of the shop systemName des Shop-Systems
ShopSystemVersionans..127OVersion name of the shop systemVersionsname des Shop-Systems
EventTokena..2MCR for CreditCR für Credit (Gutschrift)

Parameter für Gutschrift einer Ratepay-Zahlung


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

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

(info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

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

KeyFormatCNDDescriptionBeschreibung
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)
ExternalMessageans..256O

Error text from Ratepay, if agreed with Computop Helpdesk

Fehlertext von Ratepay, wenn mit Computop Helpdesk abgesprochen

ExternalCodeans..64O

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.

The table is being loaded. Please wait for a bit ...

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.

The table is being loaded. Please wait for a bit ...

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.2with discount and shippingmit 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.2with discount and shippingmit 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.

The table is being loaded. Please wait for a bit ...

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)

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
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.

The table is being loaded. Please wait for a bit ...

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)

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for this transaction

Vom Paygate vergebene ID für diese Transaktion

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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