Skip to main content
POST
Create a Routing
Creates a routing for one (account_code, payment_method) pair. Each routing references connections by their connection_id. Make sure your connections are created and ACTIVE for the requested payment_method before you call routing.

Body

string (UUID)
required
The merchant account ID this routing rule applies to.
enum
required
E.g., CARD, PIX, WALLET. Immutable per routing — to route a different method, create a new routing.
string
required
Free-form label.
object
required
The route used when no condition_sets[] matches.
object[]
Optional. Ordered by sort_number — first matching set wins.

Response

string
Unique identifier for the routing.
string
Unique code for the account.
enum
The payment method this routing applies to (e.g., CARD).
string
Label for the routing.
object
The default routing logic.
object[]
Optional conditional logic.
string
ISO 8601 timestamp.
string
ISO 8601 timestamp.

Errors

Authorizations

PUBLIC-API-KEY
string
header
default:<Your PUBLIC-API-KEY>
required
PRIVATE-SECRET-KEY
string
header
default:<Your PRIVATE-SECRET-KEY>
required

Headers

X-Idempotency-Key
string<uuid>
required

Body

application/json
payment_method
string
required
Example:

"CARD"

name
string
required
Example:

"Card routing"

default_route
object
required

Response

Created

id
string
Example:

"r_8f2c1d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f"

account_code
string
Example:

"acc-uuid"

payment_method
string
Example:

"CARD"

name
string
Example:

"Card routing"

default_route
object
condition_sets
object[]
created_at
string<date-time>
Example:

"2026-05-12T14:30:00Z"

updated_at
string<date-time>
Example:

"2026-05-12T14:30:00Z"

warnings
string[]
Example: