GET /checkout/order-status

Consulte o estado do pagamento no seu backend com o id devolvido ao criar a sessão de checkout.

O mesmo host da API que o de criar encomenda: <code>GET /checkout/order-status?orderId=ID_DO_PEDIDO</code> (routing em minúsculas).

Use a mesma chave de API de checkout da app (Definições → Chave de API de checkout) no cabeçalho <code>Api-Key</code> em todos os pedidos.

Só encomendas da sua conta devolvem HTTP 200 com JSON. Ids inexistentes ou de outro comerciante devolvem HTTP 404 com a mesma mensagem, para não enumerar ids entre contas.

Autenticação

Cabeçalho Api-Key: a mesma chave secreta completa que em POST /checkout/order-from-product.

Pedido HTTP

GET · query orderId · Api-Key

Exemplo de pedido (ilustrativo)

GET /checkout/order-status?orderId=673f92b2c3d94a0012abcd01 HTTP/1.1
Host: api.zenofy.io
Api-Key: YOUR_CHECKOUT_API_KEY

Resposta em caso de sucesso

HTTP 200 com JSON: success, orderId, status (por exemplo PENDING, PAID, CANCELLED, REFUNDED, EXPIRED), currency, totalAmount. Sem orderId devolve HTTP 400.

Exemplo de resposta (HTTP 200)

{
  "success": true,
  "orderId": "673f92b2c3d94a0012abcd01",
  "status": "PAID",
  "currency": "MZN",
  "totalAmount": 149.99
}

Guia aparte: criar encomenda a partir do produto (POST) →

Todos os tutoriais