メインコンテンツへスキップ
このページで
統合方法

VTEX内でDEUNA搭載の支払い体験を設定します。

認定されたコネクタをインストールし、支払い条件を設定し、VTEXチェックアウトをDEUNAウィジェット機能で拡張します。

インターフェース
VTEXチェックアウトとDEUNAウィジェット
配送モデル
VTEXアプリとコネクタの設定
最適なケース
DEUNA支払いオーケストレーションを使用するVTEXの商取引

V2 Widget を使用して VTEX の商用条件を設定する方法#

VTEX は、プラットフォーム上で製品(SKU)のグループを定義するために、商用条件を使用することを、販売者に許可します。 VTEX は、これらの商用条件を通じて、購入者の取引をどの支払い条件(支払い方法)で処理するかを決定できます。

特典

VTEX は、異なる支払いプロバイダーを設定し、商用条件に関連付けることができます。これにより、特定の商用条件(SKU)を有効にすることができます。ただし、このプロセスにはいくつかの課題があります。

  1. プロバイダーの制限: 使用している一部の支払いプロバイダーは、VTEX コネクタで利用できない場合があります。そのため、利用できないプロバイダーに関連付けることができません。
  2. 埋め込み決済の有効化: VTEX と異なり、当社の Widget は、現在のところ、支払いプロトコル上の制限により、埋め込みモード(決済アプリ)での支払い条件の使用をサポートしていません。当社の Widget は、この機能を統合し、改善された支払い体験を提供します。
  3. 支払い体験: VTEX のすべてのプロバイダーが、埋め込み決済体験を提供しているわけではありません。異なるプロバイダーを設定すると、チェックアウトに複数のボタンが表示され、購入者に混乱を与え、ショッピング体験を悪化させる可能性があります。
  4. シンプルな設定: DEUNA Widget を使用すると、1 つの支払い条件(DeunaNow)を設定するだけで、すべての必要な商用条件を 1 つの支払い条件で管理できます。

これらの利点により、DEUNA Widget は、VTEX の使用時に、機能と効率を向上させるだけでなく、お客様のショッピング体験を向上させます。

要件

  1. DEUNA で設定された分割払い
  2. VTEXの認証情報をDEUNAチームに提供
  3. DEUNA での構成に使用する PSP の認証情報

手順

  1. DEUNA での商用条件用の PSP の設定
  2. VTEX での支払い方法の設定
  3. 商用条件と分割払いを使用するための DEUNA でのルールの設定

ステップ 1: 商用条件用の DEUNA での PSP 設定

VTEX のストアで設定を行う前に、DEUNA で PSP を設定できることを確認する必要があります。これを行うには、次の手順に従ってください。

  • DEUNA の管理者アカウントに、ユーザー名とパスワードを入力します。次に、「接続」モジュールを選択します。
  • PSP(決済代行業者)を追加し、認証情報を設定します。商用利用をサポートするため、以下の命名規則に従って、PSPの複数の接続を追加することを推奨します。
Plain text
PSP Name - VTEX commercial condition name

用語集の詳細

  • PSP 名: 設定する PSP の名前。例: Mercadopago
  • VTEX の商用条件名: 使用する商用条件を識別する名前。これは、条件名 + VTEX でのルールの活性化率で構成されます。例: 20% 以上の商品

この設定方法を説明するチュートリアルを次に示します

DEUNA Admin - VTEX での商用条件用の PSP 設定

この設定が完了したら、次の手順に進むことができます。

ステップ 2: VTEX での支払い方法の設定

DEUNA が VTEX での商用条件を正しく識別できるように、DeunaNow 支払い方法を正しく設定することが重要です。ここでは、正しい用語を使用する方法を含む、段階的な手順を説明します。これにより、ウィジェットが分割払いをサポートします。

  • 支払い方法の追加: DeunaNow 支払い方法を追加します。ルール名として使用する名前を記述することをお勧めします。 (添付の表には、ルール名の例があります)
  • 支払い条件での分割払い DeunaNowの支払い方法を追加したら、コネクタを割り当て、名前を入力してください。 "支払い回数" オプションを選択する必要があります。
  • 識別子を設定: 「総支払い回数」のフィールドには、許可されている最大支払い回数と、テーブルに記載されている商取引条件識別子を組み合わせたものを入力する必要があります。
Plain text
[Maximum number of installments to show in widget],[Commercial condition identifier]

用語集の詳細

  • ウィジェットに表示する最大支払い回数に送信されます。: DEUNA管理画面で設定された分割限度に対応します。 この数値は、購入プロセス中に顧客に提供できる分割回数を定義します。
  • 商用条件の識別子: これは、各商用条件に割り当てられた番号であり、添付の識別テーブルに定義されています。 この識別子は、DEUNAがトランザクションに適用されている特定の商用条件を認識できるようにします。

実用的な例

商用条件が最大6回の分割払いと、条件テーブルの識別子50(文房具 > 20%)に関連付けられている場合、分割回数のフィールドには次のように入力します。

Plain text
6, 50

この形式により、DEUNAは最大分割回数と適用される商用条件の両方を認識し、支払いプロセスを円滑に進め、店舗の商用ポリシーを正しく適用できます。

この設定方法を説明するチュートリアルを次に示します

重要上記で設定した分割払い設定は参照用であり、ウィジェットが設定を認識できるようにします。 VTEXで設定された商用条件は、購入者に表示されません。

ステップ3: DEUNAでの分割払い処理のためのルール設定(商業条件付き)

前の手順でDeunaNowの支払い方法に商用条件の識別子を設定した後、DEUNAの管理画面でルールを設定することが非常に重要です。 これにより、ウィジェットがどの商用条件に基づいて支払いプロセスを実行するかを識別できます。 商用条件に基づいて分割払いを行うために、DEUNAでルールを設定するには、次の手順を実行する必要があります。

  • DEUNAの管理者アカウント(ユーザー名とパスワード)を入力し、「決済戦略」モジュールを選択してください。
  • 「特定のルールを作成」ボタンをクリックし、ルールに名前を入力します。 商用条件のルールを識別できるように、名前を使用することをお勧めします。 次に、「次のステップに進む」ボタンをクリックします。
  • 「条件を追加」セクションで、「条件を追加」ボタンをクリックし、「メタデータ」オプションを探してください。
  • Metadataでは、変数名 "commercial condition" 、 フォーマットタイプ "Text", プロパティ: "({}) が格納され、前のステップで使用した識別子番号を追加します。 例:50(文具対応>20%)
  • 情報を追加したら、「メタデータを保存」ボタンをクリックし、その後「保存」ボタンをクリックして次の手順に進みます。
  • 「特定のルールを作成」セクションに戻ったら、「次の手順へ」ボタンをクリックしてください。
  • 「取引処理の順序を定義」セクションで、「ルーティングを編集」ボタンをクリックし、設定した商業条件に対応する処理(接続)を選択します。例:「Mercadopago - 特殊文具」。
  • 処理ルールを選択し、「保存」ボタンをクリックします。これで、商業条件に対する特定のルールの設定が完了します。

この設定方法を説明するチュートリアルを次に示します

VTEX 商業条件に対応した分割払い機能をDEUNAで設定します。


DEUNA を識別するための商用条件の例#

以下の表には、商業条件名の例と、推奨される識別子を示しています。商業条件ルール名は、VTEXで設定した商業条件の名前を指します。一方、DEUNAでの識別のためには、49以上の数字を使用することを推奨します。

この数字は、PSP(決済サービスプロバイダー)の設定時に、DEUNA管理画面で設定するものです。

以下の表には、商業条件を識別するための推奨例を示します。ここで:

  • 商業条件ルール名: VTEXで設定した支払い方法のルールと、商業条件の名前
  • 識別子:DEUNAウィジェットが使用する商業条件を識別するための識別子。この識別子は、VTEXの商業条件との連携で分割払い設定を行う際に使用されます。この識別子は49以上の数字である必要があります。
#商用条件のルール名 (例)識別子
1技術商品 > 10%49
2文具 > 20%50
3文具 > 10%58
4衣料品 > 1%51
5文具、特殊商品 > 20%52
6衣料品 > 20%53
7食料品 > 20%54
8パーソナルケア用品 > 20%55
9ギフトカード > 20%56
10Preventa テクノロジー関連商品 > 1%57

VTEX における商用条件とは?#

VTEXにおける商用条件とは、商人がプラットフォーム上で特定の決済シナリオ(決済条件)を定義するために、さまざまな製品(SKU)をグループ化できるリソースです。 特別な決済条件を設定する場合、商用条件を有効にすることができます。 VTEXは、カート合計の割合に基づいて、その商用条件を有効にするタイミングを設定できます。 たとえば、VTEXのストアで、以下の製品を販売している場合を考えてみましょう。

製品名Value
Tシャツ1000
パンツ1500
シャツ1200
ドレス2500
携帯電話5000
コンピューター10000
タブレット6000

ストアのオーナーとして、衣料品やテクノロジーといったカテゴリに製品をグループ化する商用条件を確立したいかもしれません。 また、衣料品のトランザクションをMercadoPago(決済条件)を通じて、テクノロジーのトランザクションをStripe(決済条件)を通じて処理したいと考えているかもしれません。

以下のルールを設定することができます。 衣料品の製品の合計がカート合計の20%を超えると、それらはMercadoPagoを通じて処理されます。 同様に、テクノロジー製品の合計がカート合計の20%を超えると、それらはStripeを通じて処理されます。 以下に設定例を示します。

#VTEXの支払い条件における商取引条件関連製品結果
1カート合計の20%を超える金額の衣類Tシャツ、パンツ、シャツ、ドレスProcess by MercadoPago
2テクノロジー > カート合計の20%携帯電話、コンピューター、タブレットProcess by Stripe

例:

  • シナリオ1: 購入者は10枚のTシャツと10枚のパンツ、および1台の携帯電話を購入します。
製品数量該当する商用条件合計金額
Tシャツ10衣料品10000
パンツ10衣料品15000
携帯電話1テクノロジー5000
CART TOTAL30000

衣料品の商用条件がカート合計の80%を超えると、MercadoPagoを通じて処理されます。 一方、テクノロジー条件は合計の16%であり、有効化されません。

  • シナリオ 2: 購入者は1台の携帯電話、1台のコンピューター、1台のタブレット、および1枚のTシャツを購入します。
製品数量該当する商用条件合計金額
携帯電話1テクノロジー5000
コンピューター1テクノロジー10000
タブレット1テクノロジー6000
Tシャツ1衣料品1000
CART TOTAL

テクノロジーの商用条件がカート合計の90%を超え、Stripeを通じて処理されます。 衣料品は、合計の4.55%であり、有効化されません。

要するに、VTEXにおける商用条件により、商人は異なる支払い条件(MercadoPagoやStripeなどの支払い方法)に基づいて、カート合計の割合に応じた設定を行うことで、異なるPSPを処理できます。これにより、支払い設定に応じて異なるPSPを管理できます。