> For the complete documentation index, see [llms.txt](https://ereemby.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ereemby.gitbook.io/docs/desenvolvedores/webhooks/vendas.md).

# Vendas

Receba o evento de **pagamento aprovado** em tempo real via webhook.\
Use isso para notificar sua operação, atualizar sistemas e automatizar entregas.

{% hint style="info" %}
Para configurar a URL do webhook e validar assinatura HMAC, veja: [Webhooks](/docs/desenvolvedores/webhooks.md).
{% endhint %}

{% hint style="success" %}
Quer um tutorial completo (Node.js + validação + Discord + ngrok)?\
Use: [Notificações de vendas próprio](/docs/informacoes-gerais/notificacoes/notificacoes-de-vendas-proprio.md).
{% endhint %}

### Evento disponível

Quando o pagamento é aprovado, o webhook enviado é:

* `order_paid`: evento disparado quando o pedido é pago com sucesso.

Use esse evento quando você quer processar a confirmação do pagamento de forma simples e padronizada.

### Evento `order_paid`

Exemplos de uso:

* Notificar um canal `#vendas` (Discord/Telegram/Slack).
* Salvar o pedido no seu banco ou planilha.
* Atualizar CRM, entrega ou pós-venda.
* Acionar automações internas após confirmação de pagamento.

{% openapi-webhook spec="Webhook-Order-Paid" name="order\_paid" method="post" %}
[Webhook-Order-Paid](https://4401d86825a13bf607936cc3a9f3897a.r2.cloudflarestorage.com/gitbook-x-prod-openapi/raw/02b3cf309ef9b35a6d40e86c34d67e1a830702e8c334ccc76663232969eb894a.yaml?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=0cc7c3f440ca5fd44ab53362d4a69dfe%2F20261115%2Fauto%2Fs3%2Faws4_request\&X-Amz-Date=20261115T172533Z\&X-Amz-Expires=172800\&X-Amz-Signature=d82473b6d117daca34d2751fd4c88ff71e70703f46a22a9637e8d42b7adb22a2\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject)
{% endopenapi-webhook %}

### Boas práticas

* Valide `x-webhook-signature` antes de processar.\
  Referência: [Webhooks](/docs/desenvolvedores/webhooks.md)
* Trate webhooks como “pelo menos uma vez”. Pode haver reenvio.
* Responda com `2xx` rápido e processe em background quando possível.

{% hint style="warning" %}
No dia **27/08/2026**, os eventos `cart` e `sale` serão descontinuados e deixarão de ser enviados.\
Depois dessa data, apenas o evento `order_paid` será enviado.
{% endhint %}