Integrações

Uma integração define a fronteira de confiança entre o seu produto e o checkout Magnum.

Criar

POST /v1/integrations exige integrations:write. O corpo aceita apenas os campos abaixo; propriedades desconhecidas são rejeitadas.

{
  "name": "Checkout da loja",
  "environment": "sandbox",
  "allowedOrigins": ["https://loja.example"],
  "allowedNetworks": ["ethereum", "base", "arbitrum"],
  "appearance": { "theme": "dark", "accent": "#39bba6", "radius": 22, "compact": false }
}

Restrições

Use de 1 a 20 origens exatas. Não use caminhos, curingas, credenciais na URL ou origens de terceiros sem necessidade. HTTP só é aceito para localhost e 127.0.0.1 fora de produção.

As redes devem vir do catálogo Magnum. Uma sessão só pode escolher uma rede dessa lista. O backend repete essa validação ao criar o pagamento, mesmo que o navegador seja modificado.

environment não pode ser alterado pelo checkout. O nome tem até 80 caracteres. A integração não aceita wallet, destinations, lockWallet nem parâmetros equivalentes.

Consultar

GET /v1/integrations exige integrations:read e lista até 100 registros da organização autenticada, em ordem de criação. Desativação e edição por painel são evolução prevista; não existe rota pública para mudar a política financeira.