Differences

This shows you the differences between two versions of the page.

--- en:girocheckout:giropay:functions [2013/11/06 03:00]
michaelheumann
+++ en:girocheckout:giropay:functions [2013/11/06 03:32]
michaelheumann
@@ Line 79: / Line 79: @@
 === Reply ===
-Die Antwort ist ein JSON Objekt. Wenn **rc = 0** zurückgeliefert wird, sind die Parameter reference und redirect gesetzt. Leiten Sie den Kunde bitte an die redirect URL weiter.
+The reply is a JSON object. If **rc = 0** is returned, the parameters reference and redirect are set. Please redirect the customer to the redirect URL.
-== Parameter ==
-^Name           ^Pflicht  ^Type      ^Beschreibung   ^
-|rc             |Ja       |Integer   |[[girocheckout:errorcodes|Fehlernummer]] |
-|msg            |Ja       |String    |Zusätzliche Informationen im Fehlerfall |
-|reference      |Optional |String    |Eindeutige GiroCheckout Transaktions-ID |
-|redirect       |Optional |String    |Redirect URL zur Weiterleitung des Kunden |
-== Beispiel im Erfolgsfall ==
+== Parameters ==
+^Name           ^Mandatory ^Type     ^Description   ^
+|rc             |Yes       |Integer   |[[girocheckout:errorcodes|Error Code]] |
+|msg            |Yes       |String    |Additional information in case of error |
+|reference      |Optional  |String    |Unique GiroCheckout transaction ID |
+|redirect       |Optional  |String    |Redirect URL for customer redirection |
+== Example in case of success ==
 {{page>codesamples:giropay#transactionstart.response.true&noheader&nofooter}}
-== Beispiel im Fehlerfall ==
+== Example in case of error ==
 {{page>codesamples:giropay#transactionstart.response.false&noheader&nofooter}}
-===== Benachrichtigung über den Ausgang der Zahlung =====
+===== Payment outcome notification =====
-Nach Beendigung der giropay Zahlung/Altersverifikation erhalten Sie einen GET-Request an die im Parameter //urlNotify// angegebene URL. Bitte nutzen Sie diese Meldung, um z.B. den Status der Bestellung zu ändern und eine Bestellbestätigung zu verschicken. Aufgrund des giropay Ablaufes findet eine Rückleitung des Kunden an die //urlRedirect// nicht automatisch statt, sondern nur nach einem Klick durch den Kunden.
+After completion of the giropay payment or age verification, you receive a GET request to the URL specified in the //urlNotify// parameter. Please use this message for example to change the status of the order and send an order confirmation. Due to the internal giropay process, a redirection of the customer to //urlRedirect// is not done automatically but only after a customer click.
-=== Anfrage ===
+=== Request ===
 **URL:** notifyUrl aus dem Transaktionsstart \\
-**Bereitzustellen von:** Händler \\
+**To be provided by:** Merchant \\
-**Aufzurufen von:** GiroSolution AG
+**To be called by:** GiroSolution AG
-== GET Parameter ==
+== GET Parameters ==
-^Name             ^Pflicht  ^Type        ^Beschreibung   ^
+^Name             ^Mandatory  ^Type        ^Description   ^
-|gcReference      |Ja       |String      |Eindeutige GiroCheckout Transaktions-ID |
+|gcReference      |Yes       |String      |Unique GiroCheckout transaction ID |
-|gcMerchantTxId   |Ja       |String      |Transaktions-ID des Händlers |
+|gcMerchantTxId   |Yes       |String      |Merchant transaction ID |
-|gcBackendTxId    |Ja       |String      |giropay Transaktions-ID |
+|gcBackendTxId    |Yes       |String      |giropay transaction ID |
-|gcAmount         |Ja       |Integer     |Betrag in Cent |
+|gcAmount         |Yes       |Integer     |Amount in cents |
-|gcCurrency       |Ja       |String      |Währung |
+|gcCurrency       |Yes       |String      |Currency |
-|gcResultPayment  |Optional |Integer     |[[girocheckout:resultcodes#zahlungsausgang|Ergebnis der giropay Zahlung]]|
+|gcResultPayment  |Optional |Integer     |[[girocheckout:resultcodes#zahlungsausgang|Result of the giropay payment]]|
-|gcResultAVS      |Optional |Integer     |[[girocheckout:resultcodes#altersverifikation|Ergebnis der giropay Altersverifikation]] |
+|gcResultAVS      |Optional |Integer     |[[girocheckout:resultcodes#altersverifikation|Result of the giropay age verification]] |
-|gcHash           |Ja       |String      |HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
+|gcHash           |Yes       |String      |HMAC MD5 hash on all the values of the function call. See  [[girocheckout:general:start#hash_generieren|generate hash]] |
-=== Antwort ===
+=== Reply ===
-Als Antwort auf den GET-Request wird einer der folgendes HTTP Statuscodes erwartet.
+As a reply to the GET request, one of the following HTTP status codes is expected.
-^HTTP Statuscode    ^Beschreibung     ^
+^HTTP status code    ^Description     ^
-|200 (OK)           |Die Benachrichtigung wurde korrekt verarbeitet. |
+|200 (OK)           |The notification was processed correctly. |
-|400 (Bad Request)  |Der Shop hat die Benachrichtigung nicht verarbeitet, möchte aber auch nicht erneut benachrichtigt werden. |
+|400 (Bad Request)  |The shop did not process the notification and does not wish to be notified again. |
-|Alle anderen       |Die Benachrichtigung wird max. 10 Mal alle 30 Minuten wiederholt, bis der Shop den HTTP Statuscode 200 oder 400 zurückgibt. |
+|All others         |The notification is repeated no more than 10 times every 30 minutes until the shop returns the status code 200 or 400. |
-===== Rückleitung des Kunden zum Shop =====
-Nach Beendigung der giropay Zahlung kann der Kunde über einen Link zurück zum Shop kommen. Diese Rückleitung erfolgt nicht automatisch.
-=== Anfrage ===
+===== Returning the customer to the shop =====
-**URL:** redirectUrl aus dem Transaktionsstart \\
+After completing the giropay payment, the customer may return to the shop through a link. This return is not done automatically.
-**Bereitzustellen von:** Händler \\
-**Aufzurufen von:** GiroSolution AG
-== GET Parameter ==
+=== Request ===
-^Name             ^Pflicht  ^Type        ^Beschreibung   ^
+**URL:** redirectUrl from the transaction beginning \\
-|gcReference      |Ja       |String      |Eindeutige GiroCheckout Transaktions-ID |
+**To be provided by:** Merchant \\
-|gcMerchantTxId   |Ja       |String      |Transaktions-ID des Händlers |
+**To be called by:** GiroSolution AG
-|gcBackendTxId    |Ja       |String      |giropay Transaktions-ID |
-|gcAmount         |Ja       |Integer     |Betrag in Cent |
-|gcCurrency       |Ja       |String      |Währung |
-|gcResultPayment  |Optional |Integer     |[[girocheckout:resultcodes#zahlungsausgang|Ergebnis der giropay Zahlung]]|
-|gcResultAVS      |Optional |Integer     |[[girocheckout:resultcodes#altersverifikation|Ergebnis der giropay Altersverifikation]] |
-|gcHash           |Ja       |String      |HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
+== GET Parameters ==
+^Name             ^Mandatory  ^Type        ^Description   ^
+|gcReference      |Yes       |String      |Unique GiroCheckout transaction ID |
+|gcMerchantTxId   |Yes      |String      |Merchant's transaction ID |
+|gcBackendTxId    |Yes      |String      |giropay transaction ID |
+|gcAmount         |Yes      |Integer     |Amount in cents |
+|gcCurrency       |Yes      |String      |Currency |
+|gcResultPayment  |Optional |Integer     |[[girocheckout:resultcodes#zahlungsausgang|Result of the giropay payment]]|
+|gcResultAVS      |Optional |Integer     |[[girocheckout:resultcodes#altersverifikation|Result of the giropay age verification]] |
+|gcHash           |Ja       |String      |HMAC MD5 hash on all the values of the function call. See  [[girocheckout:general:start#hash_generieren|generate hash]] |

Girocheckout API

User Tools

Site Tools

Differences

Page Tools