> ## Documentation Index
> Fetch the complete documentation index at: https://docs.purincash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# order.paid

> Para quem vende pelo bot no Discord e quer sincronizar estoque ou CRM.

Este evento é específico da loja no Discord. Quando um pedido feito pelo bot é pago, a
gente avisa a URL configurada na conta.

<Info>
  Diferente do PIX e do cartão, aqui não existe `callbackUrl` por cobrança. A URL é
  configurada uma vez em [Dashboard → API e Desenvolvedores →
  Webhooks](https://purincash.com/dashboard/api) e vale para todos os pedidos do bot.
</Info>

```json theme={null}
POST https://minhaloja.com/webhooks/purincash
Content-Type: application/json
X-Webhook-Signature: a3f5b8c2e1d4f7a9b6c8d2e5f1a4b7c9d2e5f8a1b4c7d0e3f6a9b2c5d8e1f4a7
X-Webhook-Id: order.paid:665f1a2b3c4d5e6f7a8b9c0d

{
  "event": "order.paid",
  "orderId": "665f1a2b3c4d5e6f7a8b9c0d",
  "orderCode": "ORD-7K3B9X",
  "total": 49.90,
  "paidAt": "2026-03-18T12:05:00.000Z",
  "acquirer": "..."
}
```

## Campos

<ResponseField name="event" type="string" required>
  Sempre `order.paid`.
</ResponseField>

<ResponseField name="orderId" type="string" required>
  Identificador interno do pedido.
</ResponseField>

<ResponseField name="orderCode" type="string" required>
  Código curto do pedido, o mesmo que aparece para o comprador no Discord.
</ResponseField>

<ResponseField name="total" type="number" required>
  Valor total em reais, decimal.
</ResponseField>

<ResponseField name="paidAt" type="string" required>
  Data e hora da confirmação, em ISO 8601.
</ResponseField>

<ResponseField name="acquirer" type="string">
  Identificador interno de qual processadora tratou o pagamento. Pode mudar sem aviso, então
  não construa lógica em cima dele.
</ResponseField>

## Para que serve

<CardGroup cols={2}>
  <Card title="Sincronizar estoque" icon="boxes-stacked">
    Baixar a quantidade no seu ERP ou planilha assim que a venda confirma, sem depender de
    consulta periódica.
  </Card>

  <Card title="Alimentar CRM" icon="address-card">
    Registrar o cliente e a compra no seu funil no momento certo.
  </Card>

  <Card title="Contabilidade" icon="calculator">
    Lançar a receita com data e valor exatos, em vez de exportar relatório no fim do mês.
  </Card>

  <Card title="Notificação interna" icon="bell">
    Avisar a equipe no canal certo quando entra venda acima de um valor.
  </Card>
</CardGroup>

<Warning>
  Este evento avisa que o pedido foi pago. Ele não substitui o webhook de
  [pagamento](/webhooks/pagamentos) nas cobranças criadas pela API: são fluxos separados,
  com origens diferentes.
</Warning>

As garantias são as mesmas: assinatura HMAC, `X-Webhook-Id` para deduplicar, timeout de 5
segundos e reentrega com backoff.