Eventos por família

Venda

Eventos de venda: o Pix foi gerado, pago, venceu, foi devolvido ou contestado. Em todos eles dados é o objeto cobrança, como estava no momento do evento.

Eventos desta família

EventoQuando chegadados.statusO que fazer
venda.criadaUm Pix foi gerado (checkout, link, painel ou API).pendenteGuardar o pedido como "aguardando pagamento".
venda.aprovadaO banco confirmou o pagamento.pagoLiberar o acesso.
venda.expiradaO Pix venceu sem pagamento.expiradoCancelar o pedido ou criar outra cobrança.
venda.reembolsadaA venda foi devolvida ao comprador.reembolsadoTirar o acesso.
venda.contestadaUm MED foi decidido a favor do comprador: o valor foi devolvido.contestadoTirar o acesso.

venda.contestada sai do mesmo fato que o med.encerrado com status: "perdida" (veja MED). Você recebe os dois, em eventos diferentes: um sobre a disputa e outro sobre a venda.

Campos de dados

idtexto

Identificador da cobrança (32 caracteres).

statustexto

Veja Status.

valorinteiro

Valor cobrado, em centavos.

taxainteiro

Taxa da Grinny Pay, em centavos.

liquidointeiro

O que entra no seu saldo, em centavos.

descricaotexto

Descrição da cobrança.

pix_copia_e_colatexto ou null

Só vem no venda.criada (cobrança pendente).

link_pagamentotexto

Página de pagamento.

clienteobjeto

nome e email.

expira_emdata

Limite para pagar.

pago_emdata ou null

Hora do pagamento (null antes de pagar).

criado_emdata

Hora em que a cobrança foi criada.

referenciatexto ou null

O código que você mandou ao criar (ex.: número do pedido). Use para achar o pedido no seu sistema.

venda.criada

{
  "id": "evt_5820",
  "tipo": "venda.criada",
  "sequencia": 5820,
  "criado_em": "2026-10-15T14:30:01-03:00",
  "dados": {
    "id": "8f2c4b1e9a7d4c3b8e1f2a3b4c5d6e7f",
    "status": "pendente",
    "valor": 9700,
    "taxa": 371,
    "liquido": 9329,
    "descricao": "Curso de Marketing",
    "pix_copia_e_cola": "00020101021226...",
    "link_pagamento": "https://app.grinnypay.com/pix?c=8f2c4b1e9a7d4c3b8e1f2a3b4c5d6e7f",
    "cliente": { "nome": "Carlos Silva", "email": "[email protected]" },
    "expira_em": "2026-10-15T14:45:00-03:00",
    "pago_em": null,
    "criado_em": "2026-10-15T14:30:00-03:00",
    "referencia": "pedido-1042"
  }
}

venda.aprovada

{
  "id": "evt_5821",
  "tipo": "venda.aprovada",
  "sequencia": 5821,
  "criado_em": "2026-10-15T14:32:10-03:00",
  "dados": {
    "id": "8f2c4b1e9a7d4c3b8e1f2a3b4c5d6e7f",
    "status": "pago",
    "valor": 9700,
    "taxa": 371,
    "liquido": 9329,
    "descricao": "Curso de Marketing",
    "pix_copia_e_cola": null,
    "link_pagamento": "https://app.grinnypay.com/pix?c=8f2c4b1e9a7d4c3b8e1f2a3b4c5d6e7f",
    "cliente": { "nome": "Carlos Silva", "email": "[email protected]" },
    "expira_em": "2026-10-15T14:45:00-03:00",
    "pago_em": "2026-10-15T14:32:08-03:00",
    "criado_em": "2026-10-15T14:30:00-03:00",
    "referencia": "pedido-1042"
  }
}

venda.expirada

{
  "id": "evt_5822",
  "tipo": "venda.expirada",
  "sequencia": 5822,
  "criado_em": "2026-10-15T14:46:00-03:00",
  "dados": {
    "id": "3a9d0c2e7b1f4e6d9c8b7a6f5e4d3c2b",
    "status": "expirado",
    "valor": 4990,
    "taxa": 191,
    "liquido": 4799,
    "descricao": "Ebook de Receitas",
    "pix_copia_e_cola": null,
    "link_pagamento": "https://app.grinnypay.com/pix?c=3a9d0c2e7b1f4e6d9c8b7a6f5e4d3c2b",
    "cliente": { "nome": "Maria Souza", "email": "[email protected]" },
    "expira_em": "2026-10-15T14:45:00-03:00",
    "pago_em": null,
    "criado_em": "2026-10-15T14:30:00-03:00",
    "referencia": "pedido-1043"
  }
}

venda.reembolsada

{
  "id": "evt_5990",
  "tipo": "venda.reembolsada",
  "sequencia": 5990,
  "criado_em": "2026-10-18T10:05:00-03:00",
  "dados": {
    "id": "8f2c4b1e9a7d4c3b8e1f2a3b4c5d6e7f",
    "status": "reembolsado",
    "valor": 9700,
    "taxa": 371,
    "liquido": 9329,
    "descricao": "Curso de Marketing",
    "pix_copia_e_cola": null,
    "link_pagamento": "https://app.grinnypay.com/pix?c=8f2c4b1e9a7d4c3b8e1f2a3b4c5d6e7f",
    "cliente": { "nome": "Carlos Silva", "email": "[email protected]" },
    "expira_em": "2026-10-15T14:45:00-03:00",
    "pago_em": "2026-10-15T14:32:08-03:00",
    "criado_em": "2026-10-15T14:30:00-03:00",
    "referencia": "pedido-1042"
  }
}

venda.contestada

{
  "id": "evt_6015",
  "tipo": "venda.contestada",
  "sequencia": 6015,
  "criado_em": "2026-10-22T16:20:00-03:00",
  "dados": {
    "id": "8f2c4b1e9a7d4c3b8e1f2a3b4c5d6e7f",
    "status": "contestado",
    "valor": 9700,
    "taxa": 371,
    "liquido": 9329,
    "descricao": "Curso de Marketing",
    "pix_copia_e_cola": null,
    "link_pagamento": "https://app.grinnypay.com/pix?c=8f2c4b1e9a7d4c3b8e1f2a3b4c5d6e7f",
    "cliente": { "nome": "Carlos Silva", "email": "[email protected]" },
    "expira_em": "2026-10-15T14:45:00-03:00",
    "pago_em": "2026-10-15T14:32:08-03:00",
    "criado_em": "2026-10-15T14:30:00-03:00",
    "referencia": "pedido-1042"
  }
}

Quando uma disputa é aberta, o aviso que chega é o med.aberto, com dados da disputa (não da cobrança).