Spirit of Cadeau
Introduction
Spirit Of Cadeau et PassCadeau sont des cartes cadeaux françaises proposées par FIS.
Avec une plage de valeur entre 20 et 250€ par carte, ces cartes cadeaux sont des méthodes de paiement flexibles et sûres.
L'intégration est très facile, car vous avez seulement à envoyer un paramètre supplémentaire avec votre requête. Vous redirigez vos clients vers la page de paiement Spirit Of Cadeau où ils saisissent les données de leur carte cadeau (numéro de carte 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.
Activation
Pour utiliser Spirit of Cadeau dans notre environnement de test/prod, suivez ces étapes :
- Signez un contrat avec Spirit of Cadeau et recevez vos identifiants d'activation en retour.
- Envoyez les identifiants d'activation (MID/mot de passe et éventuellement d'autres identifiants) à nous.
- Nous effectuons les vérifications nécessaires de l'intégration et de l'approvisionnement.
- Nous activons la méthode de paiement dans votre compte.
France
Intégration
Redirigez vos clients vers la page de paiement Spirit of Cadeau via notre Hosted Checkout Page. Vous trouverez une vue d'ensemble 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": 3116,
"returnUrl": "https://yourReturnUrl.com"
}
}| Propriété | Remarques |
|---|---|
|
order.amountOfMoney |
amount: Le montant brut 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 version linguistique de notre Hosted Checkout Page. |
|
redirectPaymentMethodSpecificInput |
paymentProductId: L'identifiant numérique de la méthode 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 Spirit of Cadeau. Si omis, notre plateforme envoie vos clients vers le Hosted Checkout Page à la place, leur permettant de choisir cette méthode de paiement ou toute autre méthode qui est active sur votre compte. returnUrl: L'URL vers laquelle nous redirigeons vos clients après que le paiement a été finalisé.
|
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 Spirit Of Cadeau.
- Vous envoyez cette requête CreateHostedCheckout à notre plateforme.
- Vous redirigez vos clients via le redirectUrl vers la page de paiement Spirit Of Cadeau. Ils confirment la commande avec leurs identifiants de carte cadeau.
3'(optionnel). Si vos clients doivent payer un montant restant, ils utilisent soit une autre carte Spirit Of Cadeau et/ou leur carte de crédit (Visa/MasterCard) sur la page de paiement Spirit Of Cadeau. - Nous recevons le résultat de la transaction.
- Nous redirigeons votre client vers votre returnUrl
- Vous récuperez le résultat de la transaction à notre plateforme via une requête GetHostedCheckout ou recevez le résultat via webhooks.
- Si la transaction a été réussie, 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.