食料券

標準的なカード処理インフラストラクチャを使用して、食料券（メキシコの「vales de despensa」およびブラジルの「cartões de benefícios」）を処理します。

このガイドでは、DEUNAを使用してこれらのトランザクションを特定、処理、および報告する方法について説明します。

Для поддерживаемых подключений с купонами, DEUNA может связать адрес отправителя и шаблон электронной почты с подключением, чтобы коммуникации с купонами использовали контент, одобренный торговцем. Это возможность подключения, а не операция публичного API торговца.

サポートされている券#

DEUNAのオーケストレーションレイヤーは、以下の券決済方法を自動的に識別し、ルーティングします：

サポートされている統合方法#

Voucherは、標準的なカードオブジェクトを使用して、すべてのDEUNA統合タイプでサポートされています。

• Payment Widget: BINを自動的に検出し、入力フィールドに発行者のロゴを表示します。
• 決済リンク: 管理パネルから、安全なリンクを作成できます。ユーザーは、通常のクレジットカードと同様に、クーポン情報を入力します。
• 直接API: 以下のオブジェクトを使用して、取引を処理します。 POST /v2/merchants/orders/purchase 標準の card_info オブジェクトを使用します。

コンプライアンスと検出 (BIN API)#

取引を送信する前に、Voucher（ギフト券）を特定し、現地の税法を遵守してください。

• エンドポイント: GET /cards/bin/{bin}
• 例: レスポンス

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

保存されたフードバウチャーカードの管理#

フードバウチャーカードは、ユーザーがカードをアカウントに保存した後、特定のカテゴリ識別子を使用して、ストアカードリストに表示されます。

• エンドポイント: GET users/{user_id}/cards/{card_id}
• 例: レスポンス

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

検索と管理者の可視性#

調整を容易にするため、DEUNAはすべてのバウチャー取引にタグを付与します。

これらの取引を識別するために、DEUNAはOrders APIおよび管理パネルで、各取引で使用された決済方法を特定します。

このメタデータは、APIと管理パネルの両方で表示されます。

注文詳細 API

注文を取得する際、from_cardオブジェクトは、支払いデータ内でバウチャーのカテゴリを特定します。

• エンドポイント: GET /merchants/orders/{order_token}
• レスポンス:

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

管理パネルの機能

フードバウチャーに関する管理画面の表示について学習

• 視覚的な識別トランザクションリストには、容易な識別のために、特定の発行者のロゴが表示されます。
• 高度なフィルタトランザクションダッシュボードをフィルタリングして、すべての food_voucher entries.
• 詳細表示支払い情報セクションは、特定の注文に対して、カードを特定のロゴと支払い方法の識別情報で明示的にラベル付けします。