Compatibility

Legacy decision gateway

Changed on Aug 4, 2026

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

post/decision_gateway

Request

Base URL
http://localhost:8080
URL
http://localhost:8080/decision_gateway
Auth
- HTTP bearer
- or API key in header x-api-key

Request body

orderReferenceobject required

Full internal order object. merchantId inside it identifies the merchant.

merchantAccountobject required

Full internal merchant account object.

txnOfferDetailsobject[] nullable

cardTokenstring nullable

txnTypestring nullable

shouldCreateMandateboolean nullable

enforceGatewayListstring[] nullable

priorityLogicOutputobject nullable

Precomputed priority-logic output.

priorityLogicScriptstring nullable

isEdccAppliedboolean nullable

shouldConsumeResultboolean nullable

Example request

{
  "enforceGatewayList": [
    "stripe",
    "adyen"
  ]
}

Response

Gateway decision result

decided_gatewaystring

fallback_gatewaysstring[]

gateway_priority_mapobject nullable

filter_wise_gatewaysobject nullable

priority_logic_tagstring nullable

routing_approachstring

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

gateway_before_evaluationstring nullable

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

priority_logic_outputobject nullable

routing_dimensionstring nullable

routing_dimension_levelstring nullable

is_scheduled_outageboolean

is_dynamic_mga_enabledboolean

gateway_mga_id_mapobject nullable

is_rust_based_deciderboolean

latencyinteger nullable

Example response

{
  "decided_gateway": "stripe",
  "fallback_gateways": [
    "adyen"
  ],
  "gateway_priority_map": {
    "stripe": 0.94,
    "adyen": 0.87
  },
  "routing_approach": "SR_SELECTION_V3_ROUTING",
  "debit_routing_output": {
    "co_badged_card_networks_info": [
      {
        "network": "NYCE",
        "saving_percentage": 1.2
      }
    ],
    "issuer_country": "US",
    "card_type": "Debit"
  },
  "reset_approach": "NO_RESET",
  "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
  }
}

Changes

Aug 4, 202636e7a0972ee6 Revision changes
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  added subschema #2 to the response property oneOf list for the response status
- breaking
  added subschema #2 to the response property oneOf list for the response status
- breaking
  the response's property type changed from object to no type for status
- breaking
  the response's property type changed from number to integer null, and format from no format to int64 for status
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  added the new ELIMINATION_RESET enum value to the response property for the response status
- warning
  added the new NO_RESET enum value to the response property for the response status
- warning
  added the new SRV2_ELIMINATION_RESET enum value to the response property for the response status
- warning
  added the new SRV2_RESET enum value to the response property for the response status
- warning
  added the new SRV3_ELIMINATION_RESET enum value to the response property for the response status
- warning
  added the new SRV3_RESET enum value to the response property for the response status
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  removed from the response property allOf list for the response status
Jul 6, 2026276253849393 Revision changes
- info
  added the new optional request property
- info
  added the optional property to the response with the status

Operation history (4 revisions)