API de integração

Conecte checkout, ERP ou middleware. Autenticação com token pessoal gerado em Admin → Integração.

URLs recomendadas

Criar pedido

POST https://www.brasilexpres.com/api/v1/pedidos

Atualizar status

POST https://www.brasilexpres.com/api/v1/pedidos/status

Autenticação

  • header: x-webhook-secret
  • header: Authorization
  • query: token

Checkouts parceiros

Zedy e Corvex usam rotas dedicadas (payload nativo de cada plataforma). Inclua ?token= na URL.

  • Zedy — https://www.brasilexpres.com/api/webhook/zedy?token=brex_wh_…
  • Corvex — https://www.brasilexpres.com/api/webhook/corvex?token=brex_wh_…

Compatibilidade

URLs abaixo continuam funcionando — não é necessário migrar checkouts já ativos.

  • https://www.brasilexpres.com/api/webhook
  • https://www.brasilexpres.com/api/webhook/status

Especificação completa em JSON: https://www.brasilexpres.com/api/integracao