決済を複数の処理業者にルーティングする非公開プレビュー

ルールには、決済を特定の決済代行業者に振り分けるための条件とアクションが含まれます。

1. 既存のサンドボックスがない場合は、サンドボックスを作成します。本番環境に移行する前に、サンドボックスを使用してルールを追加およびテストします。
2. ダッシュボードの Orchestration ページで、ルールを追加 をクリックします。
3. この例では、Card country が United Kingdom の場合に利用可能な決済代行業者の 1 社に、支払いを経路選定する条件を指定して、ルールを追加します。条件が満たされない場合に支払いを Stripe に転送するアクションを追加します。
4. [オプション] メインの決済代行業者で支払いが失敗した場合に、支払いを再試行する決済代行業者を追加します。
5. テストルールを有効化 をクリックします。

PaymentIntent を作成するときは、payments_orchestration パラメーターを含めて Orchestration を有効にします。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=500 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d payment_method=pm_card_visa \
  -d "payments_orchestration[enabled]"=true \
  -d confirm=true

Orchestration は、Setup Intents API と他の決済代行業者の柔軟なアクワイアリング機能をサポートしていません。3D セキュアのリクエストを伴う取引について、お客様は、当該取引を転送する決済代行業者のアクワイアラー BIN を Stripe に提供する義務を負います。使用している機能が Orchestration でサポートされているかどうか不明な場合は、Stripe の担当者に確認してください。

テストカードを使用して、ルールで指定された決済代行業者に Stripe が決済を振り分けることを確認します。たとえば、カードの国がイギリスに相当する場合に、選択した決済代行業者に決済が振り分けられるかどうかをテストするには、テスト用の payment メソッド pm_card_gb を使用します。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=12345 \
  -d currency=gbp \
  -d "payment_method_types[]"=card \
  -d payment_method=pm_card_gb \
  -d "payments_orchestration[enabled]"=true \
  -d confirm=true

テスト用の支払いを作成したら、決済の詳細ページを表示して、決済がどの代行業者に割り当てられたかを確認します。決済の詳細ページで、決済代行業者は 代行業者 の下に表示されます。最近のアクティビティ には、決済代行業者と決済を振り分けたルールも表示されます。リンクをクリックすると、この決済を振り分けたルールが表示されます。

Payment Record には、Orchestration が有効になっている決済の実行履歴が含まれます。PaymentIntent の ID を使用して Payment Record を取得します。

curl https://api.stripe.com/v1/payment_records/{{PAYMENT_RECORD_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

または、Workbench の Inspector に Payment Record ID を入力します。

processor_details ハッシュを表示して、決済がどの処理業者にルーティングされたかを確認します。

{
  "id": "pr_123456",
  "object": "payment_record",
  "amount_authorized": {
    "currency": "gbp",
    "value": 12345
  },
  ...
  "processor_details": {
    "type": "processor_a",
    ...
  },
  ...
}

実装をテストしたら、サンドボックスを終了して本番環境のシステムのルールを追加します。ルールをアクティブにすると、Orchestration はすぐに有効になります。支払い経路を選定するための、その他の条件とアクションの詳細をご覧ください。

代行業者のパフォーマンスを監視する

本番環境の決済に対して Orchestration を有効にした後、決済代行業者全体のパフォーマンス分析と決済成功率を監視できます。

• Orchestration の概要ページでは、決済代行業者間のパフォーマンス分析と支払い成功率にアクセスできます。また、このデータを絞り込んで、通貨、カードブランド、カードの国、カードの種類、取引の種類別にパフォーマンスを確認することができます。
• 支払いの詳細ページで、個々の支払いの決済代行業者の情報を表示できます。
• Payments 分析ページでは、全体的な決済の成功率を分析して、決済が失敗した箇所を確認できます。決済代行業者フィルターを使用して、特定の決済代行業者を経由した決済のみを表示します。

現在ダッシュボードには、その他の決済代行業者で処理された決済に関する残高サマリーとアクティビティレポート、不審請求の申し立てステータス、領収書は表示されません。データは、入力されるまでに最大 2 日かかる場合があります。ダッシュボードで共有される Orchestration データは、お客様および他の決済代行業者から提供されるデータに基づきます。