Vale alimentação

Processar vales de alimentação (vales de despensa no México e cartões de benefícios no Brasil) usando infraestrutura padrão de processamento de cartões.

Este guia descreve como identificar, processar e reportar estas transações usando DEUNA.

Para conexões de voucher suportadas, a DEUNA pode associar um endereço de remetente e um modelo de e-mail à conexão, para que as comunicações de voucher utilizem o conteúdo aprovado pelo comerciante. Esta é uma capacidade da conexão, e não uma operação pública da API do comerciante.

Comprovantes suportados#

A camada de orquestração DEUNA identifica e encaminha automaticamente os seguintes métodos de pagamento de voucher:

Métodos de integração suportados#

Os vouchers são suportados em todos os tipos de integração DEUNA usando objetos de cartão padrão:

• Widget de Pagamento: Detecta automaticamente o BIN e exibe o logotipo do emissor no campo de entrada.
• Link de Pagamento: Crie links seguros através do Painel Administrativo; os usuários inserem os detalhes do voucher como um cartão de crédito padrão.
• API direta: processe transações via POST /v2/merchants/orders/purchase usando o objeto card_info padrão.

Conformidade e detecção (API BIN)#

Identifique um voucher antes de enviar a transação para cumprir as leis fiscais locais.

• Ponto final: GET /cards/bin/{bin}
• Exemplo de resposta:

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

Gerenciar cartões de vale-refeição armazenados#

Os cartões de vale-refeição aparecem na lista de cartões da loja com o identificador de categoria específico depois que um usuário salva um cartão de vale em sua conta.

• Ponto final: GET users/{user_id}/cards/{card_id}
• Exemplo de resposta:

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

Visibilidade de pesquisa e administração#

Para facilitar a reconciliação, a DEUNA marca cada transação de voucher.

Para facilitar a identificação destas transações, a DEUNA identificará o método de pagamento utilizado para cada transação na API de Pedidos e no painel Admin.

Esses metadados são visíveis na API e no painel do administrador.

API de detalhes do pedido

Ao recuperar um pedido, o objeto from_card nos dados de pagamento identifica a categoria do voucher.

• Ponto final: GET /merchants/orders/{order_token}
• Resposta:

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

Recursos do painel de administração

Saiba mais sobre a exibição do administrador para vale-alimentação.

• Reconhecimento visual: A lista de transações exibe o logotipo específico do emissor para facilitar a identificação.
• Filtros avançados: Filtre o painel de transações para isolar todos food_voucher entries.
• Visualização detalhada: a seção Informações de pagamento para qualquer pedido específico rotula explicitamente o cartão com o logotipo específico e a identificação de cada método de pagamento.