Pular para o conteúdo principal

​
Estrutura do Evento

Todos os eventos de webhook seguem esta estrutura: 
{
  id: string,              // UUID - ID único do evento
  event: string,           // Tipo de evento: RAMP | USER | TRANSACTION | ACCOUNT | CUSTODIAL_ACCOUNT
  action: string,          // Ação: CREATE | UPDATE | DELETE
  data: object,            // Dados específicos do evento
  createdAt: string,       // Timestamp ISO 8601
  updatedAt: string,       // Timestamp ISO 8601
  attempts: number         // Contagem de tentativas de entrega (0 a 5)
}
Use o campo id para idempotência. O campo attempts indica a contagem de retry.

​
Tipos de Evento

​
Eventos RAMP

Tipo: RAMP Ações:
  • CREATE - Ramp criado
  • UPDATE - Status do ramp mudou
  • DELETE - Ramp cancelado (raro)
Status Comuns:
  • CREATED - Ramp inicializado
  • CASH_IN_PROCESSING - Pagamento sendo processado
  • CASH_IN_COMPLETED - Pagamento confirmado
  • CONVERSION_PROCESSING - Convertendo moeda
  • COMPLETED - Totalmente concluído
  • FAILED - Falhou
  • CANCELED - Cancelado

​
Eventos USER

Tipo: USER Ações:
  • CREATE - Usuário registrado
  • UPDATE - Informações do usuário ou status mudou
  • DELETE - Usuário excluído (raro)
Status do Usuário:
  • PENDING - Aguardando verificação
  • ACTIVE - Verificado e ativo
  • REJECTED - KYC rejeitado
  • SUSPENDED - Conta suspensa
Níveis de Acesso:
  • L0 - Não verificado
  • L1 - Básico ($1K diário)
  • L2 - Padrão ($10K diário)
  • L3 - Aprimorado ($50K diário)
  • L4 - Premium (Ilimitado)

​
Próximos Passos

Configuração de Webhook

Configure endpoints de webhook

Guia de Segurança

Verifique assinaturas de webhook

Conceito de Webhook

Aprenda sobre arquitetura de webhook

Referência da API

Documentação da API de Webhook