Mealvouchers
Intro
The unique payment method integration offers various Belgian meal vouchers.
Your customers can choose any of these:
| Belgium |
|---|
|
You can offer your customers to pay full or partial amounts for an order. If you allow only a partial amount or your customers do not have enough meal voucher funds for the full amount, they can pay via Visa or MasterCard for the remaining amount.
All of the payment methods mentioned above are combined to one payment method in the Merchant Portal (Business > Payment methods).
Are you using the Back Office?
All of the payment methods mentioned above are combined to one payment method (Configuration > PM-Aktivierung).
Belgien
Integration
Redirect your customers to the Thunes payment portal via our Hosted Checkout Page. Find a high level overview in the "Zahlungsablauf" chapter.
Add the following properties to a standard CreateHostedCheckout request:
{
"order": {
"amountOfMoney": {
"currencyCode": "EUR",
"amount": 1000
},
"customer": {
"merchantCustomerId": "mc_{{TIMESTAMP}}",
"contactDetails": {
"emailAddress": "wile.e.coyote@acmelabs.com"
}
},
"references": {
"merchantOrderId": "{{TIMESTAMP}}",
"merchantReference": "merchant-reference"
},
"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
}
}
| Properties | Remarks |
|---|---|
|
customer |
- |
|
references |
- |
|
orderLineDetails |
Only send one product item per order in orderLineDetails
Only for SodexoBE and Monizze: productType value can also be : "HomeAndGarden" or "GiftAndFlowers". |
|
redirectPaymentMethodSpecificInput |
requiresApproval: Set to either "true"/"false" depending on what maintenance operations the individual voucher support. Consult this list to select the correct value. paymentProductId: The numeric identifier of the payment method on our platform. Find this id in the "Überblick" chapter. It instructs our platform to send your customers directly to the Thunes portal. This list summarises the available vouchers and the maintenance operations they support. |
Ausführliche Informationen über dieses Objekt und seine Eigenschaften finden Sie in unserer CreateHostedCheckoutAPI
If you set requiresApproval to "true", make sure to capture the transaction later via the Merchant Portal or a CapturePayment request. Only then will the transaction have status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9, for which you receive the actual payment for the transaction.
List of available Mealvouchers
The individual vouchers are available in the Thunes portal and allow the following maintenance operations:
| Brand | Allowed maintenance operations |
|---|---|
| Monizze |
Refund (Partial / Multiple / Full) |
| Pluxee BE | |
|
Edenred BE |
Refund(Partial / Multiple / Full) |
*Thunes automatically captures all authorisations from the same day at midnight
Zahlungsablauf
- Your customers finalise an order in your shop and select Mealvouchers.
- You send this CreateHostedCheckout request to our platform.
- You redirect your customers to the Thunes portal via the redirectUrl.
Your customers select one meal voucher and confirm the order with their card number and password (cryptogram). If your customers need to pay a remaining amount, you have to activate the complementary payment in your payment request by sending the completeRemainingPaymentAmount parameter. - We receive the transaction result.
- We redirect your customer to your returnUrl
- You request the transaction result from our platform via GetHostedCheckout or receive the result via webhooks.
- If the transaction was successful, you can deliver the goods/services.
Testdaten
In unseren Testszenarios finden Sie Testdaten und detaillierte Instruktionen.
Stellen Sie sicher, den korrekten Endpunkt anzusteuern und zurück zum Live-Endpunkt zu wechseln, sobald Sie Ihre Tests abgeschlossen haben