Integration
Grundlagen
FAQ
Apple Pay
Direktüberweisung
eps
Google Pay
iDEAL
Klarna
Kreditkarte
Lastschrift
Maestro
Payment Page
PayPal
Tools
Fehlernummern
Ergebniscode
Testdaten
Seitenleiste
de
enscoring:rppcheck:api
Inhaltsverzeichnis
RPP-Check API
Anfrage
URL: https://payment.girosolution.de/girocheckout/api/v2/scoring/rppcheck
Bereitzustellen von: GiroSolution AG
Aufzurufen von: Händler
Parameter
| Name | Pflicht | Type | Beschreibung |
|---|---|---|---|
| merchantId | Ja | Integer | Händler-ID eines giropay Projekts |
| projectId | Ja | Integer | Projekt-ID eines giropay Projekts |
| bankcode | Ja | String(8) | Bankleizahl der Bankverbindung, die geprüft werden soll |
| bankaccount | Ja | String(10) | Kontonummber der Bankverbindung, die geprüft werden soll |
| hash | Ja | String(32) | HMAC MD5 hash über alle Werte des Aufrufs. Siehe hash generieren |
Beispiel
curl -d "merchantId=1234567" \
-d "projectId=1234" \
-d "bankcode=12345679" \
-d "bankaccount=1234567890" \
-d "hash=d5b5ff6b4880824311dbe7c1a62ff211" \
https://payment.girosolution.de/girocheckout/api/v2/scoring/rppcheck
Antwort
Die Antwort ist ein JSON Objekt. Wenn rc = 0 zurückgeliefert wird, ist das Ergebnis der Abfrage den restlichen Feldern zu entnehmen.
Felder
| Name | Type | Beschreibung |
|---|---|---|
| rc | Integer | Antwortcode |
| msg | String | Zusätzliche Informationen im Fehlerfall |
| bankaccountValidationResult | Integer | Ergebnis der Kontoverbindung Validierung. Siehe bankaccountValidationResult |
| rppMatch | Integer | 0 = kein Eintrag gefunden 1 = RPP Eintrag gefunden, Ergebnis siehe rppResult |
| rppResult | Array | Einhält RPP Einträge, wenn rppMatch = 1 |
rppResult Objekt
| Name | Type | Beschreibung |
|---|---|---|
| code | String | Siehe rppResult code |
| count | Integer | Anzahl der Einträge |
| firstDate | String | Datum der ersten Meldung YYYY-MM-DD |
| lastDate | String | Datum der letzten Meldung YYYY-MM-DD |
Beispiel im Erfolgsfall
{
"rc":0,
"msg":"",
"bankaccountValidationResult":"00",
"rppMatch":"1",
"rppResult":[
{
"code":"7",
"count":"1",
"firstDate":"2012-03-20",
"lastDate":"2012-03-20"
}
]
}
Beispiel im Fehlerfall
{
"rc":"error code",
"msg":error message"",
}
Antwortcodes
| Code | Beschreibung |
|---|---|
| 0 | OK, kein Fehler |
| 5000 | Authentifizierung fehlgeschlagen |
| 5001 | keine Berechtigung |
| 5002 | hash ungültig |
| 5003 | Pflichtfeld nicht angegeben |
| 5004 | Aufruf ungültig |
| 5009 | E-Mail ungültig |
| 5010 | Sprache ungültig |
| 5011 | Land ungültig |
| 5012 | Branche ungültig |
| 5013 | Shopsystem ungültig |
| 5014 | Geschlecht ungültig |
| 5015 | Produkt ungültig |
| 5016 | Organisationstyp ungültig |
| 5017 | Händler existiert bereits |
| 5018 | PSP ungültig |
| 5019 | Kreditkartentyp ungültig |
| 5020 | merchantId ungültig |
| 5021 | projectId ungültig |
| 5022 | merchantTxId ungültig |
| 5023 | purpose ungültig |
| 5024 | bankcode ungültig |
| 5025 | bankaccount ungültig |
| 5026 | bic ungültig |
| 5027 | iban ungültig |
| 5028 | mobile ungültig |
| 5029 | pkn ungültig |
| 5030 | amount ungültig |
| 5031 | Bankleitzahl oder BIC nicht angegeben |
| 5032 | mandateSequence ungültig |
| 5033 | currency ungültig |
| 5034 | Transaktion nicht vorhanden |
| 5035 | Ablaufdatum gesicherte Vorbestellung ungültig |
| 5040 | info1Label ungültig |
| 5041 | info1Text ungültig |
| 5042 | info2Label ungültig |
| 5043 | info2Text ungültig |
| 5044 | info3Label ungültig |
| 5045 | info3Text ungültig |
| 5046 | info4Label ungültig |
| 5047 | info4Text ungültig |
| 5048 | info5Label ungültig |
| 5049 | info5Text ungültig |
| 5050 | recurring ungültig |
| 5051 | mandateReference ungültig |
| 5052 | mandateSignedOn ungültig |
| 5053 | mandateReceiverName ungültig |
| 5054 | issuer ungültig |
| 5055 | urlRedirect ungültig |
| 5056 | urlNotify ungültig |
| 5060 | Betrag oder Währung nicht angegeben |
| 5061 | purposetext ungültig |
| 5062 | paymentreference ungültig |
| 5063 | format ungültig |
| 5064 | resolution ungültig |
| 5065 | Fehler beim erstellen der Grafik |
| 5066 | purpose und paymentreference angegeben |
| 5067 | receiveriban ungültig |
| 5068 | receiverbic ungültig |
| 5069 | purposecode ungültig |
| 5070 | receivername ungültig |
| 5071 | receivername, receiveriban oder receiverbic nicht angeben |
| 5072 | customerLastName ungültig |
| 5073 | customerStreet ungültig |
| 5074 | customerStreetNumber ungültig |
| 5075 | customerZipCode ungültig |
| 5076 | customerCity ungültig |
| 5077 | customerCountry ungültig |
| 5078 | customerBirthDate ungültig |
| 5079 | customerGender ungültig |
| 5080 | customerEmail ungültig |
| 5081 | customerIp ungültig |
| 5082 | customerId ungültig |
| 5083 | shopId ungültig |
| 5084 | customerFirstName ungültig |
| 5085 | accountHolder ungültig |
| 5086 | type ungültig |
| 5087 | Rechnungsnummer (invoiceId) ungültig |
| 5088 | Kundenfirma (shippingCompany) ungültig |
| 5089 | Zusatzinfo (shippingAdditionalAddressInformation) ungültig |
| 5090 | orderId ungültig |
| 5091 | pricemodel ungültig |
| 5092 | shoppingCartType ungültig |
| 5093 | merchantReconciliationReferenceNumber ungültig |
| 5094 | Beschreibung ungültig |
| 5095 | Paypage: Ungültiger Seitentyp |
| 5096 | Paypage: Ungültiges Verfallsdatum |
| 5097 | Paypage: Ungültige Bezahlart(en) |
| 5098 | Paypage: Ungültiger Organisationsname |
| 5099 | Paypage: Ungültiger Wert für Freier Betrag |
| 5100 | Fehler beim Zahlungsabwickler |
| 5101 | Verbindungsproblem zum Zahlungsabwickler |
| 5102 | Pseudo-Kartennummer nicht vorhanden |
| 5103 | Ungültige giropay-MerchantId |
| 5104 | Ungültiger Paypage-Timeout |
| 5105 | TDS20: Ungültige Adresse |
| 5106 | TDS20: Ungültige PLZ |
| 5107 | TDS20: Ungültige Stadt |
| 5108 | TDS20: Ungültiges Land |
| 5109 | TDS20: Ungültige E-Mail |
| 5110 | TDS20: Optional-Feld ungültig |
| 5111 | TDS20: Geben Sie bitte mindestens alle Felder außer Optional an |
| 5112 | TDS20: Sie müssen zu Optional auch die anderen Felder angeben |
| 5113 | Paypage: Ungültiges Format des Hinweistextes (API-Beschreibung beachten) |
| 5114 | Paypage:Referenz muss Payment Page Transaktion sein |
| 5115 | Paypage:Ungültiger DeliveryType |
| 5116 | Paypage:Ungültiges Kassenzeichen |
| 5117 | Paypage:Ungültige backUrl |
| 5118 | Paypage:Ungültige failUrl |
| 5119 | Paypage:Ungültige successUrl |
| 5120 | Paypage:Ungültige notifyUrl |
| 5121 | Paypage: Ungültige merchantOrderReferenceNumber |
| 5122 | Paypage: Ungültiger Wert für qrcodeReturn |
| 5200 | Transaktion nicht akzeptiert |
| 5201 | giropay Bank offline |
| 5202 | giropay Bank des Absenders ungültig |
| 5203 | Bankverbindung des Absenders auf Blacklist |
| 5204 | Bankverbindung des Absenders ungültig |
| 5205 | Transaktionslimit überschritten |
| 5206 | Ungültige Anrede |
| 5207 | Ungültige Telefonnummer |
| 5208 | Ungültiger Warenkorb (basket) |
| 5209 | Ungültige Shipping Info |
| 5210 | Ungültige Adress-Info |
| 5211 | Ungültige Kunden-Info |
| 5500 | Paypage: Ungültiger Wert in festen Beträgen |
| 5501 | Paypage: Ungültiger Mindestbetrag |
| 5502 | Paypage: Ungültiger Maximalbetrag |
| 5503 | Paypage: Ungültige Projektliste |
| 5504 | Paypage: Ungültiger Single-Wert |
| 5505 | Paypage single: Bereits verwendet |
| 5506 | Ungültige URL (CPSP) |
| 5507 | Projekt ist nicht im CPSP-Modus |
| 5508 | Merchant-Limit überschritten (CPSP API) |
| 6001 | Bank unbekannt |
| 6002 | Bank unterstützt kein giropay |
| 7000 | Risikoprüfung positiv |
| 7001 | Risikoprüfung negativ |
| 9999 | interner Fehler |
bankaccountValidationResult
| Code | Beschreibung |
|---|---|
| 00 | Prüfziffer richtig (Kontoverbindung Validierung erfolgreich) |
| 01 | Prüfziffer falsch |
| 02 | Kontonummer ungültig (formale Prüfung) |
| 03 | Kennzahl für Methode ungültig |
| 07 | Regel undefiniert. Nicht vorgesehener Fall bei bestimmten Berechnungsmethoden |
| 09 | Prüfziffer falsch, jedoch Spendenkonto |
| 97 | Unbekannter Fehler |
| 98 | Unbekannte BLZ |
rppResult code
| Code | Beschreibung |
|---|---|
| 000 | Rücklastschrift |
| 001 | Rücklastschrift mangels Deckung / nicht bezahlt |
| 002 | Rücklastschrift, da Konto falsch |
| 003 | Rücklastschrift aufgrund Widerspruch |
| 004 | Rücklastschrift aufgrund Kartenmissbrauch |
| 005 | Rücklastschrift, da Konto erloschen |
| 100 | Historische Rücklastschrift |
| 300 | Institution oder öffentliche Bankverbindung |
| 301 | Kontoverbindung einer Spenden- oder Hilfsorganisation |
| 302 | Kontoverbindung eines Amtes oder öffentliche Einrichtung |
| 303 | Kontoverbindung eines Vereins |
| 304 | Kontoverbindung einer Bildungseinrichtung oder Kirche |
| 305 | Kontoverbindung einer Freizeitinstitution oder Touristik |
| 306 | kontoverbindung eines Verbandes oder Stiftung |
| 307 | Kontoverbindung einer Firma |
| 308 | Kontoverbindung einer Versicherung |
| 309 | Kontoverbindung eines eBay Verkäufers |
| 310 | Kontoverbindung eines eBay Powerseller |
| 500 | Mandantenbezogene Negativliste |
| 600 | Mandantenbezogene Positivliste |
| 700 | KUNO (gestohlene oder verlorene EC Karte) |
| 800 | Sonstige Rücklastschrift |
scoring/rppcheck/api.txt · Zuletzt geändert: 2021/04/12 14:32