Pular para o conteúdo principal

Visão Geral de Status

Ramps progridem através de múltiplos status desde a criação até a conclusão. Entender esses status ajuda você a fornecer atualizações precisas aos usuários.

Fluxo de Status

Obtendo Status do Ramp

GET /api/v2/ramps/{rampId}
const checkRampStatus = async (rampId) => {
  const response = await fetch(
    `https://teste-94u93qnn.uc.gateway.dev/api/v2/ramps/${rampId}`,
    {
      headers: {
        'Authorization': `Bearer ${token}`
      }
    }
  );
  
  const ramp = await response.json();
  return ramp.status;
};

Descrições de Status

StatusDescriçãoMensagem ao Usuário
CREATEDRamp inicializado”Por favor complete o pagamento”
CASH_IN_PROCESSINGPagamento sendo verificado”Processando seu pagamento”
CASH_IN_COMPLETEDPagamento confirmado”Pagamento recebido, convertendo”
CONVERSION_PROCESSINGConvertendo moeda”Convertendo fundos”
CASH_OUT_PROCESSINGEnviando para destino”Entregando fundos”
COMPLETEDTransação concluída”Transação completa!”
FAILEDTransação falhou”Transação falhou”
CANCELEDCancelado por usuário/sistema”Transação cancelada”

Webhooks para Atualizações de Status

Inscreva-se em eventos de ramp:
app.post('/webhooks/killb', (req, res) => {
  const { event, data } = req.body;
  
  switch(event) {
    case 'ramp.cash_in_completed':
      updateUI(data.id, 'Pagamento confirmado');
      break;
    case 'ramp.completed':
      updateUI(data.id, 'Transação completa');
      notifyUser(data.userId, 'Fundos entregues');
      break;
    case 'ramp.failed':
      updateUI(data.id, 'Transação falhou');
      notifyUser(data.userId, data.details);
      break;
  }
  
  res.status(200).json({ received: true });
});

Melhores Práticas

Webhooks fornecem atualizações instantâneas
Faça polling a cada 10-30 segundos se webhook falhar
Exiba status atual aos usuários com barra de progresso
Verifique o campo details para razões de falha

Próximos Passos