Skip to main content
POST
Decide routing

Authorizations

Authorization
string
header
required

JWT token obtained from /auth/login

Body

application/json
payment_id
string
required
amount
integer
required

Amount in currency minor units. Supplies both existing amount and payment_amount rule keys and the dynamic payment amount.

currency
string
required

Currency code, e.g. USD.

routing_config
object
required
merchant_id
string
required

Routing scope previously supplied as created_by. Use the same identifier, including the HS profile ID where applicable.

payment_method_type
string | null

Payment method family, e.g. card.

payment_method_sub_type
string | null

Payment method subtype, e.g. credit.

authentication_type
string | null
capture_method
string | null
mandate_type
string | null
mandate_acceptance_type
string | null
setup_future_usage
string | null
transaction_initiator
string | null
surcharge_amount
integer | null

Amount in currency minor units.

business_country
string | null

ISO 3166 alpha-2 country code.

billing_country
string | null

ISO 3166 alpha-2 country code.

business_label
string | null
card
object | null
customer_device_platform
string | null
customer_device_type
string | null
customer_device_display_size
string | null
pay_later
string | null
wallet
string | null
upi
string | null
voucher
string | null
bank_redirect
string | null
bank_debit
string | null
bank_transfer
string | null
real_time_payment
string | null
gift_card
string | null
card_redirect
string | null
open_banking
string | null
mobile_payment
string | null
crypto
string | null
reward
string | null
network_token
string | null
metadata
object | null
country
string | null

ISO 3166 alpha-2 country code.

customer_id
string | null

Response

Routing decision. Connector order and account IDs are preserved from hybrid routing. An account ID can be null when a legacy rule identifies only a gateway.

evaluated_connectors
object[]
required
decision
object
required