Process Overview
The following diagram shows a simplified flow of a possible checkout process with the Payment Page in Redirect mode using a credit card. Depending on your integration and payment method the flow might look different.
The webhook call (4.1) can be configured to happen asynchronously. Alternatively it is also possible to wait for a response from 4.2 before the consumer gets redirected to the merchants webshop again. As a default, the webhook call happens synchronously. Contact us for more details on this topic.
Lifecycle of a transaction
For a complete list of possible transaction status please refer to:
https://api-reference.datatrans.ch/#transaction-status
Fore a more detailed description of all the available status codes check out the API Reference
Important parameters
During a transaction (no matter what kind of integration you choose) pay special attention to the following parameters.
| Parameter name | Example value | Description |
|---|---|---|
merchantId | 1100004624 | The merchantId which is assigned when creating a test account. |
refno | 13371337 | A unique reference number to identify your purchase. |
uppTransactionId | 180507102102736128 | The transactionId returned in steps 4.1 and 6 (see diagram above). Save the transactionId in your database. It can be used later to invoke other APIs such as the Status API |
Updated over 5 years ago