{
"eventId": "9f1d9a0c-7d36-5a57-b635-2d67f23d6a30",
"event": "transaction.paid",
"data": {
"id": "txn_123456",
"amount": "100.00",
"currency": "BRL",
"installments": 1,
"paymentMethod": "pix",
"status": "paid",
"externalRef": "pedido_987",
"createdAt": "2026-11-06T12:00:00Z",
"updatedAt": "2026-11-06T12:05:00Z",
"paidAt": "2026-11-06T12:05:00Z",
"customer": {
"id": "123",
"externalRef": "cliente_456",
"name": "Nome do cliente",
"email": "cliente@exemplo.com",
"phone": "5511999999999",
"birthdate": "1995-04-10T00:00:00Z",
"createdAt": "2026-11-06T12:00:00Z",
"document": {
"number": "12345678900",
"type": "cpf"
},
"address": {
"street": "Rua Exemplo",
"streetNumber": "100",
"complement": "Apto 1",
"zipCode": "01000000",
"neighborhood": "Centro",
"city": "São Paulo",
"state": "SP",
"country": "BR"
}
},
"card": null,
"pix": {
"qrcode": "conteudo-do-qrcode",
"brcode": "codigo-copia-e-cola",
"end2EndId": "identificador-do-pix"
}
}
}paymentMethod será normalmente credit_card, pix será null e card poderá conter:{
"id": "id-do-cartao",
"brand": "visa",
"holderName": "NOME DO TITULAR",
"lastDigits": "1234",
"expirationMonth": 12,
"expirationYear": 2030
}| Campo | Descrição |
|---|---|
eventId | Identificador estável do evento enviado. |
event | Nome do evento, como transaction.paid. |
data.id | Identificador da transação. |
data.amount | Valor da transação como texto decimal, por exemplo "100.00". |
data.currency | Moeda da transação, normalmente BRL. |
data.installments | Quantidade de parcelas. |
data.paymentMethod | Meio de pagamento, como pix ou credit_card. |
data.status | Status público da transação. |
data.externalRef | Referência externa da transação, quando informada. |
data.createdAt | Data de criação da transação, quando disponível. |
data.updatedAt | Data da última atualização, quando disponível. |
data.paidAt | Data de pagamento, quando disponível. |
data.customer | Dados do cliente, quando disponíveis. |
data.card | Dados públicos do cartão ou null. |
data.pix | Dados do PIX ou null. |
customer, o sistema pode enviar id, externalRef, name, email, phone, birthdate, createdAt, document e address.customer.document, os campos são number e type.customer.address, os campos são street, streetNumber, complement, zipCode, neighborhood, city, state e country.card e pix são enviados mesmo quando não se aplicam ao meio de pagamento; nesse caso, o valor é null.Evento (event) | Status (data.status) | Quando representa |
|---|---|---|
transaction.created | pending | A transação foi criada. |
transaction.pending | pending | A transação está pendente. |
transaction.processing | processing | A transação está em processamento. |
transaction.paid | paid | A transação foi paga com sucesso. |
transaction.failed | failed | A transação falhou ou foi rejeitada. |
transaction.canceled | canceled | A transação foi cancelada. |
transaction.refunded | refunded | A transação foi reembolsada. |
transaction.chargeback | chargeback | A transação teve estorno ou pré-estorno. |
transaction.created e transaction.pending são eventos diferentes, mas ambos enviam data.status como pending.