Criando um webhook

Se você sabe o que é um webhook, já deve estar feliz por ter encontrado este artigo.

O NovaPay traz, nativamente, um webhook disparado sempre que um pagamento é realizado em um pedido. Você pode integrar diferentes softwares, recebendo essas informações diretamente de nossa ferramenta.

Este é o payload que você receberá:

{
  "event": "order.paid",
  "payload": {
    "id": 7790,
    "date": "2025-07-11T16:10:48-03:00",
    "meta": {},
    "utms": {},
    "items": [
      {
        "total": 497.0,
        "value": 497.0,
        "quantity": 1.0,
        "unit_name": "UN",
        "product_id": 36,
        "product_name": "+1 ano de acesso Universidade Atom"
      }
    ],
    "total": 497.0,
    "seller": {
      "name": null
    },
    "status": "paid",
    "deal_id": null,
    "customer": {
      "meta": {
        "_checkout_url": "https://coyo.staging.pay.nova.money/pt-BR/checkout/21d16c5a-cc15-4799-b00e-12416df78487"
      },
      "name": "Rodrigo Teste",
      "utms": {},
      "email": "rodrigo@nova.money",
      "phone": "+5512997560110",
      "address": {
        "city": "São José dos Campos",
        "state": "SP",
        "number": "319",
        "street": "Av Cassiano Ricardo",
        "zipcode": "12230083",
        "neighborhood": "Jd Aquarius"
      },
      "identification": "31177002850"
    },
    "discount": 0.0,
    "invoices": [],
    "payments": [
      {
        "type": "pix",
        "amount": 497.0,
        "status": "paid",
        "company": "Atom Traders",
        "interest": 0.0,
        "created_at": "2025-07-11T16:10:48-03:00",
        "gateway_id": "ch_XzPB3qwimi7nYqwk",
        "installments": 1,
        "installment_value": 497.0
      }
    ],
    "seller_id": null,
    "created_at": "2025-07-11T16:10:02-03:00",
    "coupon_code": null,
    "observation": null,
    "checkout_page_id": null
  }
}

Utilizando o webhook

Comece acessando o menu de integrações e adicione uma nova integração:

‍

Na lista de produtos, selecione a opção webhook e, em seguida, selecione a empresa em que os pedidos e pagamentos serão feitos e para qual URL o webhook será direcionado. Selecione o evento order.paid* e pronto:

‍

💡 *Novos eventos podem ser adicionados. Caso precise de um evento específico, entre em contato com o suporte.

É isso aí! Está configurado. Agora é só aproveitar os avisos.