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 Depósito

Confirmação de Depósito#

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 Depósito (Cash-In)#

Enviado quando um pagamento PIX é recebido na sua conta.

Eventos#

EventoDescrição
payment.processingPagamento em processamento
payment.paidPagamento confirmado e saldo creditado
paidAlias de payment.paid
payment.failedPagamento falhou ou expirou

Payload (data)#

{
  "event": "payment.paid",
  "transaction_id": "cm1a2b3c4d5e6f7g8h9i0j",
  "external_id": "EXT-DEP-12345",
  "type": "pix_in",
  "amount": 150.00,
  "amount_fees": 2.50,
  "net_amount": 147.50,
  "status": "paid",
  "end_to_end_id": "E60701190202606080000DY5OHJK3BDX",
  "customer": {
    "name": "LUMOPAY BRASIL LTDA",
    "document": "12345678900"
  },
  "paidAt": "2026-06-08T00:00:16.000Z",
  "createdAt": "2026-06-07T23:59:09.000Z",
  "updatedAt": "2026-06-08T00:00:16.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_in para depósitos
amountnumberValor bruto recebido (R$)
amount_feesnumberTaxa cobrada (R$)
net_amountnumberValor líquido creditado (amount - amount_fees)
statusstringStatus atual: paid, processing, failed
end_to_end_idstring|nullID end-to-end do PIX (E2E ID)
customer.namestring|nullNome do pagador
customer.documentstring|nullCPF/CNPJ do pagador
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 Cashin#

Modificado em 2026-06-08 08:54:49
Página anterior
Introdução Webhooks
Próxima página
Webhook Saque
Built with