Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stylepay.com.br/llms.txt

Use this file to discover all available pages before exploring further.

​
Webhook de confirmacao de pagamento

Quando um pagamento PIX e confirmado, a StylePay envia uma requisicao POST para a URL informada no campo postbackUrl.

​
Exemplo de URL configurada

{
  "postbackUrl": "https://seusite.com/webhooks/stylepay"
}

​
Como o webhook chega

A requisicao enviada para sua URL tera o formato abaixo: 
POST /webhooks/stylepay HTTP/1.1
Host: seusite.com
Content-Type: application/json
X-Webhook-Id: 9f4b5f0a-8c2d-4a9a-9d32-2a9c8a0f7c11
X-Webhook-Event: pix.cashin.paid

{
  "event": "pix.cashin.paid",
  "transaction_id": "0f3e9a3c-8b4a-4a83-bf5f-8a0a8f8d92c1",
  "status": "PAID",
  "amount": 149.9,
  "event_type": "pix.cashin.paid",
  "paid_at": "2026-05-09T22:15:30.000Z",
  "end_to_end_id": "E1234567820260509221530000000001",
  "metadata": {
    "requestNumber": "pedido-123",
    "raw_event": "pix.cashin.paid"
  }
}

​
Campos principais

CampoDescricao
eventEvento enviado pela StylePay.
transaction_idID da transacao na StylePay.
statusStatus do pagamento. Quando confirmado, chega como PAID.
amountValor pago em reais.
paid_atData e hora da confirmacao, quando disponivel.
metadata.requestNumberReferencia externa enviada na criacao da cobranca, quando disponivel.

​
Resposta esperada

Seu endpoint deve responder com status 2xx para confirmar o recebimento: 
{
  "received": true
}
O webhook pode ser reenviado. Use transaction_id ou a referencia do seu pedido para evitar processar o mesmo pagamento mais de uma vez.