v1

latestOpenAPI 3.0.02026-07-26167441.9 MB

Create a Routing

Creates a routing for one (account_id, payment_method) pair.

post/routing

Headers

X-Idempotency-Keystring uuid required

Request body

account_idstring uuid required

payment_methodstring required

namestring required

Example request

{
  "account_id": "7825fc5e-e50a-4248-9ae8-5d3786afb0be",
  "payment_method": "CARD",
  "name": "Card routing",
  "default_route": {
    "steps": [
      {
        "index": 1,
        "provider_id": "STRIPE",
        "connection_id": "f1a3c4d5-7b8e-4a2c-9d1e-3f4a5b6c7d8e"
      }
    ]
  }
}

Response

Created

idstring

account_idstring

payment_methodstring

namestring

created_atstring date-time

updated_atstring date-time

warningsstring[]

Example response

{
  "id": "r_8f2c1d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
  "account_id": "acc-uuid",
  "payment_method": "CARD",
  "name": "Card routing",
  "default_route": {
    "steps": [
      {
        "index": 1,
        "provider_id": "STRIPE",
        "connection_id": "f1a3c4d5-..."
      }
    ]
  },
  "condition_sets": [
    {
      "sort_number": 1,
      "name": "High Value US"
    }
  ],
  "created_at": "2026-05-12T14:30:00Z",
  "updated_at": "2026-05-12T14:30:00Z",
  "warnings": [
    "MONITOR_REDISTRIBUTION_DEFERRED"
  ]
}