Legacy Decision Gateway

Legacy compatibility route. New integrations should use /decide-gateway.

POST /decision_gateway

Legacy decision gateway

cURL

curl --request POST \
  --url http://localhost:8080/decision_gateway \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "orderReference": {},
  "orderMetadata": {
    "partitionKey": "<string>"
  },
  "txnDetail": {
    "partitionKey": "<string>"
  },
  "txnCardInfo": {
    "partitionKey": "<string>"
  },
  "merchantAccount": {},
  "txnOfferDetails": [
    {}
  ],
  "cardToken": "<string>",
  "txnType": "<string>",
  "shouldCreateMandate": true,
  "enforceGatewayList": [
    "stripe",
    "adyen"
  ],
  "priorityLogicOutput": {},
  "priorityLogicScript": "<string>",
  "isEdccApplied": true,
  "shouldConsumeResult": true
}
'

200

{
  "decided_gateway": "stripe",
  "routing_approach": "SR_SELECTION_V3_ROUTING",
  "gateway_priority_map": {
    "stripe": 0.94,
    "adyen": 0.87,
    "paypal": 0.72
  },
  "routing_dimension": "<string>",
  "routing_dimension_level": "<string>",
  "reset_approach": "<string>",
  "is_scheduled_outage": true,
  "is_rust_based_decider": true,
  "debit_routing_output": {
    "co_badged_card_networks_info": [
      {
        "network": "NYCE",
        "saving_percentage": 1.2
      }
    ],
    "issuer_country": "US",
    "is_regulated": false,
    "regulated_name": "<string>",
    "card_type": "Debit"
  },
  "latency": 123,
  "multi_objective_info": {
    "outcome": "COST_WON",
    "reason": "Promoted 'adyen' over 'stripe' on expected value — saves 80.00 bps for 3.00pp auth.",
    "srHead": {
      "psp": "adyen",
      "authRate": 0.91,
      "costBps": 100
    },
    "chosen": {
      "psp": "adyen",
      "authRate": 0.91,
      "costBps": 100
    },
    "costSavedBps": 80,
    "qualifiedCount": 3,
    "margin": 0.2,
    "evGapTop2": 0.00182
  },
  "fallback_gateways": [
    "adyen"
  ],
  "filter_wise_gateways": {},
  "priority_logic_tag": "<string>",
  "priority_logic_output": {},
  "gateway_mga_id_map": {},
  "is_dynamic_mga_enabled": true,
  "gateway_before_evaluation": "<string>"
}

Authorizations

BearerAuthApiKeyAuth

Authorization · string · header · required

JWT token obtained from /auth/login

Body

application/json

Legacy decider payload built from full internal transaction objects. This is NOT the /decide-gateway shape - posting that body here is rejected with a 400. orderMetadata, txnDetail and txnCardInfo must each carry a partitionKey key (value may be null).

orderReference · object · required

Full internal order object. merchantId inside it identifies the merchant. udfs is an ARRAY of strings, not an object, and id is an integer.

orderMetadata · object · required

Full internal order-metadata object. Required. Note: partitionKey must be PRESENT in this object (it may be null). It is an Option field with a custom deserialize_with and no serde(default), so serde requires the key even though the value is nullable.

Show child attributes

txnDetail · object · required

Full internal transaction object. Note: partitionKey must be PRESENT in this object (it may be null). It is an Option field with a custom deserialize_with and no serde(default), so serde requires the key even though the value is nullable.

Show child attributes

txnCardInfo · object · required

Full internal card/payment-method object. Note: partitionKey must be PRESENT in this object (it may be null). It is an Option field with a custom deserialize_with and no serde(default), so serde requires the key even though the value is nullable.

Show child attributes

merchantAccount · object · required

Full internal merchant account object. gatewaySuccessRateBasedDeciderInput is a required string - null is rejected.

txnOfferDetails · object[] | null

cardToken · string | null

txnType · string | null

shouldCreateMandate · boolean | null

enforceGatewayList · string[] | null

Example:

["stripe", "adyen"]

priorityLogicOutput · object | null

priorityLogicScript · string | null

isEdccApplied · boolean | null

shouldConsumeResult · boolean | null

Response

200

application/json

Gateway decision result

decided_gateway · string

Example:

"stripe"

routing_approach · string

Routing approach used. SR_SELECTION_MULTI_OBJECTIVE indicates the multi-objective post-step promoted a cheaper gateway over the SR head.

Example:

"SR_SELECTION_V3_ROUTING"

gateway_priority_map · object

Show child attributes

Example:

{
  "stripe": 0.94,
  "adyen": 0.87,
  "paypal": 0.72
}

routing_dimension · string

routing_dimension_level · string

reset_approach · string

is_scheduled_outage · boolean

is_rust_based_decider · boolean

debit_routing_output · object

Show child attributes

latency · number

multi_objective_info · object | null

Populated when the multi-objective post-step ran (multi_objective_routing_enabled feature flag or enableMultiObjective request field, outside hedging). Null otherwise.

Show child attributes

fallback_gateways · string[]

Example:

["adyen"]

filter_wise_gateways · object | null

priority_logic_tag · string | null

priority_logic_output · object | null

gateway_mga_id_map · object | null

is_dynamic_mga_enabled · boolean

gateway_before_evaluation · string | null

Gateway the SR head selected before the multi-objective / debit-routing post-step replaced it.