iDEAL in3
Introduction
iDEAL in3 est la variante "Acheter maintenant, payer plus tard" de la marque iDEAL. Elle propose un paiement en 3 fois sans intérêts pour vos clients.
Vos clients répartissent leur paiement en trois versements égaux, sans intérêts, sur 60 jours. iDEAL in3 externalise le risque de défaut de paiement, car iDEAL in3 vous paie à l'avance (10 jours après le 1er versement) et collecte les fonds auprès de vos clients.
Vous envoyez une demande standard à notre plateforme pour rediriger vos clients vers le contrat de paiement en plusieurs fois iDEAL in3.
L'intégration est très simple, car vous n'avez qu'à envoyer quelques paramètres supplémentaires avec votre demande.
Aperçu
Activation
- Signez un contrat avec iDEAL in3 et recevez en retour les informations d'activation.
- Envoyez les informations d'activation (merchantID) à nous ou entrez les informations dans le Merchant Portal et activez iDEAL in3 comme décrit dans notre guide.
Pays-Bas
Intégration
Redirigez vos clients vers la page d'inscription iDEAL in3 via les modes d'intégration Hosted Checkout Page ou Server-to-server. Trouvez un aperçu de haut niveau dans le chapitre "Cinématique".
Ajoutez les propriétés suivantes à une demande standard CreateHostedCheckout/CreatePayment :
{
"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": "3ème étage",
"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": "3ème étage",
"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": "Rapide et Furieux"
},
"shoppingCart": {
"items": [
{
"amountOfMoney": {
"currencyCode": "EUR",
"amount": 30000
},
"invoiceData": {
"description": "Courbe BEL"
},
"orderLineDetails": {
"productName": "ACME12",
"discountAmount": 0,
"lineAmountTotal": 30000,
"productCode": "ASO45",
"productPrice": 30000,
"productType": "Électronique",
"quantity": 1,
"taxAmount": 0,
"unit": "pièce"
}
}
]
}
}
}| Propriétés | Description |
|---|---|
|
order.amountOfMoney |
amount : Le montant brut que vous souhaitez facturer pour cette commande. |
| order.customer personalInformation name gender dateOfBirth billingAddress contactDetails fiscalNumber shipping |
Les informations personnelles/informations de contact de votre client, l'adresse de facturation et l'adresse de livraison. fiscalNumber est obligatoire pour les clients B2B. |
| order.shoppingCart.items amountOfMoney orderLineDetails |
Le contenu du panier d'achat sous forme d'un tableau d'objets d'articles. Assurez-vous de calculer la valeur de order.amountOfMoney.amount en additionnant toutes les instances de shoppingCart.items.amountOfMoney.amount. Ayez à l'esprit que shoppingCart.items est optionnel. Cependant, si vous les incluez dans votre demande, assurez-vous d'inclure orderLineDetails.productPrice / orderLineDetails.productName pour chaque ligne d'article.
|
Bien que les propriétés suivantes ne soient pas strictement obligatoires, nous vous recommandons fortement de les inclure dans votre demande :
dateOfBirth
shipping
billingAddress
Si elles sont omises, vos clients devront fournir ces informations pendant le processus de paiement, ce qui aura un impact sur leur expérience de paiement.
Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI/CreatePaymentAPI.
Cinématique
- Vos clients finalisent une commande sur leur dispositif de bureau dans votre boutique et sélectionnent iDEAL in3.
- Vous envoyez cette demande CreateHostedCheckout/CreatePayment à notre plateforme.
- Vous redirigez vos clients via le redirectUrl (Pour les demandes CreateHostedCheckout) ou merchantAction.redirectData.redirectUrl (Pour les demandes CreatePayment) vers le portail iDEAL in3. Vos clients confirment la commande et paient le premier terme.
- Nous redirigeons votre client vers votre returnUrl.
- Nous mettons à jour la transaction à statusOutput.statusCode=4.
- Vous demandez le résultat intermédiaire de la transaction (statusOutput.statusCode=4) auprès de notre plateforme via GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks.
- iDEAL in3 nous fournit le résultat final de la transaction (dans un délai de 72 heures). Nous mettons à jour la transaction à statusOutput.statusCode=9.
- Vous demandez le résultat de la transaction auprès de notre plateforme via GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks.
- Si la transaction a été réussie, vous pouvez livrer les biens/services.
- iDEAL in3 facture automatiquement vos clients pour les versements restants dans les intervalles convenus.
Test
Consultez nos Cas de test pour des données de test et des instructions détaillées.
Assurez-vous d'utiliser le bon endpoint et de renseigner l'URL de production dès que vous avez terminé vos tests.