Mealvouchers
Introduction
L'intégration unique des méthodes de paiement propose divers chèques-repas belges et français.
Vos clients peuvent choisir parmi ceux-ci :
| Belgique | France |
|---|---|
|
|
Vous pouvez offrir à vos clients la possibilité de payer la totalité ou une partie d'une commande. Si vous n'autorisez qu'un montant partiel ou si vos clients n'ont pas suffisamment de fonds de chèques-repas pour le montant total, ils peuvent payer via Visa, MasterCard ou Cartes Bancaires pour le montant restant.
Toutes les méthodes de paiement mentionnées ci-dessus sont combinées en une seule méthode de paiement dans le Merchant Portal (Entreprise > Moyens de paiement).
Utilisez-vous le Back Office ?
Toutes les méthodes de paiement mentionnées ci-dessus sont combinées en une seule méthode de paiement (Configuration > Activation PM).
Avantages clés
- Exigences PCI basses
- Permet les remboursements (pour Monizze et PassRestaurant 1ère génération)
- Paiements complémentaires possibles
Belgique
France
Intégration
Redirigez vos clients vers le portail de paiement Thunes via notre Hosted Checkout Page. Trouvez 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": 1000
},
"customer": {
"merchantCustomerId": "mc_{{TIMESTAMP}}",
"contactDetails": {
"emailAddress": "wile.e.coyote@acmelabs.com"
}
},
"references": {
"merchantOrderId": "{{TIMESTAMP}}",
"merchantReference": "mr_{{TIMESTAMP}}"
},
"shoppingCart": {
"items": [
{
"amountOfMoney": {
"currencyCode": "EUR",
"amount": 1000
},
"invoiceData": {
"description": "Food"
},
"orderLineDetails": {
"productName": "ACME12",
"discountAmount": 0,
"lineAmountTotal": 100,
"productCode": "ASO45",
"productPrice": 1000,
"productType": "FoodAndDrink",
"quantity": 1,
"taxAmount": 0,
"unit": "piece"
}
}
]
}
},
"redirectPaymentMethodSpecificInput": {
"requiresApproval": true,
"paymentProductId": 5402
}
}
| Propriétés | Remarques |
|---|---|
|
customer |
- |
|
references |
- |
|
orderLineDetails |
N'envoyez qu'un seul produit par commande dans orderLineDetails
Seulement pour SodexoBE et Monizze : la valeur de productType peut également être : "HomeAndGarden" ou "GiftAndFlowers". |
|
redirectPaymentMethodSpecificInput |
requiresApproval : Définissez sur "true"/"false" selon les opérations de maintenance que chaque bon individuel supporte. Consultez cette liste pour sélectionner la valeur correcte. paymentProductId : L'identifiant numérique de la méthode de paiement sur notre plateforme. Trouvez cet identifiant dans le chapitre "Aperçu". Il indique à notre plateforme d'envoyer vos clients directement au portail Thunes. Cette liste récapitule les bons disponibles et les opérations de maintenance qu'ils supportent. |
Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.
Si vous réglez requiresApproval sur "true", assurez-vous de capturer la transaction ultérieurement via le Merchant Portal ou une requête CapturePayment. Ce n'est qu'à ce moment-là que la transaction aura status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9, et vous recevrez alors le paiement réel pour la transaction.
Liste des chèques-repas disponibles
Les bons individuels sont disponibles dans le portail Thunes et permettent les opérations de maintenance suivantes :
| Marque | Opérations de maintenance autorisées |
|---|---|
| Monizze |
Remboursement (Partiel / Multiple / Intégral) |
| SodexoBE | |
| PassRestaurant |
Capture* (Intégral) Annulation (Intégral) |
| UpChequeDejeuner |
Capture* (Intégral) Annulation (Intégral) |
| Swile |
Capture* (Partiel/Multiple/Intégral) Remboursement (Partiel/Multiple/Intégral) Annulation (Partiel/Multiple/Intégral) |
| Apetiz |
Capture* (Intégral) Remboursement (Intégral) Annulation (Intégral) |
*Thunes capture automatiquement toutes les autorisations du même jour à minuit
Cinématique
- Vos clients finalisent une commande dans votre boutique et sélectionnent Cheques-Repas.
- Vous envoyez cette requête CreateHostedCheckout à notre plateforme.
- Vous redirigez vos clients vers le portail Thunes via l'URL redirectUrl.
Vos clients sélectionnent un chèque-repas et confirment la commande avec leur numéro de carte et mot de passe (cryptogramme). Si vos clients doivent payer un montant restant, deux scénarios sont possibles :
3'(optionnel). Vos clients restent dans le portail Thunes pour payer le montant restant. Thunes calcule automatiquement le montant à payer.
3''(optionnel). Vous initiez une seconde transaction par vous-même. Pour cela, vous devez calculer vous-même le montant restant. Vous pouvez choisir n'importe quelle méthode de paiement disponible dans votre compte. - Nous recevons le résultat de la transaction.
- Nous redirigeons votre client vers votre returnUrl
- Vous récupérez 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 biens/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.
- Les données dans notre Cas de test fonctionnent UNIQUEMENT pour les demandes de paiement dans notre environnement de test. Utiliser ces données dans notre environnement de production entraînera des résultats de test indésirables.