Sua primeira integração

Faça as chamadas no backend. Substitua a origem pelo endereço do seu ambiente; https://magnum.lat é o domínio de produção planejado, não uma confirmação de publicação.

Prepare o ambiente local

pnpm install --frozen-lockfile
pnpm setup:local
docker compose -f compose.dev.yaml up -d --wait
pnpm db:generate
pnpm db:deploy
pnpm bootstrap
pnpm dev

O bootstrap grava uma credencial de desenvolvimento em .local/, com permissão restrita. Abra esse arquivo apenas no seu ambiente e carregue a chave como MAGNUM_API_KEY no backend. Não coloque a chave em código, repositórios, HTML ou mensagens.

Cadastre uma integração

curl http://localhost:3100/v1/integrations \
  -H "Authorization: Bearer $MAGNUM_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"name":"Minha loja","environment":"sandbox","allowedOrigins":["http://localhost:3000"],"allowedNetworks":["ethereum","base"]}'

Guarde o data.id retornado. Origens devem ser exatas: esquema, host e porta fazem parte da autorização.

Crie uma sessão

curl http://localhost:3100/v1/checkout-sessions \
  -H "Authorization: Bearer $MAGNUM_API_KEY" \
  -H 'Idempotency-Key: order-demo-2026-0001' \
  -H 'Content-Type: application/json' \
  -d '{"integrationId":"SEU_ID","amount":"100.00","network":"base","parentOrigin":"http://localhost:3000"}'

Abra data.checkoutUrl ou use o SDK de frame. O fragmento da URL contém uma capacidade temporária: trate a URL inteira como um segredo de sessão.

Valide o resultado

Conclua a simulação no checkout e consulte a sessão usando sua chave de backend. O estado sandbox_completed demonstra o fluxo e nunca representa recebimento financeiro.