Ir para o conteúdo
GrandePay
Acessar painel

Postbacks

Payload

Leia o envelope e os campos normalizados da transação.

#Envelope

eventstring
Nome do evento emitido.
timestampstring
ISO 8601 da montagem do payload.
dataobject
Projeção da transação. id é o uuid público.

Campos nulos são omitidos.

#Valores

amount e amount_cents são o mesmo inteiro; o mesmo vale para fee e net_amount.

data.iduuid
Uuid público da transação.
data.amount_centsinteger
Valor em centavos inteiros.
data.fee_centsintegeropcional
Tarifa em centavos, quando presente.
data.net_amount_centsintegeropcional
Valor líquido em centavos, quando presente.

#Campos condicionais

payment_method vem em minúsculas. PIX, pagador e end-to-end só aparecem se houver valor.

  • correlation_id
  • provider_transaction_id
  • refunded_amount
  • refunded_amount_cents
  • pix_code
  • pix_expiration
  • refunded_at
  • fee
  • fee_cents
  • net_amount
  • net_amount_cents
  • end_to_end_id
  • payer
  • error_code
  • error_message
  • paid_at
  • failed_at

#Exemplos paid e failed

transaction.paid
{
  "event": "transaction.paid",
  "timestamp": "2026-03-13T17:05:32.000Z",
  "data": {
    "id": "4d78d8ca-a9f1-4c2a-bf15-7f8ca71e3a70",
    "external_id": "GP-9a5f1eb3-6885-4f26-93f3-3c0954d0f42f",
    "type": "cash_in",
    "status": "paid",
    "amount": 1500,
    "amount_cents": 1500,
    "fee": 15,
    "fee_cents": 15,
    "net_amount": 1485,
    "net_amount_cents": 1485,
    "currency": "BRL",
    "payment_method": "pix",
    "end_to_end_id": "E123456782026031317000000001",
    "description": "Assinatura mensal",
    "payer": {
      "name": "Maria de Souza",
      "document": "12345678901",
      "email": "maria@example.com"
    },
    "paid_at": "2026-03-13T17:05:32.000Z",
    "created_at": "2026-03-13T17:00:00.000Z"
  }
}

Esta página foi útil?