PayZu CâmbioEventos de webhook

Compra concluída

WEBHOOKbuy.settled

Confira o passo a passo → https://docs.payzu.com.br/docs/fx/webhooks


Headers

PayZu-Signaturestringobrigatório
t= com o instante da tentativa, em segundos (Unix), e v1= com o HMAC-SHA256, em hexadecimal, de <t>.<corpo cru>, com o segredo do webhook como chave.
PayZu-Event-Idstringobrigatório
O id do evento. Igual em todas as tentativas.
PayZu-Event-Typestringobrigatório
Evento.buy.settled
PayZu-Delivery-Idstringobrigatório
Identificador da entrega.
PayZu-Delivery-Attemptstringobrigatório
Número da tentativa, a partir de 1.

Body

idstringobrigatório
Identificador do evento, o mesmo de PayZu-Event-Id. Igual em todas as tentativas.
typestringobrigatório
Evento. O mesmo de PayZu-Event-Type.buy.settled
versionintegerobrigatório
Versão do formato do evento. Valor atual: 1.
occurredAtstringobrigatório
Quando o evento aconteceu.
createdAtstringobrigatório
Quando o evento foi registrado.
accountNumberstringobrigatório
Número da conta que produziu o evento.
dataobjectobrigatório
A movimentação, no formato de GET /v1/activity/{code}.
codestringobrigatório
Código da movimentação.
kindstringobrigatório
Tipo da movimentação.depositbuysellwithdrawal
statusstringobrigatório
Status da movimentação.
currencystringobrigatório
Moeda do valor.BRLUSDT
amountstringobrigatório
Valor da movimentação.
brlAmountstring | nullobrigatório
Valor em BRL, em centavos.
receivedAmountstring | nullobrigatório
Valor recebido.
feeBrlstring | nullobrigatório
Taxa em BRL, em centavos.
networkstring | nullobrigatório
Rede da movimentação.
ratestring | nullobrigatório
Cotação, em reais por USDT.
createdAtstringobrigatório
Data e hora da criação.
updatedAtstringobrigatório
Data e hora da última alteração.
confirmedAtstring | nullobrigatório
Data e hora da confirmação.
depositobject | nullobrigatório
Dados do depósito.
buyobject | nullobrigatório
Compra ligada ao depósito, quando há.
statusstringobrigatório
Status dessa compra.
orderCodestring | nullobrigatório
Código dessa compra.
withdrawalobject | nullobrigatório
Dados do saque.
walletLabelstring | nullobrigatório
Nome da carteira de destino.
addressstring | nullobrigatório
Endereço de destino.
feestringobrigatório
Taxa do saque.
submittedAtstring | nullobrigatório
Data e hora do envio do saque.
txIdstring | nullobrigatório
Hash da transação na rede.
explorerUrlstring | nullobrigatório
Página da transação na rede.

Responses

2XXQualquer 2xx em até 10 segundos confirma a entrega.

sem corpo

Exemploapplication/json
{  "id": "evt_7c3f1a9e-2d6b-4e8f-b5a0-9e4c1d7b3f28",  "type": "buy.settled",  "version": 1,  "occurredAt": "2026-11-10T12:06:00.000Z",  "createdAt": "2026-11-10T12:06:00.512Z",  "accountNumber": "900123",  "data": {    "code": "RG-1",    "kind": "buy",    "status": "settled",    "currency": "USDT",    "amount": "27337493786",    "brlAmount": "150000",    "receivedAmount": null,    "feeBrl": "1500",    "network": "TRC20",    "rate": "5.4321000000",    "createdAt": "2026-11-10T12:05:00.000Z",    "updatedAt": "2026-11-10T12:06:00.000Z",    "confirmedAt": null,    "deposit": null,    "withdrawal": null  }}