Saltar al contenido principal

Visión General de Estado

Los ramps progresan a través de múltiples estados desde la creación hasta la finalización. Comprender estos estados te ayuda a proporcionar actualizaciones precisas a los usuarios.

Flujo de Estado

Obteniendo Estado del 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;
};

Descripciones de Estado

EstadoDescripciónMensaje al Usuario
CREATEDRamp inicializado”Por favor completa el pago”
CASH_IN_PROCESSINGPago siendo verificado”Procesando tu pago”
CASH_IN_COMPLETEDPago confirmado”Pago recibido, convirtiendo”
CONVERSION_PROCESSINGConvirtiendo moneda”Convirtiendo fondos”
CASH_OUT_PROCESSINGEnviando a destino”Entregando fondos”
COMPLETEDTransacción completada”¡Transacción completa!”
FAILEDTransacción falló”Transacción falló”
CANCELEDCancelado por usuario/sistema”Transacción cancelada”

Webhooks para Actualizaciones de Estado

Suscríbete a eventos de ramp:
app.post('/webhooks/killb', (req, res) => {
  const { event, data } = req.body;
  
  switch(event) {
    case 'ramp.cash_in_completed':
      updateUI(data.id, 'Pago confirmado');
      break;
    case 'ramp.completed':
      updateUI(data.id, 'Transacción completa');
      notifyUser(data.userId, 'Fondos entregados');
      break;
    case 'ramp.failed':
      updateUI(data.id, 'Transacción falló');
      notifyUser(data.userId, data.details);
      break;
  }
  
  res.status(200).json({ received: true });
});

Mejores Prácticas

Los webhooks proporcionan actualizaciones instantáneas
Haz polling cada 10-30 segundos si webhook falla
Muestra estado actual a usuarios con barra de progreso
Verifica campo details para razones de falla

Próximos Pasos