Food vouchers

Process food vouchers (vales de despensa in Mexico and cartões de benefícios in Brazil) using standard card-processing infrastructure.

This guide outlines how to identify, process, and report these transactions using DEUNA.

Supported vouchers

DEUNA orchestration layer automatically identifies and routes the following voucher payment methods:

Supported integration methods

Vouchers are supported across all DEUNA integration types using standard card objects:

• Payment Widget: Automatically detects the BIN and displays the issuer logo in the input field.
• Payment Link: Create secure links via the Admin Panel; users enter voucher details just like a standard credit card.
• Direct API: Process transactions via POST /v2/merchants/orders/purchase using the standard card_info object.

Compliance and detection (BIN API)

Identify a voucher before submitting the transaction to comply with local tax laws.

• Endpoint: GET /v1/cards/bin/{bin}
• Example Response:

         {
           "bin": "506744",
           "franchise": "ALELO",
           "issuer_bank": "BANCO BRADESCO",
           "card_type": "PREPAID",
           "category": "food_voucher" 
         }

Manage stored food voucher cards

Food voucher cards appear in the store cards list with the specific category identifier after a user saves a voucher card to their account.

• Endpoint: GET users/{user_id}/cards/{card_id}
• Example Response:

            {
              "data": [
                {
                  "card_holder": "John Doe",
                  "card_type": "debit_card",
                  "company": "visa",
                  "category": "food_voucher",
                  "first_six": "411111",
                  "last_four": "1111",
                  "expiration_date": "11/25",
                  "id": "xxxxxxxx-83ac-495a-xxxx-xxxx577efff"
                }
              ]
            }

Search and Admin visibility

To facilitate reconciliation, DEUNA tags every voucher transaction.

To facilitate identifying these transactions, DEUNA will identify the payment method used for each transaction in the Orders API and Admin panel.

This metadata is visible in both the API and the Admin panel.

Order details API

When retrieving an order, the from_card object within the payment data identifies the voucher category.

• Endpoint: GET /merchants/orders/{order_token}
• Response:

               {
                 "order": {
                   "order_id": "TESTS-12345",
                   "status": "authorized",
                   "payment": {
                     "data": {
                       "from_card": {
                         "card_brand": "Sodexo",
                         "category": "food_voucher"
                       },
                       "method_type": "card",
                       "status": "captured"
                     }
                   }
                 }
               }

Admin panel features

Learn about the Admin display for food vouchers.

• Visual recognition: The transaction list displays the specific issuer logo for easy identification.
• Advanced filters: Filter the transactions dashboard to isolate all food_voucher entries.
• Detail view: The Payment Information section for any specific order explicitly labels the card with the specific logo and identification of each payment method.