バージョン: 最新版

Routing Group Rules API

Routing Group Rules APIを使用すると、異なる決済プロバイダーやアクワイアラー間でトランザクションの処理方法を制御する決済ルーティングルールを作成および管理できます。これにより、高度な決済オーケストレーション戦略が可能になります。

概要

Routing Group Rulesが提供するもの:

決済オーケストレーション - ルールに基づいて異なるプロバイダーにトランザクションをルーティング
負荷分散 - トランザクションボリュームを複数のアクワイアラーに分散
フェイルオーバーサポート - プライマリが失敗した場合に自動的にバックアッププロバイダーにルーティング
コスト最適化 - トランザクションコストと手数料に基づいてルーティング
地理的ルーティング - 顧客またはカードの場所に基づいて支払いを誘導
カードタイプルーティング - 特定のカードタイプを最適なプロバイダーにルーティング

ルーティングルールの仕組み

ルール定義 - 条件とターゲットプロバイダーを持つルーティングルールを作成
優先度設定 - ルール評価順序を決定する優先度を割り当て
条件適用 - ルールがいつマッチするかを指定（金額、通貨、カードタイプなど）
アクション設定 - マッチしたトランザクションをどこにルーティングするかを定義
パフォーマンス監視 - ルーティング決定を追跡し、ルールを最適化

ルール条件

ルールは様々なトランザクション属性でマッチできます:

金額条件

最小および最大トランザクション金額
通貨別の閾値

カード条件

カードブランド（Visa、Mastercardなど）
カードタイプ（クレジット、デビット、プリペイド）
発行国
BINレンジ

通貨条件

トランザクション通貨
決済通貨

メタデータ条件

カスタムメタデータフィールド
加盟店カテゴリコード

ユースケース

マルチアクワイアラーセットアップ

カードタイプまたは金額に基づいて異なるアクワイアラーにトランザクションをルーティングし、承認率とコストを最適化します。

地理的最適化

国内トランザクションはより良いレートのためにローカルアクワイアラーに、国際トランザクションはグローバルプロバイダーにルーティングします。

フェイルオーバー設定

プライマリプロバイダーに問題が発生した場合にアクティブ化するバックアップルーティングルールを設定します。

コスト最適化

低額トランザクションは取引単価の低いプロバイダーに、高額トランザクションは手数料率の低いプロバイダーにルーティングします。

リスク管理

高リスクのトランザクションパターンを強化された不正検出機能を持つプロバイダーにルーティングします。

利用可能なエンドポイント

ルーティングルール作成 - POST /routing_group_rules

ルール構造

各ルーティングルールに含まれるもの:

識別

id - 一意のルール識別子
name - 人間が読めるルール名
description - 詳細なルール説明

条件

conditions - 条件オブジェクトの配列
match_type - 条件の組み合わせ方法（all/any）

アクション

provider - ターゲット決済プロバイダー
priority - ルール評価順序
weight - 負荷分散の重み（オプション）

ステータス

enabled - ルールがアクティブかどうか
created_at - 作成タイムスタンプ
updated_at - 最終更新タイムスタンプ

ベストプラクティス

推奨事項

シンプルに始める - 基本的なルールから始めて徐々に複雑さを追加
徹底的にテスト - 本番前にテストモードでルールを検証
メトリクスを監視 - ルーティング決定と成功率を追跡
ルールを文書化 - ルーティングロジックの明確なドキュメントを保持
優先度を賢く使う - 将来のルールのために優先度番号にギャップを残す
フェイルオーバーを設定 - 常にバックアップルーティングルールを用意

非推奨事項

過度に複雑にしない - 複雑なルールセットはデバッグが困難
テストを忘れない - 常にサンドボックスで最初にテスト
メトリクスを無視しない - 問題を早期に発見するために監視
競合を作らない - ルールに重複する条件がないことを確認
フェイルオーバーをスキップしない - すべての重要なパスにバックアップルートを用意

パフォーマンスに関する考慮事項

ルール評価

ルールは優先度順に評価
最初にマッチしたルールが適用
高トラフィックルールをより高い優先度に保持

キャッシング

ルール設定はパフォーマンスのためにキャッシュ
変更が反映されるまで数秒かかる場合がある

監視

Webhooks経由でルーティング決定を追跡
プロバイダーの健全性を監視し、それに応じてルールを調整

概要​

ルーティングルールの仕組み​

ルール条件​

金額条件​

カード条件​

通貨条件​

メタデータ条件​

ユースケース​

マルチアクワイアラーセットアップ​

地理的最適化​

フェイルオーバー設定​

コスト最適化​

リスク管理​

利用可能なエンドポイント​

ルール構造​

識別​

条件​

アクション​

ステータス​

ベストプラクティス​

推奨事項​

非推奨事項​

パフォーマンスに関する考慮事項​

ルール評価​

キャッシング​

監視​

関連リソース​

概要