Skip to main content
Worldline TravelHub provides iDEAL payments through a redirect flow for buyers in the Netherlands.

​
Setup

Please follow the common Worldline instructions to get set up with iDEAL via TravelHub. After setting up your TravelHub account, make sure iDEAL is enabled as a payment method on your account. TravelHub requires the billing country (address.country) for iDEAL transactions.

​
Capabilities

​
Supported countries

​
Supported currencies

​
Captures and refunds

As iDEAL transactions can take up to 48 hours to be marked as paid, refunds cannot be processed until the transaction reaches that state. Transactions marked as Captured in the system might not be refundable until this point.

​
Integration

The default integration for iDEAL via TravelHub uses a redirect to a payments page hosted by Gr4vy. Start by creating a new transaction with the following required fields. 
var transaction = await client.Transactions.CreateAsync(
	transactionCreate: new TransactionCreate()
	{
		Amount = 1299,
		Currency = "EUR",
		Country = "NL",
		PaymentMethod =
			TransactionCreatePaymentMethod.CreateRedirectPaymentMethodCreate(
				new RedirectPaymentMethodCreate()
				{
					Method = "ideal",
					Country = "NL",
					Currency = "EUR",
					RedirectUrl = "https://example.com/callback",
				}
			),
	}
);
After the transaction is created, the API response includes payment_method.approval_url and the buyer_approval_pending status. 
{
	"type": "transaction",
	"id": "ea1efdd0-20f9-44d9-9b0b-0a3d71e9b625",
	"payment_method": {
		"type": "payment-method",
		"approval_url": "https://cdn.sandbox.spider.gr4vy.app/connectors/worldline/apm.html?token=..."
	},
	"method": "ideal"
}
Redirect the buyer to the approval_url so they can complete authentication and approve the payment. After approval, the buyer is redirected to the redirect_url you provided when creating the transaction. Do not rely solely on the redirect - either poll the transaction or (recommended) rely on webhooks to detect the final status (for example capture_succeeded or failure states).

​
Testing

Refer to the TravelHub docs for further guidance on your integration, including detailed testing instructions.