worldline Direct
Sign up

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.

Overview

Payment group:
Payment product id:
5410
Key benefits
  • Easy integration
  • No interchange percentage
  • Fast settlement cycle
  • Guaranteed payment within in 10 days after the first instalment

Onboarding

  1. Sign a contract with iDEAL in3 and receive activation credentials in return.
  2. Send the activation credentials (merchantID) to us or enter the credentials in the Merchant Portal and activate iDEAL in3 as described in our guide.

Countries & currencies

Supported countries

Supported currencies

  • Euro (EUR)

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
    currencyCode

amount: The gross amount you want to charge for this order.
currencyCode: The ISO 4217 currency code for this amount.

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.
amountOfMoney.amount: The full amount of the items, calculated as orderLineDetails.productPrice X orderLineDetails.quantity.

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

  1. Your customers finalise an order on their desktop device in your shop and select iDEAL in3.
  2. You send this CreateHostedCheckout/CreatePayment request to our platform.
  3. 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. 
  4. We redirect your customer to your returnUrl.
  5. We update the transaction to statusOutput.statusCode=4.
  6. You request the intermediate transaction result (statusOutput.statusCode=4) from our platform via GetPaymentDetails/GetHostedCheckout or receive the result via webhooks.
  7. iDEAL in3 provides us with the final transaction result (within 72 hours). We update the transaction to statusOutput.statusCode=9.
  8. You request the transaction result from our platform via GetPaymentDetails/GetHostedCheckout or receive the result via webhooks.
  9. If the transaction was successful, you can deliver the goods / service.
  10. 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.

Was this page helpful?

Do you have any comments?

Thank you for your response.