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
Monizze (y compris les bons Éco & Cadeaux en plus des chèques-repas) SodexoBE (y compris les bons Éco & Cadeaux en plus des chèques-repas)	PassRestaurant UpChequeDejeuner Swile Apetiz (Bimpli)

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).

Optimisé pour Desktop Mobile

Aperçu

Groupe de paiement :

Prépayé

Identifiant du moyen de paiement:

5402

Avantages clés

Exigences PCI basses
Permet les remboursements (pour Monizze et PassRestaurant 1ère génération)
Paiements complémentaires possibles

Pays & devises

Pays pris en charge

Belgique
France

Devises prises en charge

Euro (EUR)

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 merchantCustomerId contactDetails	-
references merchantOrderId merchantReference	-
orderLineDetails productName discountAmount lineAmountTotal productCode productPrice productType quantity taxAmount	N'envoyez qu'un seul produit par commande dans orderLineDetails Utilisez toujours un seul productType par commande et envoyez la valeur "FoodAndDrink" fixe. Seulement pour SodexoBE et Monizze : la valeur de productType peut également être : "HomeAndGarden" ou "GiftAndFlowers".
redirectPaymentMethodSpecificInput requiresApproval paymentProductId	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. En cas d'omission, notre plateforme redirige vos clients vers la Hosted Checkout Page, leur permettant de choisir ce mode de paiement ou tout autre actif dans votre compte.

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	DirectSale Remboursement (Partiel / Multiple / Intégral)
SodexoBE	DirectSale
PassRestaurant	Autorisation *Capture (Intégral) Annulation (Intégral)**
UpChequeDejeuner	Autorisation *Capture (Intégral) Annulation (Intégral)**
Swile	DirectSale Autorisation *Capture (Partiel/Multiple/Intégral) Remboursement (Partiel/Multiple/Intégral) Annulation (Partiel/Multiple/Intégral)**
Apetiz	Autorisation *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.