DEUNA App Walletの設定
概要#
このガイドは、 Deuna App Wallet の、Deuna Adminパネルにおける、商社側の設定について説明します。 設定は、お客様が使用する決済方法を決定する、一度の設定です。
設定へのアクセス#
ステップ 1: Deuna Adminにログイン
- Deuna Adminのページに移動
- ご登録の商社情報をご入力ください
- クリック ログイン
ステップ 2: 決済方法の選択
- 左側のサイドバーから、 接続
- をクリック 支払い方法
- 検索 Deuna App Wallet リストから
初期設定#
Deuna App Walletの有効化
もし Deuna App Wallet はまだ有効になっていません:
- Payment Methodsリストから Deuna App Wallet を探す
- クリック 有効にする または 追加
- 設定パネルが開きます。 フォームを使用してプロセッサを追加します。
- すべての4つの必須フィールドに入力してください (詳細は下記を参照) 決済方法
- ご希望の 決済方法は現在有効になり、チェックアウト時にお客様に選択肢として表示されます。 決済方法
- クリック 保存
Deuna App Wallet プロセッサの追加
を有効にするには:
Deuna App Walletの設定パネルで Deuna App Wallet、Deuna App Walletのアカウントから、関連する決済プロセッサと認証情報を追加する必要があります。
を追加する:
- Deuna App Walletの設定パネルで
- クリック を追加 または 設定
- 以下の4つの必須フィールドに入力してください:
必須フィールド
| フィールド | 説明 | 例 | 備考 |
|---|---|---|---|
| Public API Key | 「APIキー」としてDeuna App Walletで呼ばれます。 | pub_abc123xyz789 | ヘッダーにマッピング x-api-key |
| Private API Key | Deuna App Wallet で「API Secret」と呼ばれています | sec_abc123xyz789 | ヘッダーにマッピングx-api-secret |
| POS (レジ) | Deuna App Wallet で「CAJA」と呼ばれています | 4200069 | 販売時点の識別子 |
| 形式 | 支払いコードの種類 | QR または CODIGO_6_DIGITOS | 顧客が QR コードまたは 6 桁のコードを受け取るかどうかを決定 |
ステップバイステップのフォーム
重要:
- これらのフィールドはすべて 必須
- あなたの資格情報は、Deuna App Walletのビジネスアカウントから取得されます
- この形式の選択は、すべての注文の支払いモードを決定します
- 保存後、認証情報は暗号化され、安全に保存されます
支払い形式の選択#
プロセッサのフォームに入力する際に、ご自身の 支払い形式を選択する必要があります。これは、クレデンシャルを追加するときに決定され、お客様が支払いフローとどのように相互作用するかを決定します。
支払い形式の選択ガイド
| 側面 | 数値コード (CODIGO_6_DIGITOS) | QRコード |
|---|---|---|
| 顧客が確認 | 6 桁のコード | 動的QRコード |
| 時間制限 | 3分 | 15分 |
| 支払い方法 | アプリに入力 | スキャンまたはクリック |
| 以下の用途に適しています | デスクトップ/タブレットチェックアウト | モバイルファーストチェックアウト |
| ユーザーエクスペリエンス | 手動入力が必要 | 迅速なワンタップ/スキャン |
| フィールド値 | CODIGO_6_DIGITOS | QR |
形式1: 数値コード (CODIGO_6_DIGITOS, 3分)
以下のいずれかを選択してください：
- お客様は主にデスクトップ/タブレットを使用
- 迅速な決済フローをご希望
- お客様のチェックアウトフローは複数のデバイスで動作
- シンプルさを重視し、依存関係を最小限に抑えたい
仕組み:
- 顧客は6桁のコードを確認
- コードは有効期限が3分
- 顧客はDeunaアプリを開き、コードを手動で入力
- アプリ内でコードを入力後、顧客は確認
- 支払い確認はWebhook経由
以下の形式を選択するには:
- プロセッサ設定フォーム
- 「設定」セクションの下 形式、 数値コード (CODIGO_6_DIGITOS)
- フォームを完成させ、保存 プロセッサを保存
検証:
- 保存後、確認メッセージが表示されます
- 以降の注文はすべて6桁の数字を使用
形式2: QRコード（15分）
以下のいずれかを選択してください：
- 主な顧客はモバイルユーザー
- より柔軟なトランザクション期間を希望
- モダンでワンタップでの体験を重視
- ターゲット市場ではQRスキャンが一般的
仕組み:
- 顧客は動的なQRコードを確認
- QRコードは正確に15分有効
- 顧客は以下のいずれかを選択できます:
- スキャン Deunaアプリのカメラで
- クリック アプリを直接開く
- 支払い確認はWebhook経由
以下の形式を選択するには:
- プロセッサ設定フォーム
- 「設定」セクションの下 形式、 QRコード
- フォームを完成させ、保存 プロセッサを保存
検証:
- 保存後、確認メッセージが表示されます
- 以降の注文はすべてQRコードを使用します
設定パネル#
設定トラブルシューティング
問題: Deunaアプリのウォレットが支払い方法リストに表示されない
解決策:
- ページをリフレッシュ
- 「Payments」権限がユーザーロールに設定されているか確認
- Deunaサポートに連絡し、Deunaアプリのウォレットがアカウントに設定されているか確認
問題: プロセッサが保存されない、またはエラーが表示される
解決策:
- 以下の4つのフィールドがすべて入力されていることを確認:
- 公開APIキー (空ではない)
- プライベートAPIキー (空ではない)
- 販売点/CAJA (数値文字列、空ではない)
- 選択された形式 (QRまたは数値コード)
- Deunaアプリのウォレットアカウントから、資格情報を確認
- Deunaアプリのウォレットダッシュボードで資格情報をテスト
- 別のブラウザで試す
- 問題が解決しない場合は、Deunaサポートに連絡
問題: 顧客がチェックアウト時にDeunaアプリのウォレットが見られない
検証:
- Deunaアプリのウォレットは 有効 (有効)
- プロセッサが正しく設定されている (4つのフィールドすべて入力済み)
- 顧客の注文は USD currency
- 顧客は認証プロセスにいます エクアドル (またはエクアドルでの請求先住所を使用)
- 支払いウィジェットには
deuna_walletプロセッサが含まれる - 注文トークンが正常に生成
すべての認証が成功した場合：
- Deunaサポートに連絡
権限とアクセス#
必要な管理者役割
Deunaアプリの設定には、以下の権限が必要です:
- 接続 - 読み取り/書き込み権限
- 支払い方法 - 読み取り/書き込み権限
- Webhooks - 読み取り/書き込み権限 (Webhook設定用)
権限がない場合は:
- アカウントの所有者または管理者にお問い合わせください
- 許可を付与できます ユーザーロールと権限 セクション
マルチアドミン設定
複数の管理者で支払い設定を行う場合:
- すべての設定変更は、すべての管理者で確認可能
- 管理者であれば、支払い方法の変更が可能です（ただし、事前に関係者への連絡をお勧めします）。
- 変更履歴を追跡するために、監査ログを有効にします。
- [Go to] ユーザーロールと権限
- 有効にする アクティビティログ
ベストプラクティス#
設定
✅ 推奨される手順:
- 設定後、Webhookの接続性をテストする
- お客様のベースに合わせて支払い方法を選択する
- 有効化前に、払い戻しの制限を確認する
- チームへの選択理由を文書化する
❌ 推奨されない手順:
- 事前にチームに通知せずに、Deuna App Walletを無効化しない
- 理由なく、支払い方法を頻繁に変更しない
- Webhook URLを、安全でないチャネルで共有しない
- 注文ごとに支払い方法の変更が可能であると誤認しない（変更はできません）
監視
✅ 推奨される手順:
- 支払いに関する指標を毎週確認する
- Webhookの配信ログを定期的に確認する
- 払い戻しリクエストの傾向を監視する
- Webhookの接続性を毎月テストする
❌ 推奨されない手順:
- Webhookのエラーを長期間無視する
- 商人のオンボーディングテストをスキップする
- バックエンドを変更した場合、Webhook URLを更新しない