Diagrams

This page contains the diagrams presenting the possible flows for an iDEAL QR transaction.

Create iDEAL QR transactions

The CM.com Online Payments API enables you to create either 1 iDEAL QR transaction per request or several iDEAL transactions in a bulk request. The diagram below presents the interaction that takes place between Merchant (You) and CM.com Online Payments API for these iDEAL QR transaction flows:



Create 1 iDEAL QR transaction in 1 request

The CM.com Online Payments API enables you to create an iDEAL QR transaction. The diagram below presents the interaction that takes place between Merchant (You) and CM.com Online Payments API when creating an iDEAL QR transaction:

The diagram below presents the interaction that take place between Consumer, Merchant (You) and CM.com Online Payments API when sharing the created QR code with the consumer:

In the diagrams above the following steps are performed:

  1. Merchant wants to display an iDEAL QR code to its consumers, so that they can pay with it. In order to do this, the Merchant makes a request to create an iDEAL QR transaction.
  2. Merchant receives a successful response with a URL to the created QR Code. This is presented it to the Consumer.
  3. Consumer scans the code with their app of choice to start and complete the payment.
  4. When the status of the iDEAL transaction is updated in the CM.com Online Payments API, the Consumer is redirected to the return URL that the Merchant specified in the original request to create the iDEAL QR transaction.
  5. If the Merchant also specified webhooks in the original request then CM.com Online Payments API will trigger the proper webhooks and make the requests to the webhook URLs specified by the Merchant. When using webhooks, be aware that they are only a "best effort" mechanism.
  6. Merchant gets the latest details of the transaction. This usually happens once the Merchant received a webhook request.

The API endpoints involved on this flow are:


Create several iDEAL QR transactions in 1 request (create transactions in bulk)

The CM.com Online Payments API enables you to create several iDEAL QR transactions in 1 request. The diagram below presents the interaction that takes place between Merchant (You) and CM.com Online Payments API when creating iDEAL QR transactions in bulk:

The API endpoints involved on this flow are:



Create a refund for the payment made with an iDEAL QR transaction

The CM.com Online Payments API enables you to create a refund for a payment made with an iDEAL QR transaction. The diagram below presents the interaction that takes place between Merchant (You) and CM.com Online Payments API when requesting a refund for a payment made with an iDEAL QR transaction:

The API endpoints involved on this flow are: