How to handle meal voucher payments

Consiglio

Last updated on 2026-05-13.

When meal vouchers are used as a payment method, they must be reported as follows:

payments[].type > CARD

payments[].kind > TICKET

payments[].number = currently, the API requires the meal voucher identifier in this field. A placeholder value (e.g. "****") can also be used.

If multiple meal vouchers are used, each voucher must be reported as a separate payment entry within the payments array. The API will then aggregate these entries and submit the total number of vouchers to AdE.

**Example: **20 EUR payment using two meal vouchers and a debit card

     "payments": [
       {
         "type": "CARD",
         "kind": "TICKET",
         "number": "1234",
         "details": {
           "amount": "5.00"
         }
       },
       {
         "type": "CARD",
         "kind": "TICKET",
         "number": "1235",
         "details": {
           "amount": "5.00"
         }
       },
       {
         "type": "CARD",
         "kind": "DEBIT",
         "number": "****",
         "details": {
           "amount": "10.00"
         }
       }
     ]