Skip to main content
Quando nenhuma regra de percentual está ativa, o sistema usa o gateway com menor order dentre os habilitados. É o mecanismo de fallback garantido — sempre existe um gateway escolhido se pelo menos um estiver habilitado.

​
Consultar ordem atual

GET /api/v1/company/gateways/order — requer X-Client-ID + X-API-Key. 
[
  { "gateway_id": 1, "gateway_slug": "pagarme",  "order": 1, "enabled": true  },
  { "gateway_id": 4, "gateway_slug": "safe2pay",  "order": 2, "enabled": true  },
  { "gateway_id": 2, "gateway_slug": "stripe",    "order": 3, "enabled": false }
]

​
Atualizar ordem

PUT /api/v1/company/gateways/order — requer X-Client-ID + X-API-Key. A posição no array define a prioridade: índice 0 vira order = 1, índice 1 vira order = 2, e assim por diante. Gateways ausentes da lista são mantidos e reposicionados após os listados. 
{
  "gateways": [
    { "gateway_id": 4 },
    { "gateway_id": 1 },
    { "gateway_id": 2 }
  ]
}
Resultado: Safe2Pay = prioridade 1, Pagarme = prioridade 2, Stripe = prioridade 3.
Gateways desabilitados (enabled: false) são ignorados durante o roteamento mesmo que estejam no topo da ordem. Apenas gateways habilitados participam do fallback.