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
| Evento | Quando chega | dados.status | O que fazer |
|---|---|---|---|
venda.criada | Um Pix foi gerado (checkout, link, painel ou API). | pendente | Guardar o pedido como "aguardando pagamento". |
venda.aprovada | O banco confirmou o pagamento. | pago | Liberar o acesso. |
venda.expirada | O Pix venceu sem pagamento. | expirado | Cancelar o pedido ou criar outra cobrança. |
venda.reembolsada | A venda foi devolvida ao comprador. | reembolsado | Tirar o acesso. |
venda.contestada | Um MED foi decidido a favor do comprador: o valor foi devolvido. | contestado | Tirar 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
idtextoIdentificador da cobrança (32 caracteres).
statustextoVeja Status.
valorinteiroValor cobrado, em centavos.
taxainteiroTaxa da Grinny Pay, em centavos.
liquidointeiroO que entra no seu saldo, em centavos.
descricaotextoDescrição da cobrança.
pix_copia_e_colatexto ou nullSó vem no venda.criada (cobrança pendente).
link_pagamentotextoPágina de pagamento.
clienteobjetonome e email.
expira_emdataLimite para pagar.
pago_emdata ou nullHora do pagamento (null antes de pagar).
criado_emdataHora em que a cobrança foi criada.
referenciatexto ou nullO 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).