Atualização de Status da Transação

Enviado para a URL de webhook configurada no painel do lojista sempre que uma transação alterar seu status (ex. de pending para paid).

Para depósitos PIX criados sem name e/ou document, quando o provedor de pagamento enviar os dados do pagador real no webhook de confirmação, o evento paid será enviado já com data.name e data.document atualizados para o pagador real.

postWebhooktransaction.updated

Payload

eventstring

Tipo do evento disparado

Example payload

{
  "event": "transaction.updated",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "deposit",
    "currency": "BRL",
    "amount": 100.5,
    "tax": 2.5,
    "net_amount": 98,
    "reference": "ORDER-12345",
    "description": "Pagamento de pedido",
    "e2e_id": "E18236120202104062021A1234567ABCD",
    "status": "pending",
    "status_label": "Pendente",
    "name": "João da Silva",
    "document": "12345678901",
    "email": "joao@example.com",
    "phone": "11987654321",
    "copy_paste": "00020126330014BR.GOV.BCB.PIX...",
    "pix_key": "joao@example.com",
    "key_type": "CPF",
    "card_last_four": "1111",
    "card_brand": "visa",
    "installments": 3,
    "created_at": "2024-01-15 10:30:00",
    "updated_at": "2024-01-15 10:30:00",
    "split": {
      "gross": 100,
      "tax": 2.5,
      "net": 97.5,
      "lines": [
        {
          "recipient": "9f1c2b7e-4a6d-4c2f-8b1a-2e5d7c9f0a13",
          "type": "percentage",
          "value": 30,
          "amount": 29.25,
          "status": "pending",
          "status_label": "Pendente"
        }
      ],
      "split_total": 29.25,
      "merchant_net": 68.25
    }
  }
}

Response

O seu servidor deve retornar HTTP 2xx para confirmar o recebimento.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.