Cadhoc
Introduction
Cadhoc est une carte cadeau française offerte par UP.
Avec une gamme de valeur entre 20 et 250€ par carte et un vaste réseau de partenaires commerciaux (15 500 points de vente), Cadhoc est un moyen de paiement flexible et sûr.
L'intégration est très facile, car il vous suffit d'envoyer un paramètre supplémentaire avec votre demande. Vous redirigez vos clients vers la page de paiement Cadhoc où ils saisissent les données de leur carte cadeau (numéro de carte, date d'expiration et cryptogramme). Ils peuvent combiner jusqu'à trois cartes cadeaux pour un seul achat et même utiliser leur carte de crédit pour le montant restant.
Il est possible de personnaliser les cartes Cadhoc avec "chèque lire" ou "chèque culture" comme marque de cartes cadeaux. Contactez Thunes pour réaliser cela.
L'intégration décrite ci-dessous reste la même pour toutes les cartes Cadhoc.
Activation
Pour utiliser Cadhoc dans notre environnement de test ou en production, suivez ces étapes :
- Signez un contrat avec Cadhoc et recevez des identifiants d'activation en retour.
- Envoyez nous les identifiants d'activation (MID/mot de passe et éventuellement d'autres identifiants).
- Nous effectuons la vérification nécessaire à l'intégration et au provisionnement.
- Nous activons le moyen de paiement sur votre compte.
France
Intégration
Redirigez vos clients vers la page de paiement Cadhoc via notre Hosted Checkout Page. Vous trouverez un aperçu général dans le chapitre "Cinématique".
Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout :
{
"order": {
"amountOfMoney": {
"currencyCode": "EUR",
"amount": 1700
},
"customer": {
"contactDetails": {
"emailAddress": "jean.dupont@test.com"
}
}
},
"hostedCheckoutSpecificInput": {
"locale": "fr_FR"
},
"redirectPaymentMethodSpecificInput": {
"paymentProductId": 5601,
"returnUrl": "https://yourReturnUrl.com"
}
}| Propriété | Remarques |
|---|---|
|
order.amountOfMoney |
amount : Le montant total que vous souhaitez facturer pour cette commande. currencyCode : Le code de devise ISO 4217 pour ce montant. |
|
order.customer.contactDetails.emailAddress |
L'adresse e-mail de votre client. |
|
hostedCheckoutSpecificInput.locale |
La langue de notre Hosted Checkout Page. |
|
redirectPaymentMethodSpecificInput |
paymentProductId : L'identifiant numérique du moyen de paiement sur notre plateforme. Trouvez cet id dans le chapitre "Aperçu". Il indique à notre plateforme d'envoyer directement vos clients vers la page de paiement Cadhoc. S'il est omis, notre plateforme envoie vos clients vers la page Hosted Checkout Page à la place, leur permettant de choisir ce moyen de paiement ou tout autre moyen de paiement activé dans votre compte. returnUrl : L'URL vers laquelle nous redirigeons vos clients après la finalisation du paiement.
|
Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.
Cinématique
- Vos clients finalisent une commande dans votre boutique et sélectionnent Cadhoc.
- Vous envoyez cette requête CreateHostedCheckout à notre plateforme.
- Vous redirigez vos clients via le redirectUrl vers la page de paiement Cadhoc. Ils confirment la commande avec leurs identifiants de carte cadeau. Si vos clients doivent payer un montant restant, ils utilisent soit une autre carte Cadhoc ou leur carte de crédit (Visa/MasterCard) sur la page de paiement Cadhoc.
- Nous recevons le résultat de la transaction.
- Nous redirigeons votre client vers votre returnUrl
- Vous demandez le résultat de la transaction à notre plateforme via GetHostedCheckout ou recevez le résultat via les webhooks.
- Si la transaction a réussi, vous pouvez livrer les marchandises / services.
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.