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

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

1. Create a sandbox if you don’t have an existing one. You use the sandbox to add and test rules before going live.
2. ダッシュボードの Orchestration ページで、ルールを追加 をクリックします。
3. この例では、Card country が United Kingdom の場合に利用可能な決済代行業者の 1 社に、支払いを経路選定する条件を指定して、ルールを追加します。条件が満たされない場合に支払いを Stripe に転送するアクションを追加します。
4. テストルールを有効化 をクリックします。

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 doesn’t support the Setup Intents API and flexible acquiring features on other processors. For transactions that involve a 3D Secure request, you’re responsible for providing Stripe with the Acquirer BIN that corresponds to the processor you route those transactions to. Check with your Stripe representative if you’re unsure whether Orchestration supports the features you use.

テストカードを使用して、ルールで指定された決済代行業者に 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

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

The Payment Record contains the execution history for payments where Orchestration is enabled. Retrieve the Payment Record using its ID from the PaymentIntent.

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 分析ページでは、全体的な決済の成功率を分析して、決済が失敗した箇所を確認できます。決済代行業者フィルターを使用して、特定の決済代行業者を経由した決済のみを表示します。

The Dashboard doesn’t currently display balance summary and activity reports, dispute status, or receipts for payments processed on other processors. Data can take up to 2 days to populate. The Orchestration data that we share in the Dashboard relies on data provided by you and your other processors.