Paydirekt

Detailed information regarding Transaction types.

A successful initialization generates a reference number and a redirect link, which are both returned to the merchant. The redirect link will lead the customer to the payment form, so the merchant must ensure the proper redirection. This may be accomplished through an HTTP redirect header, an HTML page with a corresponding meta tag or via Javascript.

Provided by: GiroCheckout
Called by: Merchant

1. Customer chooses payment method Paydirekt
2. Shop initiates Paydirekt transaction (Initialization)
3. GiroCheckout initializes transaction at Paydirekt
4. Paydirekt sends result to GiroCheckout
5. Shop receives feedback on initialization result (transaction ends on error)
6. Shop sends redirect URL to customer browser
7. Customer browser redirects to Paydirekt
8. Paydirekt display payment form
9. Customer authorizes transaction
10. Paydirekt carries out the transaction
11. Paydirekt transmits result to GiroCheckout
12. GiroCheckout informs Shop about transaction result (Notification)
13. Shop processes transaction result
14. Shop sends HTTP status code to GiroCheckout
15. GiroCheckout sends merchant return address to Paydirekt
16. Customer clicks “Back to Shop” (Return)

URL: https://payment.girosolution.de/girocheckout/api/v2/transaction/start

JSON Array with item objects:

[ {
    "name" : "Kids bike",
    "ean" : "800001303",
    "quantity" : 3,
    "grossAmount" : 2599
  }, {
    "name" : "Helmet",
    "quantity" : 1,
    "grossAmount" : 1853
  } ]

The response is a JSON object. The field rc returns an error code. If rc = 0 is returned, the transaction was successfully initialized. You will receive a transaction number and the redirect URL leading to the Paydirekt payment confirmation page in the response.

The result of a payment is transmitted to the URL specified in the urlNotify parameter. This notification serves the purpose of informing the merchant about the outcome of the transaction. This enables the merchant to update his transaction status.

The result of the transaction's payment is contained in the field gcResultPayment.

URL: notifyUrl from transaction initialization
Provided by: Merchant
Called by: GiroCheckout

As a response to the GET request, one of the following HTTP status codes is expected.

Once the payment is finished, the customer may return to the merchant via a link. A redirection does not take place until the customer has clicked the “Cancel” or “Return to Shop” button. This redirect is not done automatically.

URL: redirectUrl from transaction initialization
Provided by: Merchant
Called by: GiroCheckout

These transactions refer to a previous transaction. They are based on a server to server communication and require no customer intervention (in terms if data entry).

Provided by: GiroCheckout
Called by: Merchant

1. Shop sends referencing transaction
2. GiroCheckout routes transaction to Paydirekt
3. Paydirekt transmits result to GiroCheckout
4. Shop receives reply regarding transaction result (Notification)

CAPTURE URL: https://payment.girosolution.de/girocheckout/api/v2/transaction/capture
REFUND URL: https://payment.girosolution.de/girocheckout/api/v2/transaction/refund

The response is a JSON object. The field resultPayment returns an error code. If resultPayment = 4000 is returned, the transaction was carried out successfully. You receive a transaction number in the reply.

URL VOID: https://payment.girosolution.de/girocheckout/api/v2/transaction/void

The reply is a JSON encoded string. The field rc contains the response code. If it is 0 the call was successful. The response includes a transaction number and other information.