InícioReferência

Cash Out - Payload

Quando uma transação de pagamento via Cash Out (saída de dinheiro via Pix) é concluída com sucesso, a Fire envia o seguinte payload via webhook para a URL configurada por você.

Esse payload contém as informações detalhadas da transação, incluindo dados do pagador e do recebedor.

Estrutura de Payload

{
  "transactionId": "5f56048c-3491-489c-943c-493e44598d72",
  "businessTransactionId": null,
  "status": "WITHDRAW_PAID",
  "value": 1,
  "endToEndId": "XPTO",
  "pixKey": "XPTO",
  "createdDate": "2025-02-25T22:34:49.261Z",
  "ReceiverBankAccount": "0000",
  "ReceiverToBankAccountDigit": "0",
  "ReceiverBankBranch": "0000",
  "ReceiverBankCode": "380",
  "ReceiverDocumentNumber": "00000000",
  "ReceiverBankName": "PICPAY INSTITUIçãO DE PAGAMENTO S.A.",
  "ReceiverBankISPB": "22896431",
  "ReceiverName": "NAME",
  "PayerBankAccount": "0000",
  "PayerBankAccountDigit": "0",
  "PayerBankBranch": "0000",
  "PayerBankCode": "0",
  "PayerDocumentNumber": "45438750000188",
  "PayerBankName": "NAME",
  "PayerBankISPB": "0",
  "PayerName": "FIRE INTERMEDIAÇÃO DE PAGAMENTOS LTDA",
  "VoucherUrl": ""
}

Descrição dos Campos

Campo

Tipo

Descrição

transactionId

string

Identificador único da transação gerado pela FireBanking.

businessTransactionId

string

(Opcional) Identificador da transação fornecido pelo cliente.

status

string

Status atual da transação. Exemplo: WITHDRAW_PAID indica que a retirada foi paga.

value

number

Valor da transação em centavos.

endToEndId

string

Identificador único do pagamento Pix gerado pelo sistema bancário.

pixKey

string

Chave Pix utilizada para enviar o pagamento.

createdDate

string

Data e hora em que a transação foi criada, no formato ISO 8601.

ReceiverBankAccount

string

Número da conta bancária do recebedor do Pix.

ReceiverToBankAccountDigit

string

Dígito verificador da conta bancária do recebedor.

ReceiverBankBranch

string

Número da agência bancária do recebedor.

ReceiverBankCode

string

Código do banco recebedor (Código de compensação bancária).

ReceiverDocumentNumber

string

Número do documento do recebedor (CNPJ ou CPF).

ReceiverBankName

string

Nome do banco recebedor.

ReceiverBankISPB

string

Código ISPB do banco recebedor.

ReceiverName

string

Nome completo ou razão social do recebedor.

PayerBankAccount

string

Número da conta bancária do pagador.

PayerBankAccountDigit

string

Dígito verificador da conta bancária do pagador.

PayerBankBranch

string

Número da agência bancária do pagador.

PayerBankCode

string

Código do banco pagador (Código de compensação bancária).

PayerDocumentNumber

string

Número do documento do pagador (CNPJ ou CPF).

PayerBankName

string

Nome do banco pagador.

PayerBankISPB

string

Código ISPB do banco pagador.

PayerName

string

Nome completo do pagador.

VoucherUrl

string

(Opcional) URL do comprovante de pagamento Pix.

Referente aos status em que a transação pode ter, quando retomado via webhook

  • WITHDRAW_REQUEST: Aguardando o processamento do saque.

  • WITHDRAW_PAID: Se for um saque (Cash Out) que finalizou, por exemplo.

  • ERROR: Algum erro foi gerado e a transação não foi concluída.