Pedir acesso

Integre seus pedidos às entregas da Vainabag.

Uma API REST para criar entregas, acompanhar o entregador em tempo real e receber cada mudança de status por webhook. Teste tudo num ambiente isolado antes de ir para produção.

Pedir acesso de testes Ver documentação 
# 1. Pegue um token
curl -X POST .../integrations/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{ "grant_type": "client_credentials",
        "client_id": "eak_...", "client_secret": "eas_..." }'

# 2. Crie uma entrega de teste
curl -X POST .../integrations/v1/orders \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: pedido-123" \
  -d '{ "clientName": "Maria", "test": true, ... }'

# 3. Simule o entregador
POST /orders/{id}/simulate/driver-accept
POST /orders/{id}/simulate/deliver

O que a API faz

Do pedido de acesso à primeira entrega

O ambiente de testes funciona igual à produção, só que nenhuma entrega sai de verdade.

  1. Peça acesso

    Preencha o formulário abaixo. Depois da aprovação, o client_id e o client_secret chegam no seu e-mail.

  2. Gere um token

    POST /auth/token com as credenciais. O token vale 1 hora.

  3. Cadastre o webhook

    POST /webhooks com a sua URL, e /webhooks/{id}/test para conferir a assinatura.

  4. Crie e simule

    POST /orders e avance a entrega pelas rotas /simulate/*, recebendo cada evento.

Baixar coleção do Postman Abrir a documentação completa Especificação OpenAPI

Pedir acesso

Escolha o tipo de acesso. Os pedidos são analisados pela equipe Vainabag e a resposta chega por e-mail.

Para conhecer e desenvolver a integração. Você recebe as credenciais de uma loja de testes só sua: toda entrega é simulada, sem entregador real e sem dinheiro.