POSThttps://api.sandbox.deuna.io/v2/merchants/orders/purchase
注文の支払い処理
は、既存の注文またはDEUNAで設定された支払いおよびルーティングフローを処理します。
この商社向けバックエンド操作を使用して、既存の注文トークンまたはリクエストに含まれる注文を処理します。DEUNAは、商社に設定された支払い接続、ルーティング、リスク管理、および決済処理を行います。
Headers#
4X-Api-Keystring必須
API Gatewayによって検証されたプライベート商社アプリケーションキー。
例
YOUR_PRIVATE_API_KEYAuthorizationstringオプション
顧客固有の支払い方法および保存された決済手段のためのオプションの認証されたユーザーコンテキスト。
例
認証トークン: USER_ACCESS_TOKENX-Store-Codestringオプション
商人が特定の構成を持つ場合にコンテキストを保存します。
例
主要Content-Typestring必須
必須
application/json.パスパラメータ#
0このエンドポイントにはパスパラメータはありません。
リクエストボディ#
8order_tokenstringオプション
既存の注文のトークン。このフィールドまたは
注文 DEUNAが作成できるオブジェクト。orderobjectオプション
注文の詳細情報を、支払い処理と注文の作成を1つのリクエストで実行する場合。
payer_infoobject必須
顧客の識別情報。APIは、
payer_info.email が利用可能です。子属性を表示
payer_info.emailstring必須
支払いを識別するために使用される顧客のメールアドレス。
payer_info.external_user_idstringオプション
加盟店システム内の顧客識別子。
payment_sourceobject必須
決済処理に使用される、支払い方法および接続データ。
子属性を表示
payment_source.method_typestring必須
支払い方法の種類、例えば
credit_card または、サポートされているウォレット。payment_source.payment_methodstringオプション
DEUNAクライアント統合によって生成されたトークン。
payment_source.payment_method_idstringオプション
フローが要求する場合に、商人の決済プロセッサ識別子。
payment_source.card_infoobjectオプション
カード決済フローにおける、トークン化されたまたはPCIコンプライアンスに対応したカードの詳細。
anti_fraud_infoobjectオプション
設定された不正検知サービスによって収集される、顧客、デバイス、ブラウザ、およびリスクコンテキスト。
callback_urlsobjectオプション
成功、保留、拒否、キャンセル、または失敗状態における、顧客のリダイレクト先。
specific_fieldsobjectオプション
選択された接続によって要求される、プロバイダーまたは支払い方法固有のフィールド。
subscriptionobjectオプション
サブスクリプションのコンテキスト。購入がサポートされているサブスクリプションを作成または更新する場合。
QSR、航空会社、映画館、銀行、および小売の完全な業界注文から開始#
次の order 上記のフィールドは、Orders APIによってモデル化された同じビジネス文脈を受け入れます。より明確な復旧と再試行フローのために、まず注文を作成し、その order_tokenを保持し、このリクエストでトークンを送信します。
QSRメニュー、モディファイ、履行、スケジュール、および指示。航空会社PNR、乗客、チケット、旅程、運賃、税金、および付加サービス。映画館上映、会場、座席、チケットの配信、およびコンシェルジュ。銀行アカウント決済、商品、チャネル、およびステートメントの文脈。小売商品、バリエーション、割引、配送、および履行。
応答#
処理された注文に関する情報を返します。 order_token、注文タイプ、結果の状態、支払い情報、および該当する場合のサブスクリプション情報。返された状態を権威として扱い、商社のウェブフックを通じて非同期追跡を続行します。
ステータスコード
200注文の支払いが処理されました。ビジネス上の結果を確認するために、返された注文と支払いステータスを確認してください。
400リクエストが無効であるか、必要なペイヤーまたは支払い元に関するデータが不足しています。
401プライベートAPIキーまたは顧客の認証コンテキストが無効です。
409この操作は、現在の注文の状態または以前の冪等なリクエストと競合します。
429リクエストレート制限を超えました。
Retry-After が返されます。Idempotency#
この購入操作に対して、ゲートウェイは冪等性を適用します。安定した X-Idempotency-Key 同じトランザクションに対して、同じキーとボディをネットワークタイムアウト後に再利用します。 異なるトランザクションには、新しいキーを使用してください。
- キーは、ブラウザやモバイルコードではなく、商社側のバックエンドで生成してください。
- 異なるリクエストボディで同じキーを再利用しないでください。
- 不確実な結果を解決するために、新しいトランザクションを開始する前に、注文情報を取得してください。
詳細は、 エンドポイントへの登録完了, 認証, および エラーコード.
このページは役に立ちましたか？