Reduce los Pagos Fallidos en América Latina

Recupera ingresos de pagos fallidos. Ruteo automático, reintentos y métodos de fallback.

Problema

• El 30-40% de los pagos fallan en LATAM (vs 15-20% en EE.UU./UE)
• Los clientes abandonan tras la primera declinación
• Los procesos manuales de reintento no escalan
• Un solo proveedor de pago = un solo punto de falla

Lo que construirás

• Ruteo inteligente de pagos entre métodos
• Reintento automático con opciones de fallback
• Recuperación de fallas en tiempo real

Arquitectura

Solicitud de Pago → Método Primario → ¿Falla? → Reintento → Método Fallback → Éxito

Orangepill prueba automáticamente métodos alternativos sin que el cliente reingrese información de pago.

Pasos

1. Habilita Múltiples Métodos de Pago

Configura la cascada de pagos:

const payment = await orangepill.paymentRequests.create({
  amount: 100000,
  currency: "COP",
  payment_method_types: [
    "bre_b",    // Primary: instant bank transfer
    "pse",      // Fallback 1: traditional bank transfer
    "card"      // Fallback 2: card payment
  ],
  retry_config: {
    enabled: true,
    max_attempts: 3
  }
});

2. Configura el Ruteo Inteligente

Establece reglas de ruteo por segmento de cliente:

const routingRules = {
  high_value: ["bre_b", "card"],        // Fast methods for premium customers
  bulk: ["pse", "bre_b"],               // Bank transfers for B2B
  default: ["bre_b", "pse", "card"]     // All methods for everyone else
};

También está disponible la configuración desde el dashboard (no se requiere código).

3. Maneja Declinaciones Suaves

Reintenta automáticamente las fallas temporales:

app.post('/webhooks/orangepill', (req, res) => {
  const event = req.body;

  if (event.type === 'payment.failed') {
    const failure = event.data;

    if (failure.decline_code === 'insufficient_funds') {
      // Offer installment payment option
      offerInstallments(failure.customer_id);
    }
  }

  res.sendStatus(200);
});

4. Implementa Lógica de Reintento

Deja que los clientes reintenten sin reingresar información:

// Customer clicks "Try again"
const retry = await orangepill.paymentRequests.retry(
  'preq_failed123',
  {
    payment_method_types: ["pse", "card"] // Skip Bre-B, try alternatives
  }
);

// Customer sees new payment options immediately

5. Monitorea las Tasas de Aprobación

Rastrea el desempeño por método:

# Dashboard or API
GET /v1/analytics/approval-rates?period=30d

{
  "bre_b": { "approval_rate": 92.5, "avg_time": "45s" },
  "pse": { "approval_rate": 78.3, "avg_time": "15m" },
  "card": { "approval_rate": 65.2, "avg_time": "5s" }
}

6. Habilita Dunning para Recurrencia

Para suscripciones, reintenta automáticamente los cargos fallidos:

const subscription = await orangepill.subscriptions.create({
  customer: "cus_abc123",
  price: "price_monthly",
  retry_schedule: [1, 3, 5, 7] // Retry on days 1, 3, 5, 7 after failure
});

7. Optimiza con Base en los Datos

Usa analítica para refinar el ruteo:

• ¿Qué métodos tienen las mayores tasas de aprobación?
• ¿En qué horarios del día se ven más fallas?
• ¿Qué segmentos de clientes prefieren qué métodos?

Ajusta las reglas de ruteo mensualmente con base en los datos.

Ejemplo de Código

Configuración completa de optimización:

// Create payment with smart fallbacks
async function createOptimizedPayment(amount, customer) {
  const payment = await orangepill.paymentRequests.create({
    amount,
    currency: "COP",
    customer: customer.id,
    payment_method_types: selectMethodsForCustomer(customer),
    retry_config: {
      enabled: true,
      max_attempts: 3,
      retry_delay: 300 // 5 minutes between retries
    },
    metadata: { segment: customer.segment }
  });

  return payment;
}

function selectMethodsForCustomer(customer) {
  if (customer.lifetime_value > 500000) {
    return ["bre_b", "card"]; // Fast methods for high-value
  }
  return ["bre_b", "pse", "card"]; // All methods for others
}

Resultado

Los pagos fallidos se recuperan automáticamente. Los clientes ven métodos alternativos sin fricción.

Resultados típicos:

• 15-25% de aumento en tasas de aprobación
• 30-40% de reducción en tickets de soporte de pagos
• 10-15% de recuperación de ingresos de transacciones previamente fallidas
• 50% de reducción en churn de clientes por fallas de pago