1. šŸ““ Webhooks
Lumo Payment's
  • šŸ“• Introdução
  • Gerar Deposito
    • Depósito em USDT
    • Depósito em PIX
      POST
  • Solicitar Saque
    • Saque via USDT
    • Saque via PIX
      POST
  • šŸ““ Webhooks
    • Introdução Webhooks
    • Webhook Depósito
    • Webhook Saque
    • Webhook USDT
  • šŸ’° Consultar SALDO
    • Integração para Consultar saldo
  • Consultar Transação
    • Consultar transação
  • Criação de contas para usuĆ”rios permitidos
    • Criação de conta
    • Usando a Secret Key Retornada
  1. šŸ““ Webhooks

Webhook Saque

Confirmação de Saque#

Identifique o uuid da transação para poder fazer a validação, alem disto todos webhooks contém no header x-signature com SHA256 para validação que o envio foi feito por nossos servidores.

šŸ’ø Webhook de Saque (Cash-Out)#

Enviado quando um saque PIX Ć© processado.

Eventos#

EventoDescrição
payment.transfer.processingSaque em processamento
payment.transfer.paidSaque confirmado e enviado
paidAlias de payment.transfer.paid
payment.transfer.failedSaque falhou
failedAlias de payment.transfer.failed
processingAlias de payment.transfer.processing

Payload (data)#

{
  "event": "payment.transfer.paid",
  "transaction_id": "cm9z8y7x6w5v4u3t2s1r0q",
  "external_id": "EXT-WD-54321",
  "type": "pix_out",
  "amount": 200.00,
  "amount_fees": 5.00,
  "net_amount": 195.00,
  "status": "paid",
  "end_to_end_id": "E54811417202606080100ABC123DEF456",
  "customer": {
    "name": "Seller X",
    "document": "12345678900"
  },
  "paidAt": "2026-06-08T01:00:00.000Z",
  "createdAt": "2026-06-08T00:30:00.000Z",
  "updatedAt": "2026-06-08T01:00:00.000Z"
}

Descrição dos campos#

CampoTipoDescrição
eventstringTipo do evento
transaction_idstringID interno da transação na LumoPay
external_idstringID da transação no adquirente
typestringSempre pix_out para saques
amountnumberValor bruto do saque (R$)
amount_feesnumberTaxa cobrada (R$)
net_amountnumberValor lĆ­quido enviado (amount - amount_fees)
statusstringStatus atual: paid, processing, failed
end_to_end_idstring|nullID end-to-end do PIX (E2E ID)
customer.namestring|nullNome do recebedor
customer.documentstring|nullCPF/CNPJ do recebedor
paidAtstring|nullData/hora do pagamento (ISO 8601)
createdAtstringData/hora de criação da transação
updatedAtstringData/hora da última atualização

Status que a LumoPayment envia para webhook do Cashout#

Modificado emĀ 2026-06-08 08:54:56
PƔgina anterior
Webhook Depósito
Próxima pÔgina
Webhook USDT
Built with