Table of Contents

Über Ratepay

Allgemeines zu Ratepay

Page properties

Logo

Info

Excerpt
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

Ratepay ist ein Whitelabel-Online-Dienstleister, der Händlern ermöglicht, ihren Kunden sichere und gängige Zahlungsmethoden anzubieten.Ratepay unterstützt folgende Zahlungsmethoden:

Rechnung – Mit der Zahlungsmethode Rechnung können Kunden Waren oder Dienstleistungen auf Rechnung kaufen und später bezahlen.Bei Zahlung per Rechnung erhalten Kunden eine Rechnung mit detaillierten Angaben zu Betrag, Zahlungsbedingungen und Fälligkeitsdatum.
Wenn ein Kunde an der Kasse Rechnung wählt, führt Ratepay eine Risikoprüfung in Echtzeit aus. Der Vorteil der Zahlungsmethode Rechnung liegt in der Verbesserung des Cashflows sowohl für Käufer als auch für Händler:
- für Käufer: Sie können Waren oder Dienstleistungen erwerben, ohne sofort bezahlen zu müssen, was sich positiv auf ihre Finanzen auswirkt.
- für Händler: Mit Ratepay profitieren Sie als Händler von einem umfassenden Service für den Rechnungskauf.Sie übermitteln alle Rechnungsdaten während der Bestellung an Ratepay, das die komplette Rechnungsstellung und das Debitorenmanagement übernimmt.Als Händler erhalten Sie eine Zahlungsgarantie.
SEPA-Lastschrift – Ratepay bietet sowohl den klassischen Ratenkauf als auch das SEPA-Lastschriftverfahren an.Das SEPA-Lastschriftverfahren ist eine Zahlungsmethode, die es Händlern ermöglicht, Zahlungen von Käufern, die ihnen die entsprechende Erlaubnis erteilt haben, direkt von deren Bankkonto über deren IBAN einzuziehen.

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

Diagramm zum Prozessablauf

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	ProcessFlow_RatepayV2
DisableCaching	true
PageWithExcerpt	EN:Ratepay V2

Ratepay Prozessablauf

Erste Schritte

Um Ratepay-Zahlungsmethoden zu akzeptieren, registrieren Sie sich zunächst bei Ratepay.
Nach der Registrierung erhalten Sie von Ratepay die folgenden Informationen:
1. Client-ID: Benutzername für die Verbindung zur Ratepay-API
2. Client-Geheimnis: Passwort für die Verbindung zur Ratepay-API
3. Partner Shop ID: Die Ihnen von Ratepay zugewiesene eindeutige Kennung
Wenden Sie sich an den
Multiexcerpt include
SpaceWithExcerpt DE
MultiExcerptName Helpdesk-Name
PageWithExcerpt Wording
, um Ratepay als Zahlungsmethode zu aktivieren, und geben Sie die oben genannten Daten sicher an.

Multiexcerpt include
SpaceWithExcerpt DE
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
-Schnittstelle

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Definition
PageWithExcerpt	Definition DE

Ratepay-Zahlung auslösen

Sobald der Kunde zur Kasse geht, wird eine Liste der verfügbaren Ratepay-Zahlungsmethoden angezeigt.Sobald der Kunde mit der Ratepay-Zahlungsmethode bezahlt, muss Ihr Backend einen Server-zu-Server-Aufruf an die folgende URL senden, um eine Zahlungsanforderung zu stellen:

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

ratepay.aspx

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

table-filterjoiner

isOR

inversedateFormat	false
default	Description
dd M yy
export-word	false
show-sourceisFirstTimeEnter	false
hideColumnsexport-csv	truefalse
sparkNameid	Sparkline1771577737347_569439534
hidePane	true
datepattern	dd M yy
transpose	false	id	1645521776944_878657835
worklog	365\|5\|8\|y w d h m\|y w d h m
AND	separator	Point (.)
orderexport-pdf	0false

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	ratepayv2_initiate_request
PageWithExcerpt	EN:Ratepay V2

Parameter für Ratepay-Zahlungen

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1645522318672_-716660563
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	ratepayv2_initiate_response
PageWithExcerpt	EN:Ratepay V2

Antwort-Parameter für Ratepay-Zahlungen

Inkrementelle Autorisierung

Diese Funktion erhöht den Betrag einer zuvor autorisierten Transaktion.Sie können den ursprünglich autorisierten Betrag maximal um 30 % oder um 300 € erhöhen, je nachdem, welcher Betrag niedriger ist.Sie können für die ursprüngliche Transaktion nur eine zusätzliche Autorisierungsanfrage senden.Um eine Zahlungstransaktion mit Ratepay zu erhöhen, verwenden Sie bitte die folgende URL

sql	SELECT * FROM T*

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Amount
page	Amount
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	ReqId-ans..32
page	ReqId
type	page

Key	Format	CND	Beschreibung
OrderDesc	ans..768	O	Beschreibung der gekauften Waren
bdFirstName	ans..100	C	Vorname des Kunden, dem die Rechnung ausgestellt wird.Bei B2B-Transaktionen sollte dies die Kontaktperson im Unternehmen sein.Erforderlich für B2C.Optional für B2B.
bdLastName	ans..100	C	Nachname des Kunden, dem die Rechnung ausgestellt wird.Bei B2B-Transaktionen sollte dies die Kontaktperson im Unternehmen sein.Erforderlich für B2C.Optional für B2B.
bdStreet	ans..100	M	Straßenname der Rechnungsadresse
bdStreetNr	ans..30	O	Hausnummer der Rechnungsadresse
bdStreetAddition	ans..50	O	Zusätzliche Informationen zur Rechnungsadresse
bdCity	ans..100	M	Ort der Rechnungsadresse
bdCountryCode	ans..2	M	Ländercode der Rechnungsadresse
bdZIP	ans..10	M	Postleitzahl der Rechnungsadresse
Title	ans..45	O	Titel des Kunden
DateOfBirth	ans..10	C	Geburtsdatum des Kunden im Format JJJJ-MM-TT.Erforderlich für B2C.
bdCompanyName	ans..100	C	Firmenname.Erforderlich für B2B-Transaktionen.
VatID	ans..25	O	Umsatzsteuer-Identifikationsnummer des Unternehmens.Relevant für B2B-Transaktionen.
Email	ans..100	M	E-Mail-Adresse des Kunden
Phone	ans..60	M	Telefonnummer des Kunden
Language	ans..2	O	Die Sprache, in der der Käufer die Kommunikation bevorzugt.Wird die gewünschte Sprache nicht unterstützt, erfolgt die Kommunikation mit dem Käufer auf Deutsch.Muss ISO 639-1 alpha 2 entsprechen.
CustomerID	an..100	O	Eindeutige Kunden-ID aus Ihrem System
sdFirstName	ans..100	C	Vorname in der Lieferadresse.Bei B2B-Geschäften sollte es der Ansprechpartner im Unternehmen sein.
sdLastName	ans..100	C	Nachname in der Lieferadresse.Bei B2B-Geschäften sollte es der Ansprechpartner im Unternehmen sein.
sdCompanyName	ans..100	C	Firmenname
sdStreet	ans..100	M	Straßenname der Lieferadresse
sdStreetHouseNumber	ans..30	O	Hausnummer der Lieferadresse
sdStreetAddition	ans..50	O	Zusätzliche Informationen zur Lieferadresse
sdCity	ans..100	M	Ort der Lieferadresse
sdCountryCode	ans..2	M	Ländercode der Lieferadresse
sdZIPCode	ans..10	M	Postleitzahl der Lieferadresse
IPAddr	ans..39	O	IP-Adresse des Kundengeräts
DeviceToken	ans..255	O	Geräte-Token
Channel	enum	O	Der Vertriebskanal, aus dem die Transaktion stammt: „WEBSHOP“, „POINT_OF_SALE“, „PHONE_OR_MAIL“
BIC	ans..50	O	Bankleitzahl
IBAN	ans..34	C	Internationale Bankkontonummer.Obligatorisch, wenn DebitPayType SEPA_DIRECT_DEBIT ist.
AccOwner	ans..100	C	Name des Kontoinhabers.Obligatorisch, wenn DebitPayType SEPA_DIRECT_DEBIT ist.
RPMethod	enum	M	Die vom Käufer gewählte Zahlungsoption: „OPEN_INVOICE“, „PAY_NOW“
DebitPayType	enum	M	Die vom Käufer gewählte Überweisungsart: „BANK_TRANSFER“, „SEPA_DIRECT_DEBIT“
shoppingBasket	JSON	M	Warenkorb.Informationen zur Struktur finden Sie weiter unten bei Shopping Basket. Muss Base64-kodiert gesendet werden.

Parameter für Ratepay-Zahlungen

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1771577760062_-2104321635
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MID
page	mid
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	PayID
page	PayID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	XID
page	XID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key	Format	CND	Beschreibung
AuthorizationExpiry	dttm	C	Datum und Uhrzeit der automatischen Stornierung des verbleibenden, nicht stornierten und nicht gebuchten autorisierten Betrags.Zeitstempel mit Offset gemäß ISO 8601. Nur für erfolgreiche HTTP 201-Antworten verfügbar.
BankName	ans..127	C	Bankname des Bankkontos, auf das der Kunde das Geld überweisen muss.Wird nur bereitgestellt, wenn DebitPayType in der Anfrage als BANK_TRANSFER gesendet wird.
BIC	ans..50	C	BIC des Bankkontos, auf das der Kunde das Geld überweisen muss.Wird nur bereitgestellt, wenn DebitPayType in der Anfrage als BANK_TRANSFER gesendet wird.
IBAN	ans..34	C	IBAN des Bankkontos, auf das der Kunde das Geld überweisen muss.Wird nur bereitgestellt, wenn DebitPayType in der Anfrage als BANK_TRANSFER gesendet wird.
AccOwner	ans..100	C	Kontoinhaber des Bankkontos, auf das der Kunde das Geld überweisen muss.Wird nur bereitgestellt, wenn DebitPayType in der Anfrage als BANK_TRANSFER gesendet wird.
RatepayPaymentReference	ans..127	C	Anzugebender Zweck in der Überweisung (von Ratepay generiert). Wird nur bereitgestellt, wenn DebitPayType in der Anfrage als BANK_TRANSFER gesendet wird.
ExternalDeclineCategory	ans..	C	Ablehungskategorie. Details finden Sie unter Decline Categories.
ExternalMessage	ans..256	C	Eine Meldung, die beschreibt, welche Einschränkung verletzt wurde
ExternalCodes	ans..64	C	Liste mit keinem, einem oder mehreren Ablehnungsgründen für die Anfrage.Unter Decline Categories finden Sie Informationen zu möglichen Gründen für jede Ablehnungskategorie.
RPTransID	ans..50	M	ID der von Ratepay während der Autorisierung generierten Transaktion.Sowohl für akzeptierte als auch für abgelehnte Transaktionen wird eine Transaktions-ID generiert.

Antwort-Parameter für Ratepay-Zahlungen

Inkrementelle Autorisierung

Diese Funktion erhöht den Betrag einer zuvor autorisierten Transaktion.Sie können den ursprünglich autorisierten Betrag maximal um 30 % oder um 300 € erhöhen, je nachdem, welcher Betrag niedriger ist.Sie können für die ursprüngliche Transaktion nur eine zusätzliche Autorisierungsanfrage senden.Um eine Zahlungstransaktion mit Ratepay zu erhöhen, verwenden Sie bitte die folgende URL:

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

increment.aspx

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1771577774272_45600203
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	PayID
page	PayID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Amount
page	Amount
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Key	Format	CND	Beschreibung
items	JSON	O	Artikelliste.Die Struktur finden Sie unten bei Shopping Basket, nur der Artikelteil. Muss Base64-kodiert gesendet werden.
vats	JSON	O	MwSt.-Informationen. Die Struktur finden Sie unten bei Shopping Basket, nur der MwSt.-Teil. Muss Base64-kodiert gesendet werden.

Parameter für die Erhöhung von Ratepay-Zahlungen

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1771577787090_1293905276
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MID
page	mid
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	PayID
page	PayID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	XID
page	XID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key	Format	CND	Beschreibung
ExternalDeclineCategory	ans..	C	Ablehungskategorie. Details finden Sie unter Decline Categories.
ExternalMessage	ans..256	C	Eine Meldung, die beschreibt, welche Einschränkung verletzt wurde
ExternalCodes	ans..64	C	Liste mit keinem, einem oder mehreren Ablehnungsgründen für die Anfrage.Unter Decline Categories finden Sie Informationen zu möglichen Gründen für jede Ablehnungskategorie.
RPTransID	ans..50	M	Von Ratepay generierte ID der bestätigten Autorisierung

Antwort-Parameter für die Erhöhung von Ratepay-Zahlungen

Ratepay-Zahlung buchen

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

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

capture.aspx

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1771579254436_-269730004
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	PayID_Capture
page	PayID
type	page

Key	Format	CND	Beschreibung
TransID	ans..64	O	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Amount
page	Amount
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Key	Format	CND	Beschreibung
items	JSON	O	Artikelliste.Die Struktur finden Sie unten bei Shopping Basket, nur der Artikelteil. Muss Base64-kodiert gesendet werden.
vats	JSON	O	MwSt.-Informationen. Die Struktur finden Sie unten bei Shopping Basket, nur der MwSt.-Teil. Muss Base64-kodiert gesendet werden.

Parameter zum Buchen einer Ratepay-Zahlung

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1771577814304_984754626
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MID
page	mid
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	PayID
page	PayID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	XID
page	XID
type	page

Key	Format	CND	Beschreibung
TransID	ans..64	O	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key	Format	CND	Beschreibung
ExternalDeclineCategory	ans..	C	Ablehungskategorie. Details finden Sie unter Decline Categories.
ExternalMessage	ans..256	C	Eine Meldung, die beschreibt, welche Einschränkung verletzt wurde
ExternalCodes	ans..64	C	Liste mit keinem, einem oder mehreren Ablehnungsgründen für die Anfrage.Unter Decline Categories finden Sie Informationen zu möglichen Gründen für jede Ablehnungskategorie.
RPCaptureID	ans..50	M	ID der von Ratepay zur Buchung generierten Transaktion

Antwort-Parameter beim Buchen einer Ratepay-Zahlung

Storno / Rückgabe von Ratepay-Zahlungen

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

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

reverse.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).

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1771577826796_-1064406466
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	PayID_Reverse
page	PayID
type	page

Key	Format	CND	Beschreibung
TransID	ans..64	O	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Amount
page	Amount
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Key	Format	CND	Beschreibung
items	JSON	O	Artikelliste.Die Struktur finden Sie unten bei Shopping Basket, nur der Artikelteil. Muss Base64-kodiert gesendet werden.
vats	JSON	O	MwSt.-Informationen. Die Struktur finden Sie unten bei Shopping Basket, nur der MwSt.-Teil. Muss Base64-kodiert gesendet werden.

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

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1771577839119_1902935718
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MID
page	mid
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	PayID
page	PayID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	XID
page	XID
type	page

Key	Format	CND	Beschreibung
TransID	ans..64	O	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key	Format	CND	Beschreibung
ExternalDeclineCategory	ans..	C	Ablehungskategorie. Details finden Sie unter Decline Categories.
ExternalMessage	ans..256	C	Eine Meldung, die beschreibt, welche Einschränkung verletzt wurde
ExternalCodes	ans..64	C	Liste mit keinem, einem oder mehreren Ablehnungsgründen für die Anfrage.Unter Decline Categories finden Sie Informationen zu möglichen Gründen für jede Ablehnungskategorie.
RPCancellationID	ans..50	M	ID der von Ratepay zur Stornierung generierten Transaktion

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

Gutschrift von Ratepay-Zahlungen

Um eine Zahlungstransaktion mit Ratepay gutzuschreiben, verwenden Sie bitte folgende URL:

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

credit.aspx

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1771577854550_733144807
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	PayID_Credit
page	PayID
type	page

Key	Format	CND	Beschreibung
TransID	ans..64	O	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Amount
page	Amount
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Key	Format	CND	Beschreibung
items	JSON	O	Artikelliste.Die Struktur finden Sie unten bei Shopping Basket, nur der Artikelteil. Muss Base64-kodiert gesendet werden.
vats	JSON	O	MwSt.-Informationen. Die Struktur finden Sie unten bei Shopping Basket, nur der MwSt.-Teil. Muss Base64-kodiert gesendet werden.

Parameter für Gutschrift einer Ratepay-Zahlung

:

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

increment.aspx

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1748339647503_374475284
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	ratepayv2_increment_request
PageWithExcerpt	EN:Ratepay V2

Parameter für die Erhöhung von Ratepay-Zahlungen

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1748340342463_152847178
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	ratepayv2_increment_response
PageWithExcerpt	EN:Ratepay V2

Antwort-Parameter für die Erhöhung von Ratepay-Zahlungen

Ratepay-Zahlung buchen

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

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

capture.aspx

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1645523777447_1488339166
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	ratepayv2_capture_request
PageWithExcerpt	EN:Ratepay V2

Parameter zum Buchen einer Ratepay-Zahlung

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1645523813709_1391300670
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	ratepayv2_capture_response
PageWithExcerpt	EN:Ratepay V2

Antwort-Parameter beim Buchen einer Ratepay-Zahlung

Storno / Rückgabe von Ratepay-Zahlungen

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

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

reverse.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).

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RequestResponse_Intro
PageWithExcerpt	Reuse API

table-filterjoiner

inversedateFormat	false
default	Description
dd M yy
export-word	false
show-sourceisFirstTimeEnter	false
hideColumnsexport-csv	truefalse
sparkNameid	Sparkline1771577867436_49447460
hidePane	true
datepattern	dd M yy
id	1645525945774_-562256828
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
isORseparator	AND.
separator	Point (.)
order	0
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt

multiexcerpt

-include

SpaceWithExcerpt

isFirstTimeEnter

EN

true

MultiExcerptName

ratepayv2_cancel_request

PageWithExcerpt

EN:Ratepay V2

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

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1645525980386_-2143659602
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	ratepayv2_cancel_response
PageWithExcerpt	EN:Ratepay V2

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

Gutschrift von Ratepay-Zahlungen

Um eine Zahlungstransaktion mit Ratepay gutzuschreiben, verwenden Sie bitte folgende URL:

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

credit.aspx

static	true
v	2
name	MID
page	mid
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	PayID
page	PayID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	XID
page	XID
type	page

Key	Format	CND	Beschreibung
TransID	ans..64	O	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key	Format	CND	Beschreibung
ExternalDeclineCategory	ans..	C	Ablehungskategorie. Details finden Sie unter Decline Categories.
ExternalMessage	ans..256	C	Eine Meldung, die beschreibt, welche Einschränkung verletzt wurde
ExternalCodes	ans..64	C	Liste mit keinem, einem oder mehreren Ablehnungsgründen für die Anfrage.Unter Decline Categories finden Sie Informationen zu möglichen Gründen für jede Ablehnungskategorie.
RPRefundID	ans..50	M	ID der von Ratepay zur Gutschrift generierten Transaktion

Antwort-Parameter bei Gutschrift einer Ratepay-Zahlung

Erläuterung zum Parameter ShoppingBasket

Folgende Tabelle beschreibt die einzelnen Werte innerhalb des ShoppingBasket:

Key	Format	CND	Beschreibung
shoppingBasketAmount	n..10	M	Der Warenkorbbetrag inklusive Mehrwertsteuer in der Währung der Transaktion.shoppingBasketAmount = Summe aller Artikel für ((unitPriceGross+discount) * quantity).Hinweis: Da der Rabatt ein negativer Betrag ist, wird durch die obige Addition der Rabatt tatsächlich vom unitPriceGross abgezogen.
items.artNr	ans..255	O	Artikelnummer des Artikels, z.B. SKU. Sie darf nicht ausschließlich Leerzeichen enthalten.
items.category	ans..511	O	Kategorie für den Artikel
items.descriptionAddition	ans	O	Beschreibung des Artikels
items.discount	ans	O	Bruttorabatt auf einen Artikel nach Steuern. Das muss ein negativer Wert sein.Beispiel: Für einen Rabatt von 20,55 geben Sie -2055 ein.
items.name	string	M	Name des Artikels
items.unitPriceGross	n..10	M	Bruttowert eines Artikels nach Steuern. Für einem Wert von 100,00 € geben Sie 10000 ein.
items.quantity	n..	M	Bestellte Menge des Artikels
items.taxRate	decimal	M	Für den Artikel geltender Steuersatz in Prozent. Geben Sie diesen Wert mit maximal zwei Dezimalstellen an. Zum Beispiel sollte 15,55 % als 15,55 angegeben werden.
items.unit	ans..255	O	Beliebige Maßeinheit des Artikels, z.B. kg, Liter, Stück
vats.netAmount	n..10	M	Betrag vor Steuern für alle Artikel
vats.taxAmount	n..10	M	Gesamtsteuerbetrag für alle Artikel zum angegebenen Steuersatz.Für einen Wert von 100,00 geben Sie 10000 ein.
vats.taxRate	decimal	M	Steuersatz als Prozentsatz auf den Nettobetrag. Geben Sie diesen Wert mit maximal zwei Dezimalstellen an. Beispielsweise sollte 15,55 % als 15,55 gesendet werden.

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1645526561173_1598286986
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	ratepayv2_credit_request
PageWithExcerpt	EN:Ratepay V2

Parameter für Gutschrift einer Ratepay-Zahlung

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1645526591380_77792343
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	ratepayv2_credit_response
PageWithExcerpt	EN:Ratepay V2

Antwort-Parameter bei Gutschrift einer Ratepay-Zahlung

Erläuterung zum Parameter ShoppingBasket

Folgende Tabelle beschreibt die einzelnen Werte innerhalb des ShoppingBasket:

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1645526628430_1715409316
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNameratepayv2_shoppingbasketPageWithExcerptEN:Ratepay V2

Parameter innerhalb des Warenkorbes

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	ratepayv2_shoppingbasket_example
PageWithExcerpt	EN:Ratepay V2

Space shortcuts

Page tree

Versions Compared

Old Version 2

New Version Current

Key

Über Ratepay

Allgemeines zu Ratepay

Diagramm zum Prozessablauf

Erste Schritte

Multiexcerpt include
SpaceWithExcerpt DE
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
-Schnittstelle

Ratepay-Zahlung auslösen

Inkrementelle Autorisierung

Inkrementelle Autorisierung

Ratepay-Zahlung buchen

Storno / Rückgabe von Ratepay-Zahlungen

Gutschrift von Ratepay-Zahlungen

Ratepay-Zahlung buchen

Storno / Rückgabe von Ratepay-Zahlungen

Gutschrift von Ratepay-Zahlungen

Erläuterung zum Parameter ShoppingBasket

Erläuterung zum Parameter ShoppingBasket

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 2

New Version Current

Key

Über Ratepay

Allgemeines zu Ratepay

Diagramm zum Prozessablauf

Erste Schritte

Multiexcerpt includeSpaceWithExcerptDEMultiExcerptNamePlatform-KurzPageWithExcerptWording-Schnittstelle

Ratepay-Zahlung auslösen

Inkrementelle Autorisierung

Inkrementelle Autorisierung

Ratepay-Zahlung buchen

Storno / Rückgabe von Ratepay-Zahlungen

Gutschrift von Ratepay-Zahlungen

Ratepay-Zahlung buchen

Storno / Rückgabe von Ratepay-Zahlungen

Gutschrift von Ratepay-Zahlungen

Erläuterung zum Parameter ShoppingBasket

Erläuterung zum Parameter ShoppingBasket

Multiexcerpt include
SpaceWithExcerpt DE
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
-Schnittstelle