Über Ratepay
Allgemeines zu Ratepay
| Logo |
|
|---|---|
| Info | Ratepay bietet Payment-Lösungen für Rechnungskauf, Ratenzahlung und Lastschriftverfahren, übernimmt dabei die gesamte Ab-wicklung sowie das komplette Risiko von Zahlungsausfällen. |
| Typ | Zahlungen per Rechnungs- und Ratenkauf |
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
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:
- Client-ID: Benutzername für die Verbindung zur Ratepay-API
- Client-Geheimnis: Passwort für die Verbindung zur Ratepay-API
- Partner Shop ID: Die Ihnen von Ratepay zugewiesene eindeutige Kennung
- Wenden Sie sich an den Computop Helpdesk, um Ratepay als Zahlungsmethode zu aktivieren, und geben Sie die oben genannten Daten sicher an.
Paygate-Schnittstelle
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) CND Bedingung (condition) M Pflicht (mandatory) O optional C bedingt (conditional) Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.Definitionen
Datenformate
Format Beschreibung Abkürzungen
Abkürzung Beschreibung Kommentar Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist
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:
https://www.computop-paygate.com/ratepay.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp. Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter für Ratepay-Zahlungen
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:
es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
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:
https://www.computop-paygate.com/increment.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp. Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter für die Erhöhung von Ratepay-Zahlungen
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
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:
https://www.computop-paygate.com/capture.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp. Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter zum Buchen einer Ratepay-Zahlung
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
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:
https://www.computop-paygate.com/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).
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:
Parameter für Storno / Änderung einer Ratepay-Zahlung
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Antwort-Parameter bei Storno / Änderung einer Ratepay-Zahlung
Gutschrift von Ratepay-Zahlungen
Um eine Zahlungstransaktion mit Ratepay gutzuschreiben, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/credit.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp. Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter für Gutschrift einer Ratepay-Zahlung
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Antwort-Parameter bei Gutschrift einer Ratepay-Zahlung
Erläuterung zum Parameter ShoppingBasket
Folgende Tabelle beschreibt die einzelnen Werte innerhalb des ShoppingBasket:
Parameter innerhalb des Warenkorbes
[
{
"shoppingBasketAmount": 7350,
"items": [
{
"artNr": 37,
"category": "Electronics",
"descriptionAddition": "desc 1",
"discount": -50,
"name": "High-performance laptop",
"unitPriceGross": 2500,
"quantity": 1,
"taxRate": 0.04,
"unit": "pcs"
},
{
"artNr": 38,
"category": "Accessories",
"descriptionAddition": "desc 1",
"discount": -50,
"name": "Wireless gaming mouse",
"unitPriceGross": 2500,
"quantity": 2,
"taxRate": 0.04,
"unit": "pcs"
}
],
"vats": [
{
"netAmount": 7200,
"taxAmount": 300,
"taxRate": 0.04
}
]
}
]