Buoni alimentari

Elaborare buoni alimentari (vales de despensa in Messico e cartões de benefícios in Brasile) utilizzando l'infrastruttura standard di elaborazione delle carte.

Questa guida illustra come identificare, elaborare e segnalare queste transazioni utilizzando DEUNA.

Per le connessioni di voucher supportate, DEUNA può associare un indirizzo di mittente e un modello di email alla connessione, in modo che le comunicazioni relative ai voucher utilizzino i contenuti approvati dal commerciante. Questa è una funzionalità della connessione, non un'operazione API pubblica del commerciante.

Buoni sostenuti#

Lo strato di orchestrazione DEUNA identifica automaticamente e traccia i seguenti metodi di pagamento del voucher:

Metodi di integrazione supportati#

I voucher sono supportati in tutti i tipi di integrazione DEUNA utilizzando oggetti di carta standard:

• Payment Widget: rileva automaticamente il BIN e visualizza il logo dell'emittente nel campo di input.
• Link di pagamento: Crea collegamenti sicuri tramite il Pannello di amministrazione; gli utenti inserisci i dettagli del voucher proprio come una carta di credito standard.
• API diretta: transazioni di processo tramite POST /v2/merchants/orders/purchase utilizzando l'oggetto card info standard.

Compliance e rilevamento (API BIN)#

Identificare un voucher prima di inviare la transazione per rispettare le leggi fiscali locali.

• Punto di arrivo: GET /cards/bin/{bin}
• Esempio di risposta:

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

Gestire le carte di voucher alimentari memorizzate#

Le carte del voucher del cibo appaiono nell'elenco delle carte del negozio con l'identificatore di categoria specifica dopo che un utente salva una carta del voucher sul loro account.

• Punto di arrivo: GET users/{user_id}/cards/{card_id}
• Esempio di risposta:

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

Ricerca e visibilità di Admin#

Per facilitare la riconciliazione, DEUNA tags ogni transazione voucher.

Per facilitare l'identificazione di queste transazioni, DEUNA identificherà il metodo di pagamento utilizzato per ogni transazione nel pannello Ordini API e Admin.

Questo metadati è visibile sia nell'API che nel pannello Admin.

Dettagli dell'ordine API

Quando si recupera un ordine, l'oggetto from card all'interno dei dati di pagamento identifica la categoria voucher.

• Punto di arrivo: GET /merchants/orders/{order_token}
• Risposta:

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

Caratteristiche del pannello di amministrazione

Scoprite il display Admin per i buoni alimentari.

• Riconoscimento visivo: L'elenco delle transazioni visualizza il logo dell'emittente specifica per una facile identificazione.
• Filtri avanzati: Filtra la dashboard delle transazioni per isolare tutti food_voucher entries.
• Vista dettagliata: La sezione Informazioni di pagamento per qualsiasi ordine specifico etichetta esplicitamente la carta con il logo specifico e l'identificazione di ogni metodo di pagamento.