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