> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plugtopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ordem dos gateways

> Fallback por prioridade quando nenhuma regra de percentual está ativa.

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`.

```json theme={null}
[
  { "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.

```json theme={null}
{
  "gateways": [
    "safe2pay", 
    "pagarme", 
    "stripe",
  ]
}
```

Resultado: Safe2Pay = prioridade 1, Pagarme = prioridade 2, Stripe = prioridade 3.

<Info>
  Gateways desabilitados (`enabled: false`) são ignorados durante o roteamento mesmo que estejam no topo da ordem. Apenas gateways habilitados participam do fallback.
</Info>