Offering payment by meal voucher
There are several ways to offer payment by electronic meal voucher.
Payment method selection on the payment page
This is the default behavior. The buyer chooses his or her payment method from a list defined by the payment gateway, including the available electronic meal voucher.
To use this solution, the merchant website can:
submit the vads_payment_cards field without a value (empty),
not send the vads_payment_cards field in the form.
Depending on the other parameters submitted in the form (amount, currency, amount that can be paid in meal vouchers), the payment gateway will display all the eligible payment methods. Depending on the value of the amount that can be paid in meal vouchers, the meal voucher payment buttons will be available or not.
E.g.: For a shop that has a CB and a Conecs acceptance contract that authorizes APETIZ and CHEQUE DEJEUNER payments:
Meal voucher type selection on the payment page
The buyer selects his/her type of electronic meal voucher from the list of payment methods defined by the merchant.
For this, the merchant submits the list of electronic meal vouchers to offer via the vads_payment_cards field.
- APETIZ to display the APETIZ logo
- EDENRED to display the EDENRED logo
- SODEXO to display the SODEXO logo
- CHQ_DEJ to display the CHEQUE DEJEUNER logo
Reminder: issuers are updated by remote configuration automatically and on a daily basis.
Card type selection on the e-commerce website
The buyer chooses the type of electronic meal voucher on the merchant website. The buyer's choice is then submitted to the payment gateway via the vads_payment_cards field of the form.
- APETIZ to display the APETIZ payment page
- EDENRED to display the EDENRED payment page
- SODEXO to display the SODEXO payment page
- CHQ_DEJ to display the CHEQUE DEJEUNER payment page
If the vads_payment_cards field is populated with a single value, and this value corresponds to a type of meal voucher that is not available for the CB and CONECS acceptance contract, the payment form will not be rejected.
The buyer will be redirected to the payment method selection page. All the eligible payment methods (depending on the currency, the minimum or maximum amount, technical constraints such as whether the shopping cart data, the account holder's address and the shipping address are present or not, etc.) associated with the shop will be available.
Selection of the CONECS payment method on the payment page
If the merchant does not wish to display the logos of different issuers of the electronic meal voucher, there is a solution that groups all the electronic meal vouchers together.
To use it, the merchant must force the value of the vads_payment_cards field in his/her form with the "CONECS" value.
- During payment method selection on the e-commerce website:
The buyer is immediately redirected to the card detail entry page:
- During payment method selection on the payment page:
If the value of the vads_payment_cards field is not forced in the form, the payment page will display all the available payment methods with logos of different meal vouchers available with your CB and CONECS acceptance contracts as well as the Conecs logo.
By default, the Conecs logo is not available. The merchant must contact the Middle Office by e-mail to make a request.