Comece em 5 minutos - Lojou Docs

1. Gere uma API Key

No painel da Lojou: Configurações → API → Nova API Key. Escolha os escopos que você precisa (ex: orders.read, products.write) e copie a chave — ela só é exibida uma vez.

Se você está construindo um app pra OUTROS vendedores instalarem (não só pra sua própria loja), use OAuth em vez de uma API Key fixa.

2. Teste a conexão

curl https://api.lojou.app/v1/ping

{ "status": "success", "message": "pong" }

Esse endpoint não exige autenticação — é só pra confirmar que a API está no ar.

3. Confirme quem você é

curl https://api.lojou.app/v1/user \
  -H "Authorization: Bearer SUA_API_KEY"

Se voltar 401, a chave está errada ou expirou. Se voltar 403, a chave existe mas não tem o escopo user.read — veja Autenticação.

4. Liste os seus produtos

curl https://api.lojou.app/v1/products \
  -H "Authorization: Bearer SUA_API_KEY"

{
  "status": "success",
  "page": 1,
  "per_page": 20,
  "last_page": 1,
  "total": 3,
  "data": [ ]
}

5. Crie um pedido

Todo pedido precisa de amount, product_pid e customer:

curl -X POST https://api.lojou.app/v1/orders \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500,
    "product_pid": "PROD-ABC123",
    "customer": {
      "name": "Maria Silva",
      "email": "[email protected]",
      "mobile_number": "+258840000000"
    }
  }'

A resposta traz checkout_url — é o link que você manda pro cliente pra ele concluir o pagamento.

Próximo passo

Receba eventos em tempo real configurando um webhook (POST /v1/webhooks) em vez de ficar consultando o pedido.
Construindo um app pra outros vendedores? Veja o guia de OAuth.

​1. Gere uma API Key

​2. Teste a conexão

​3. Confirme quem você é

​4. Liste os seus produtos

​5. Crie um pedido

​Próximo passo

1. Gere uma API Key

2. Teste a conexão

3. Confirme quem você é

4. Liste os seus produtos

5. Crie um pedido

Próximo passo