====== 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  [[girocheckout:general:start#hash_generieren|hash generieren]]|

=== Beispiel ===
{{page>codesamples:rppcheck#rppcheck.request&noheader&nofooter}}

===== 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|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|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 ==
{{page>codesamples:rppcheck#rppcheck.response.true&noheader&nofooter}}

== Beispiel im Fehlerfall ==
{{page>codesamples:rppcheck#rppcheck.response.false&noheader&nofooter}}

==== Antwortcodes ====
{{page>codesamples:returncodes#general&noheader&nofooter}}

== bankaccountValidationResult ==
{{page>codesamples:returncodes#bankaccountValidationResult&noheader&nofooter}}

== rppResult code ==
{{page>codesamples:returncodes#rppResult.code&noheader&nofooter}}