iDEAL in3

Intro
iDEAL in3 is the "Buy Now Pay Later" variant of the iDEAL brand. It proposes an instalment in 3 times with 0% interest for your customer.
Your customers split their payment into three equal, interest-free instalments over 60 days. iDEAL in3 outsources the risk of payment defaults, as iDEAL in3 pays you upfront (10 days after the 1st instalment) and collects the funds from your customers.
You send a standard request to our platform to redirect your customers to the iDEAL in3 instalment contract.
The integration is very easy, as you only need to send some additional parameters along with your request.
Onboarding
- Sign a contract with iDEAL in3 and receive activation credentials in return.
- Send the activation credentials (merchantID) to us or enter the credentials in the Merchant Portal and activate iDEAL in3 as described in our guide.
Integration
Redirect your customers to the iDEAL in3 registration page via integration modes Hosted Checkout Page or Server-to-server. Find a high level overview in the "Process flows" chapter.
Add the following properties to a standard CreateHostedCheckout/CreatePayment request:
{
"order": {
"amountOfMoney": {
"amount": 30000,
"currencyCode": "EUR"
},
"customer": {
"locale": "en_GB",
"personalInformation": {
"name": {
"title": "M.",
"firstName": "Wile",
"surname": "Coyote"
},
"gender": "male",
"dateOfBirth": "19490917"
},
"companyInformation": {
"name": "BEL Labs"
},
"billingAddress": {
"street": "Neptunusstraat",
"houseNumber": "41",
"additionalInfo": "floor 3",
"zip": "2132JA",
"city": "Hoofddorp",
"state": "",
"countryCode": "NL"
},
"contactDetails": {
"emailAddress": "wile.e.coyote@acmelabs.com",
"phoneNumber": "+311234567890",
"faxNumber": "+1234567891"
},
"fiscalNumber": "BE0133117948"
},
"shipping": {
"address": {
"street": "Neptunusstraat",
"houseNumber": "41",
"additionalInfo": "floor 3",
"zip": "2132JA",
"city": "Hoofddorp",
"state": "",
"countryCode": "NL",
"name": {
"title": "Mme.",
"firstName": "bip",
"surname": "bip"
}
},
"addressIndicator": "same-as-billing",
"emailAddress": "wile.e.coyote@acmelabs.com",
"shippingCost": 0,
"shippingCostTax": 0
},
"references": {
"merchantReference": "mr_637521911919765074",
"merchantParameters": "SessionID=126548354&ShopperID=73541312",
"descriptor": "Fast and Furry-ous"
},
"shoppingCart": {
"items": [
{
"amountOfMoney": {
"currencyCode": "EUR",
"amount": 30000
},
"invoiceData": {
"description": "BEL curve"
},
"orderLineDetails": {
"productName": "ACME12",
"discountAmount": 0,
"lineAmountTotal": 30000,
"productCode": "ASO45",
"productPrice": 30000,
"productType": "Electronics",
"quantity": 1,
"taxAmount": 0,
"unit": "piece"
}
}
]
}
}
}
Properties | Description |
---|---|
order.amountOfMoney |
amount: The gross amount you want to charge for this order. |
order.customer personalInformation name gender dateOfBirth billingAddress contactDetails fiscalNumber shipping |
Your customer's personal information/contact details, billing and shipping address. fiscalNumber is mandatory for B2B customers. |
order.shoppingCart.items amountOfMoney orderLineDetails |
The content of the shopping cart as an array of items objects. Make sure to calculate the value for order.amountOfMoney.amount by adding up all instances of shoppingCart.items.amountOfMoney.amount. Mind that shoppingCart.items are optional. However, if you include them in your request, make sure to include orderLineDetails.productPrice / orderLineDetails.productName for each line item.
|
Although the following properties are not strictly mandatory, we strongly recommend including them in your request:
dateOfBirth
shipping
billingAddress
If left out, your customers need to provide this information during the checkout process, which has an impact on their payment experience.
Find detailed information about this object and its properties in our CreateHostedCheckoutAPI/CreatePaymentAPI.
Process flows
- Your customers finalise an order on their desktop device in your shop and select iDEAL in3.
- You send this CreateHostedCheckout/CreatePayment request to our platform.
- You redirect your customers via the redirectUrl (For CreateHostedCheckout requests) or merchantAction.redirectData.redirectUrl (For CreatePayment requests) to the iDEAL in3 portal. Your customers confirm the order and pay the first term.
- We redirect your customer to your returnUrl.
- We update the transaction to statusOutput.statusCode=4.
- You request the intermediate transaction result (statusOutput.statusCode=4) from our platform via GetPaymentDetails/GetHostedCheckout or receive the result via webhooks.
- iDEAL in3 provides us with the final transaction result (within 72 hours). We update the transaction to statusOutput.statusCode=9.
- You request the transaction result from our platform via GetPaymentDetails/GetHostedCheckout or receive the result via webhooks.
- If the transaction was successful, you can deliver the goods / service.
- iDEAL in3 charges your customers automatically for the remaining instalments within the arranged intervals.
Testing
Refer to our Test cases for test data and detailed instructions.
Make sure to use the right endpoint and switch back to the live URL as soon as you have finished your tests.