Quick Guide For Developers
For PHP we provide an example code on GitHub.
Browser initiation (default usage)
To initiate the payment process with QENTA Checkout Page send a POST request to:
The browser receives an HTTP response with the header
Location and redirects to the Checkout Page.
Alternatively, the same request can be sent to
The response is in the following format:
If server-to-server initiation is used then parameters
|In case an error is returned, refer to the error codes listing.|
When defining the request parameters, the URLs leading the consumer back to the shop need to be set.
Payment was successful
Payment process was canceled by the consumer
Payment failed, e.g. due to a wrong 3-D Secure Code
Payment is pending
|Define the confirmURL parameter to get a server-to-server communication of the outcome, regardless of whether the customer is being redirected back to the shop.|
To prevent fraud, check the authenticity of returned data for pending and successful payments by calculating the fingerprint. That is done by concatenating all response parameter values plus the secret in the order defined in the responseFingerprintOrder parameter without any dividers in between and using the secret as a cryptographic key for the hashing function. The resulting fingerprint has to be identical to the value of the response responseFingerprint parameter.
|For a PHP example on how to calculate a fingerprint take a look at our reference implementation at the link QENTA Checkout Client Library.|
Submit the same URL for all four parameters and provide the appropriate content after interpreting the payment process results.