Payment Methods

EPS

Providers:

aci

ACI
buckaroo

Buckaroo
worldline

Worldline

Worldline

Request example

Payments expiry time for EPS via Worldline is 30 minutes. EPS amounts are expressed in euros; use EUR for the Austrian EPS network.

See also the Worldline EPS documentation for upstream API details. 

                                                            
{
   "id": "7bb6f1f3-d280-4b0c-a74f-90471ea69426", // Auto-generated UUID
   "paymentMethod": "eps",
   "returnUrl": "http://example.com", // URL to return after payment completion.
   "webhookUrl": "https://example.com", // URL to receive webhook notification.
   "transaction":{
      "reference": "test-1111", // Max 20 characters
      "currency": "EUR", // ISO 4217
      "amount": 2000, // Amount in cents, 2000 = 20 EUR. Must match line totals.
      "description": "test-1444",
      "lines":[
         {
            "name": "Some purchase - 20 EUR", // Max 100 characters.
            "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. EPS bank selection and payer steps follow Worldline's hosted checkout test behaviour for product 5406.

  1. Create a test payment with the request example and open the payer URL from the response.
  2. When the EPS bank selector opens, enter BIC STZZATWWXXX to reach the sandbox bank.
  3. On the PSA Bank login screen, sign in with:
    • Login – 1002823
    • Password – EK38]X^=y9uUtf$
    The TAN is displayed on the page after login; complete the payment flow to return to your shop.

For environment setup and test bank flows, coordinate with Paymexx and refer to the Worldline hosted checkout guide.

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.