Vales de comida

Procesar vales de alimentos (vales de despensa en México y cartões de benefícios en Brasil) utilizando una infraestructura estándar de procesamiento de tarjetas.

Esta guía describe cómo identificar, procesar y reportar estas transacciones utilizando DEUNA.

Para conexiones de vales compatibles, DEUNA puede asociar una dirección de remitente y una plantilla de correo electrónico con la conexión para que las comunicaciones de vales utilicen el contenido aprobado por el comerciante. Esta es una capacidad de conexión, no una operación pública de la API del comerciante.

Vales admitidos#

La capa de orquestación DEUNA identifica y enruta automáticamente los siguientes métodos de pago de vales:

Métodos de integración admitidos#

Los vales se admiten en todos los tipos de integración de DEUNA utilizando objetos de tarjeta estándar:

• Widget de pago: detecta automáticamente el BIN y muestra el logotipo del emisor en el campo de entrada.
• Enlace de pago: cree enlaces seguros a través del Panel de administración; los usuarios ingresan los detalles del cupón como una tarjeta de crédito estándar.
• API directa: Procese transacciones a través de POST /v2/merchants/orders/purchase usando el objeto card_info estándar.

Cumplimiento y detección (BIN API)#

Identifique un comprobante antes de enviar la transacción para cumplir con las leyes fiscales locales.

• Punto final: GET /cards/bin/{bin}
• Ejemplo de respuesta:

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

Gestionar tarjetas de vales de comida almacenadas#

Las tarjetas de vales de comida aparecen en la lista de tarjetas de la tienda con el identificador de categoría específica después de que un usuario guarda una tarjeta de vale en su cuenta.

• Punto final: GET users/{user_id}/cards/{card_id}
• Ejemplo de respuesta:

            {
              "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"
                }
              ]
            }

Visibilidad de búsqueda y administración#

Para facilitar la conciliación, DEUNA etiqueta cada transacción de comprobante.

Para facilitar la identificación de estas transacciones, DEUNA identificará el método de pago utilizado para cada transacción en la API de Pedidos y en el panel de administración.

Estos metadatos son visibles tanto en la API como en el panel de administración.

API de detalles del pedido

Al recuperar un pedido, el objeto from_card dentro de los datos de pago identifica la categoría del vale.

• Punto final: GET /merchants/orders/{order_token}
• Respuesta:

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

Funciones del panel de administración

Obtenga más información sobre la pantalla de administración para vales de comida.

• Reconocimiento visual: La lista de transacciones muestra el logotipo del emisor específico para una fácil identificación.
• Filtros avanzados: Filtre el panel de transacciones para aislar todo food_voucher entries.
• Vista detallada: La sección Información de pago para cualquier pedido específico etiqueta explícitamente la tarjeta con el logotipo específico y la identificación de cada método de pago.