Desenvolvedores
Integração em quatro passos
API REST, JSON, requisições assinadas. A documentação com exemplos em Node.js é aberta, sem cadastro.
- Passo 1
Assine a requisição
HMAC-SHA256 do timestamp, método, caminho e hash do corpo. A chave fica só no seu servidor.
X-Shop-Id: shop_… X-Timestamp: 1793400000 X-Signature: hex(HMAC-SHA256(secret_key, timestamp ⏎ METHOD ⏎ path ⏎ sha256(body))) - Passo 2
Crie um pagamento
Valor em unidades mínimas. Repetir com a mesma Idempotency-Key retorna o mesmo pagamento.
POST /v1/payments Idempotency-Key: 4f1c… { "orderId": "A-1001", "amount": 24990, "currency": "EUR", "returnUrl": "https://shop.example/thanks" } - Passo 3
Envie o cliente para pagar
A página mostra os métodos do país e da moeda, recebe o pagamento e devolve o cliente ao seu site.
→ 201 { "id": "pay_…", "status": "created", "checkoutUrl": "https://pay…/c/…" } - Passo 4
Receba o webhook
Verifique a assinatura e marque o pedido como pago. Sem resposta 2xx, reenviamos por até dois dias.
POST https://shop.example/payos/webhook X-Payos-Signature: v1=… { "type": "payment.succeeded", "data": { "orderId": "A-1001", … } }
Comece a receber pagamentos
Cadastre-se e verifique sua empresa no painel. As chaves de API são liberadas assim que a loja é aprovada.