Skip to main content
Quando o evento é do tipo payment.*, o campo data da requisição de webhook contém um objeto pagamento no formato abaixo.

​
Estrutura

{
  "id": "pay_xyz789abc",
  "livemode": false,
  "customer": "cus_ahwDXrgYvur89iPs",
  "paymentMethod": "pm_abc123xyz",
  "amount": 10000,
  "refundedAmount": 0,
  "gross": 10000,
  "mdr": 0,
  "net": 10000,
  "interest": 0,
  "currency": "BRL",
  "status": "approved",
  "description": null,
  "pixQrCode": null,
  "refuseReason": null,
  "installments": 1,
  "createdAt": 1731622178441,
  "updatedAt": 1731622178441,
  "dueAt": null
}

​
Atributos

{
  "id": "pay_xyz789abc",
}
id : string.
Identificador único do pagamento, começando com pay_
{
  "livemode": false,
}
livemode : boolean.
Indica se o pagamento está em modo de produção (true) ou teste (false)
{
  "customer": "cus_ahwDXrgYvur89iPs",
}
customer : string.
ID do cliente, começando com cus_
{
  "paymentMethod": "pm_abc123xyz",
}
paymentMethod : string.
ID do método de pagamento, começando com pm_
{
  "amount": 10000,
}
amount : number.
Valor do pagamento em centavos
{
  "refundedAmount": 0,
}
refundedAmount : number.
Valor já reembolsado em centavos
{
  "gross": 10000,
}
gross : number.
Valor bruto do pagamento em centavos (antes das taxas)
{
  "mdr": 0,
}
mdr : number.
Taxa MDR (Merchant Discount Rate) em centavos
{
  "net": 10000,
}
net : number.
Valor líquido do pagamento em centavos (após taxas)
{
  "interest": 0,
}
interest : number.
Valor de juros em centavos (para parcelamentos)
{
  "currency": "BRL",
}
currency : string.
Código da moeda (ex.: BRL)
{
  "status": "approved",
}
status : string.
Status atual do pagamento
StatusDescrição
incompletePagamento incompleto
pendingPagamento pendente
approvedPagamento aprovado
refusedPagamento recusado
refundedValor reembolsado
failedPagamento falhou
{
  "description": null,
}
description : string | null.
Descrição do pagamento. Pode ser null
{
  "pixQrCode": null,
}
pixQrCode : string | null.
Código QR do PIX para pagamento. Pode ser null se não for PIX
{
  "refuseReason": null,
}
refuseReason : string | null.
Motivo da recusa do pagamento. Pode ser null se não foi recusado
{
  "installments": 1,
}
installments : number.
Número de parcelas. Padrão: 1
{
  "createdAt": 1731622178441,
}
createdAt : number.
Timestamp Unix indicando quando o pagamento foi criado
{
  "updatedAt": 1731622178441,
}
updatedAt : number.
Timestamp Unix indicando quando o pagamento foi atualizado pela última vez
{
  "dueAt": null,
}
dueAt : number | null.
Timestamp Unix indicando a data de vencimento do pagamento. Pode ser null