Chèques alimentaires

Traiter les bons alimentaires (vales de despensa au Mexique et cartões de benefícios au Brésil) à l'aide d'une infrastructure de traitement de cartes standard.

Ce guide explique comment identifier, traiter et déclarer ces transactions à l'aide de DEUNA.

Pour les connexions de bons de réduction prises en charge, DEUNA peut associer une adresse d'expéditeur et un modèle d'e-mail à la connexion, de sorte que les communications de bons de réduction utilisent le contenu approuvé par le commerçant. Il s'agit d'une fonctionnalité de connexion, et non d'une opération API publique pour le commerçant.

Bons pris en charge#

La couche d'orchestration DEUNA identifie et achemine automatiquement les méthodes de paiement par bon suivantes :

Méthodes d'intégration prises en charge#

Les bons sont pris en charge dans tous les types d'intégration DEUNA à l'aide d'objets de carte standard :

• Widget de paiement : détecte automatiquement le BIN et affiche le logo de l'émetteur dans le champ de saisie.
• Lien de paiement : créez des liens sécurisés via le panneau d'administration ; les utilisateurs saisissent les détails du bon comme avec une carte de crédit standard.
• API directe : traiter les transactions via POST /v2/merchants/orders/purchase en utilisant l'objet standard card_info.

Conformité et détection (API BIN)#

Identifiez un bon avant de soumettre la transaction pour vous conformer aux lois fiscales locales.

• Point final : GET /cards/bin/{bin}
• Exemple de réponse :

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

Gérer les cartes de bons alimentaires stockées#

Les cartes de bons d'alimentation apparaissent dans la liste des cartes de magasin avec l'identifiant de catégorie spécifique après qu'un utilisateur a enregistré une carte de bons d'achat sur son compte.

• Point final : GET users/{user_id}/cards/{card_id}
• Exemple de réponse :

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

Visibilité de recherche et d'administration#

Pour faciliter le rapprochement, DEUNA marque chaque transaction de bon.

Pour faciliter l'identification de ces transactions, DEUNA identifiera le mode de paiement utilisé pour chaque transaction dans l'API des commandes et le panneau d'administration.

Ces métadonnées sont visibles à la fois dans l'API et dans le panneau d'administration.

API des détails de la commande

Lors de la récupération d'une commande, l'objet from_card dans les données de paiement identifie la catégorie du bon.

• Point final : GET /merchants/orders/{order_token}
• Réponse :

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

Fonctionnalités du panneau d'administration

Découvrez l’affichage Admin pour les bons d’alimentation.

• Reconnaissance visuelle: La liste des transactions affiche le logo spécifique de l'émetteur pour une identification facile.
• Filtres avancés: Filtrez le tableau de bord des transactions pour tout isoler food_voucher entries.
• Vue détaillée: La section Informations de paiement de toute commande spécifique étiquette explicitement la carte avec le logo spécifique et l'identification de chaque mode de paiement.