よくある質問
一般的な質問（管理者、API、決済、SDK、プラグイン、テスト、Webhookなど）に関する、最新のDEUNAガイドを参照してください。
これらの回答は、構成やAPI契約の重複を避け、変更される可能性のある現在の情報源を参照します。ページに機能が記載されていない場合は、未確認とみなし、DEUNAの技術アカウントマネージャー（TAM）に確認してください。
管理画面#
DEUNA Adminへのアクセス方法は？
組織の承認されたオペレーターが、あなたを招待し、必要な役割を割り当てる必要があります。まず、 ユーザーとロールの管理から開始し、次に 二段階認証 を設定してください（アカウントまたは組織が必要な場合）。APIの認証情報だけではAdminセッションを作成できません。
どのプロセッサまたは支払い方法を設定しますか？
開きます 接続 管理画面で設定し、そのプロバイダのガイドを参照してください。認証情報と利用可能性は、アカウントと環境によって異なります。 接続 ワークフローを理解するために、 プロバイダーカタログ 設定する前に、その機能が有効になっていることを確認するために使用してください。
チェックアウトの外観をカスタマイズできますか？
はい。サポートされているコントロール内でカスタマイズできます。DEUNAテーマの設定には、 テーマと共有コントロール を使用し、プラグインまたはSDKが独自の制約を追加する場合、その統合固有のカスタマイズページを使用してください。変更後も、コントラスト、フォーカス、モバイルレイアウトが使用可能であることを確認してください。
API統合#
API経由での直接統合は可能ですか？
はい。 APIのクイックスタート を信頼できるバックエンドから実行し、その後、 エンドポイント: カタログ 公開の要求と応答の契約を正確に示します。ブラウザやモバイルアプリケーションには、プライベートなAPIキーを配置しないでください。
どの認証情報を利用すべきですか？
回答は、要求が実行される場所と、必要な権限によって異なります。クライアント側のSDKは、ドキュメント化された公開アプリケーションコンテキストを使用します。信頼できるサーバー間での操作には、プライベートなAPIキーを使用します。また、サポートされている、認証された顧客フローでは、さらに顧客のBearerトークンを使用できます。決定表とヘッダーの例は、 認証とAPIキー.
本番環境への影響を避けてテストするには？
サンドボックスの認証情報と、 統合の基本に記載されているサンドボックスベースURLを使用してください。サンドボックスと本番環境のキー、ウェブフック、プロバイダアカウント、および商人の設定を分離してください。本番環境への有効化をリクエストする前に、成功および失敗の両方のフローを検証してください。
レスポンスとエラーコードはどこで説明されていますか？
次の エラーと復旧 このドキュメントは、公開ステータスコードと安全な復旧について説明しています。特定のエンドポイントに関するドキュメントが、そのリクエスト、レスポンス、対象者、および認証要件について、最も正確な情報を提供します。
チェックアウト、SDK、プラグイン#
どのチェックアウト統合を選択すればよいですか？
必要なユーザーエクスペリエンス、実行環境、および決済データの信頼境界に基づいて選択してください。 Web Checkout 主要なWebパスを比較し、 SDKの概要 Web、iOS、Android、およびReact Nativeの役割を定義します。
SDK のメソッドとコールバックはどこにありますか？
こちらから SDKの概要, 選択したプラットフォームを使用し、共有 イベント および 応答 関連する参照箇所を参照してください。同様の機能が、すべてのプラットフォームで同じ方法を使用するとは限りません。
どのような支払い方法を表示できますか？
支払い方法の利用可能性は、国、通貨、チャネル、プロバイダーとの接続、およびアカウント設定によって異なります。 生成された プロバイダーカタログその後、選択したプロバイダーまたは支払い方法の手順に従ってください。スクリーンショットや他の商社のチェックアウトから利用状況を推測しないでください。
VTEX プラグインを通じて統合できますか？
使用する プラグイン VTEX などの、サポートされている e コマースプラットフォームとの統合については、 VTEX の概要、インストールと設定ガイドを完了し、本番環境への展開前にサンドボックスでの購入を実行してください。
クーポンの利用、税金、配送、チップなどがチェックアウトにどのように影響するか？
これらの機能は、アカウントで設定された場合に、商社固有の同期コールバックを使用できます。 動的チェックアウト用 Webhook このガイドでは、実行範囲、リクエストとレスポンスのマッピング、検証、およびエラー処理について説明します。 貴社の承認済みでないコールバックイベントや、変更可能なフィールドは使用しないでください。
ウェブフックと決済結果#
Webhook は必要ですか？
ステータス Webhook は、バックエンドがブラウザ、リダイレクト、または SDK コールバックに依存せずに、非同期決済の変更にリアルタイムで対応する必要がある場合に利用します。一部の決済方法は、顧客がチェックアウトを完了した後で最終状態に到達します。 署名付き通知フロー および、履行またはその他の不可逆的な操作を行う前に、信頼できる注文の状態を確認します。
Webhookが遅延、重複、または順序が異なる場合、どうすればよいでしょうか？
署名を検証し、通知を永続的に受け入れ、重複を排除し、古いイベントがローカルレコードを前に移動するのを防ぎます。 配信は、正確な処理またはライフサイクル順序のセマンティクスを証明するものではありません。 以下の手順に従ってください。 受信を確認し、調整します および、解決されていない支払いについては、別の照合プロセスを使用してください。
SDKコールバックまたはブラウザリダイレクトは、支払いの証明になりますか？
いいえ。顧客体験には、クライアント側の完了が役立ちますが、バックエンドは、履行前に、ドキュメントされたサーバー側の結果と非同期のステータスフローを使用する必要があります。 UIの状態、支払い状態、および決済状態を別々の問題として扱う必要があります。
ドキュメントとAIツール#
AIコーディングエージェントは、これらのドキュメントを検索できますか？
はい。互換性のあるクライアントを、読み取り専用の DEUNA Docs MCP サーバーに接続します。。 サイトで公開されている同じ公開ドキュメント、エンドポイントインベントリ、およびプロバイダカタログを検索し、DEUNAの資格情報は必要ありません。
機能がドキュメントされていません。動作すると仮定してもよいですか？
いいえ。DEUNAのTAMまたは該当する公開契約の所有者に確認してください。 環境、製品、プロバイダ、意図された操作、および確認した公開ページを含めてください。ただし、APIキー、トークン、カードデータ、秘密鍵、および顧客データを伏せてください。