Payment Methods

Providers

Worldline iDEAL

Request example

Payments expiry time for iDEAL via Worldline is 30 minutes. Amounts must be in EUR for the Dutch iDEAL network.

Bank selection is handled on Worldline's hosted checkout. The optional ideal.issuerId field is deprecated upstream but may still pre-select a bank when provided. See the Worldline iDEAL documentation.

                                                            
{
   "id": "7bb6f1f3-d280-4b0c-a74f-90471ea69426",
   "paymentMethod": "ideal",
   "returnUrl": "http://example.com",
   "webhookUrl": "https://example.com",
   "transaction":{
      "reference": "test-1111",
      "currency": "EUR",
      "amount": 2000,
      "description": "test-1444",
      "lines":[
         {
            "name": "Some Voucher - 20 EUR",
            "category": "PREPAID-VOUCHER",
            "brand": "alphacomm",
            "quantity": 1,
            "amount": 2000
         }
      ]
   },
   "provider": "Worldline"
}
                                                            
                                                        

Worldline sandbox

Use Worldline pre-production (payment.preprod.direct.worldline-solutions.com) with test API credentials configured on the merchant. Sandbox in case of Wero|Ideal is only page with info and redirect button which will return to us with success status of payment. So to test other statuses, the mocResponse parameter can be used, so the request should contain

                                                            
"mocResposne": "worldline_failed"  // for failed status
"mocResposne": "worldline_cancel" // for cancelled status
                                                        

Merchant configuration

  • merchantId – Worldline merchant identifier (set by devs)
  • apiKey – Worldline API key for GCS v1HMAC authentication (set by devs)
  • apiSecret – Worldline API secret for request signing (set by devs)

Server-to-server calls use GCS v1HMAC signing. Credentials are stored per merchant and are not sent in the create-payment API request.