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

# Criar ou Atualizar Gateway

Cria o registro se ele não existe, ou atualiza o que existe. Vale para provedores (credenciais) e para métodos de pagamento (roteamento).

O que não vier no corpo continua como está. Em provedores, cada campo de `data` não enviado mantém a credencial salva. As validações são as mesmas do painel.

> [!NOTE]
>
> Exige a permissão **Gerenciar Gateways** (`MANAGE_GATEWAYS`) do usuário que criou o token. Veja [Permissões do token](https://docs.selltrust.com.br/api-reference/permissions.md).

**Authorization** `string` *required*

Token de API no formato `Bearer stk_live_...`.

**gateway** `string` *required*

Provedor (`MISTIC_PAY`, `EFI_PAY`, `PUSHIN_PAY`, `SYNC_PAY`, `NX_GATE`, `PURIN_CASH`) ou método (`PIX`, `CREDIT_CARD`). Para `MERCADO_PAGO`, só `enabled` e `fee` depois de conectado por OAuth.

**data** `object`

Provedor: as credenciais (veja a tabela em [Pagamentos](https://docs.selltrust.com.br/api-reference/gateways/overview.md)). Método: `routing` e `max_installments`.

**provider** `string`

Só para métodos: o provedor que atende o método. Obrigatório ao criar `PIX` ou `CREDIT_CARD`.

**enabled** `boolean`

Liga ou desliga. Padrão ao criar: `true`.

**fee** `number`

Taxa somada ao valor pago pelo comprador neste método. `null` para nenhuma.

**is\_percentage\_fee** `boolean`

`true`: `fee` é percentual. `false`: `fee` é um valor fixo em reais.

```json Conectar um provedor theme={null}
{
  "data": {
    "client_id": "pk_...",
    "client_secret": "sk_..."
  }
}
```

```json Apontar o PIX para o provedor theme={null}
{
  "provider": "MISTIC_PAY",
  "fee": 0,
  "is_percentage_fee": false
}
```

```json Desligar sem reenviar credenciais theme={null}
{
  "enabled": false
}
```

```json Response theme={null}
{
  "id": "uuid-do-gateway",
  "gateway": "MISTIC_PAY",
  "enabled": true,
  "fee": null,
  "is_percentage_fee": false,
  "created_at": "2026-11-10T14:30:00.000Z",
  "updated_at": "2026-11-10T14:30:00.000Z",
  "kind": "PROVIDER",
  "credentials": {
    "client_id": true,
    "client_secret": true
  },
  "info": {
    "auth_mode": "access_key"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.