v12

latestOpenAPI 3.1.0AGPL-3.0raw.githubusercontent.com2026-08-0464108237.1 KB

Routing Rules

Create routing rule

Create a new Euclid declarative routing rule for a merchant. Supports advanced (full Euclid DSL), priority (ordered gateway list), single (fixed gateway), and volume_split (percentage-based distribution) algorithm types.

post/routing/create

Request body

namestring required

descriptionstring

created_bystring required

algorithm_for'payment' | 'payout' | 'three_ds_authentication'

metadataobject nullable

Free-form metadata stored with the rule.

Example request

{
  "name": "default-priority",
  "created_by": "test_merchant",
  "algorithm": {
    "type": "priority"
  }
}

Response

Routing rule created

rule_idstring

namestring

algorithm_forstring

created_atstring

modified_atstring

Example response

{
  "rule_id": "routing_e641380c-6f24-4405-8454-5ae6cbceb7a0",
  "name": "priority rule",
  "algorithm_for": "payment",
  "created_at": "2026-04-26 10:00:00.000000",
  "modified_at": "2026-04-26 10:00:00.000000"
}