一般的なウィジェット設定
DEUNAのチェックアウトウィジェット全体で、ローカリゼーション、URL、認証、および共有動作を設定します。
以下の設定を使用すると、各商社の特定のニーズに合わせて、チェックアウトの動作と外観をカスタマイズできます。
言語#
チェックアウトインターフェースの言語は、貴社の事業を展開している国に基づいて自動的に設定されます。
この設定は、購入者の利便性を高め、コンバージョン率を向上させることを目的としています。
- 言語は、注文のトークン化を通じて定義されます。
- 言語は、注文ごとに動的に指定できます。
基本URL#
特定の支払いリンクの基本URLをカスタマイズしたい場合は、当社のサポートチームにお問い合わせください。このカスタマイズにより、ブランドイメージに合わせた体験を提供できます。
例: https://payhere.yourbrand.deuna.com
ユーザー認証を有効にする#
DEUNAは、購入者がゲストとして、または認証されたユーザーとしてチェックアウトを完了できるように設定できます。認証されたユーザーは、保存されたカードと過去の購入データにアクセスできます。この動作は、以下の2つの変数で制御されます:
| 変数 | Type | 説明 |
|---|---|---|
user_authentication_flow | boolean | 認証されたユーザーフロー(ログイン、OTP、保存されたカード)を有効にします。 |
init_with_guest_user | boolean | ゲストユーザーフロー(ログイン不要)を有効にします。 |
これらの変数は、商取引設定を作成または更新する際に、 widgets_general_config.user_experience 内で設定します。
{
"widgets_general_config": {
"user_experience": {
"user_authentication_flow": true,
"init_with_guest_user": false
}
}
}ユーザーが認証フローを表示するかどうかは、どのように決定されますか?
user_authentication_flow: true`` を設定した場合、DEUNAは優先順位に基づいて、どのユーザーを表示するか(および、どの保存されたカードを表示するか)を決定します。 より上位で定義された値が優先されます。 常に上書きします その下層レベルについて:
| 優先度 | ソース | 説明 |
|---|---|---|
| 1 (最高) | クエリパラメータ userToken | もし、商人がウィジェットを初期化する際に、明示的に userToken を送信した場合、そのユーザー設定が優先されます。 |
| 2 | 商人の設定 | もし、 userToken が送信されない場合、 widgets_general_config.user_experience で定義された設定が使用されます。 |
| 3 (最低) | 注文/請求メール | もし、 userToken と適用される設定がない場合、決定は注文または請求データで受信したメールのみに基づいて行われます。 |
例 — 明示的な userToken:
deunaSDK.initElements({
orderToken: "YOUR_ORDER_TOKEN",
userToken: "YOUR_USER_TOKEN", // overrides merchant config and order email
// ...other initialization parameters
});初期化時に設定を上書きする: onlyCardEnrollment
内部で送信されるパラメータ behavior 初期化時に WebSDK le permite anular ciertos flujos definidos en su configuración de comerciante, sin cambiar esa configuración.
onlyCardEnrollment 認証されたユーザーの保存されたカードを非表示にし、新規カードの登録のみを可能にします。これは、商社が独自のUIからユーザーの保存されたカードを表示し、カード登録フォームの処理のみをDEUNAに委託する場合に推奨されます。
onlyCardEnrollment 上記の優先順位テーブルの結果を上書きします。通常、 userToken またはアクティブ user_authentication_flow は保存されたカードを表示しますが、このフラグを使用すると、セッション中はカードが非表示になります。
外部認証機関 (userToken) | OTP (ワンタイムパスワード)user_authentication_flow) | onlyCardEnrollment | 保存されたカードは表示されますか? |
|---|---|---|---|
| ✅ | ❌ | ❌ | ✅ |
| ✅ | ❌ | ✅ | ❌ |
| ❌ | ✅ | ❌ | ✅ |
| ❌ | ✅ | ✅ | ❌ |
例:Vault Widget WebSDK の設定:
await DeunaSDK.initElements({
orderToken: "<ORDER_TOKEN>",
userToken: "<AUTHENTICATION_TOKEN>",
userInfo: { /* ... */ },
behavior: {
onlyCardEnrollment: true,
// ...other behavior overrides
},
callbacks: { /* ... */ },
},
});カードの保存を有効にします。#
ユーザーがゲストとして、または認証されたユーザーとして決済を行うかを選択するだけでなく、カードの保存に関する動作を構成することも可能です。
| 変数 | Type | 説明 |
|---|---|---|
show_saved_cards_flow | boolean | 表示 チェックボックス これにより、購入者は支払い時にカードを保存するかどうかを選択できます。無効化した場合(false(デフォルト設定の場合)、カード情報は自動的に保存され、ユーザーに確認を求めることなく、これにより将来の購入でのコンバージョン率が向上します。 |
default_card_flow | boolean | 追加のチェックボックスを表示し、ユーザーがそのカードを「デフォルト」カードとしてマークするかどうかを選択できるようにします。 デフォルト 将来の購入のために。デフォルトで無効化されています。 |
両方の変数は、また、内部で設定されています。 widgets_general_config.user_experience:
{
"widgets_general_config": {
"user_experience": {
"show_saved_cards_flow": true,
"default_card_flow": true
}
}
}カードの保存を有効にします。#
チェックアウト時に、購入者がカードを保存するかどうかを選択できるチェックボックスを表示することが可能です。このオプションは、ゲストフローに適しています。
デフォルトでは、チェックボックスを表示せず、コンバージョンを向上させるためにカードを自動的に保存しません。
カードの削除を許可する#
購入者がチェックアウト時に保存されたカードを削除できるかどうかを制御します。 Vault Widget推奨。サブスクリプションや定期的な請求モデルにおいて、誤って支払い方法が削除されるのを防ぎ、不要な解約を防ぐために使用します。
| 変数 | Type | デフォルト | 説明 |
|---|---|---|---|
allow_card_deletion | boolean | true | 購入者がカードを削除できるかどうかを決定します。 falseすべての削除操作は非表示になります。 |
設定は、 widgets_general_config.user_experience:
{
"widgets_general_config": {
"user_experience": {
"allow_card_deletion": false
}
}
}UI の動作を制御します。
| 州 | 有効なカード | 期限切れのカード | デフォルトカード | 単一のカード表示 |
|---|---|---|---|---|
false (Disabled)の特長 | メニューから「削除」を非表示にします(「デフォルト設定」のみが表示されます)。 | ゴミ箱アイコンを非表示にします。 | 操作メニュー全体を非表示にし、空のポップアップを防ぎます。 | 削除ボタンを非表示にします。 |
true or 省略 (デフォルト) | 標準的な削除機能がメニューにあります。 | ゴミアイコンが表示され、有効。 | 標準的な削除機能がメニューにあります。 | 削除ボタンが表示され、有効。 |
視覚的なスタイル#
CustomStyleを使用してウィジェットをカスタマイズします。
お客様の視覚的な体験を、自社のブランドガイドラインに合わせて調整します。