Ordem dos gateways - PlugToPay

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": [
    "safe2pay", 
    "pagarme", 
    "stripe",
  ]
}

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.