Acepta Pagos Bre-B en Colombia

Habilita transferencias bancarias instantáneas para clientes colombianos. Confirmación en tiempo real, disponibilidad 24/7.

Problema

• Las tasas de aprobación de tarjetas en Colombia son del 60-70% (los proveedores internacionales aún menos)
• PSE solo funciona en horario laboral de lunes a viernes
• Los clientes prefieren transferencias bancarias antes que tarjetas
• Las confirmaciones manuales de transferencia bancaria tardan horas

Lo que construirás

• Aceptación de pagos instantáneos Bre-B
• Confirmación de pago en tiempo real
• Reconciliación automática vía webhooks

Arquitectura

Cliente → Selecciona Bre-B → Elige banco → Autoriza → Confirmación instantánea

El pago se completa en menos de 60 segundos. Funciona 24/7 incluyendo fines de semana y feriados.

Pasos

1. Obtén Credenciales de API

Regístrate en console.orangepill.cloud:

• Navega a Developers → API Keys
• Copia tu llave de prueba: sk_test_...
• Guarda el webhook secret para después

2. Crea una Solicitud de Pago

const payment = await orangepill.paymentRequests.create({
  amount: 50000,
  currency: "COP",
  payment_method_types: ["bre_b"],
  customer_email: "[email protected]",
  success_url: "https://example.com/success",
  cancel_url: "https://example.com/cancel"
});

// Redirect customer to payment.url

3. El Cliente Paga

Experiencia del cliente:

1. Ve una lista de más de 20 bancos colombianos
2. Selecciona su banco (Bancolombia, Davivienda, BBVA, etc.)
3. Autoriza el pago en la app bancaria
4. Vuelve a tu sitio al instante

4. Recibe la Confirmación

Escucha los webhooks:

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

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

    // Fulfill order immediately
    fulfillOrder(payment.metadata.order_id);
  }

  res.sendStatus(200);
});

5. Prueba de Extremo a Extremo

Usa el modo sandbox:

# Test payment
curl https://api.orangepill.cloud/v1/payment-requests \
  -H "Authorization: Bearer sk_test_..." \
  -d amount=50000 \
  -d currency=COP \
  -d payment_method_types[]=bre_b

Simula éxito/falla en modo de prueba.

6. Maneja Casos Extremos

Configura reintentos automáticos:

const payment = await orangepill.paymentRequests.create({
  amount: 50000,
  currency: "COP",
  payment_method_types: ["bre_b", "pse", "card"],
  // Fallback to PSE/cards if Bre-B fails
});

7. Pasa a Producción

Cambia a producción:

• Reemplaza la llave sk_test_ por sk_live_
• Actualiza el endpoint del webhook a la URL de producción
• Monitorea en el dashboard

Ejemplo de Código

Integración completa:

// Create Bre-B payment
async function createBreBPayment(orderAmount, customerEmail, orderId) {
  const payment = await orangepill.paymentRequests.create({
    amount: orderAmount,
    currency: "COP",
    payment_method_types: ["bre_b"],
    customer_email: customerEmail,
    metadata: { order_id: orderId }
  });

  return payment.url; // Redirect customer here
}

Resultado

Los clientes pagan al instante con sus bancos colombianos preferidos. Sin declinaciones de tarjeta, sin restricciones de horario laboral.

Resultados típicos:

• 85-95% de tasas de aprobación (vs 60-70% para tarjetas)
• 60 segundos de tiempo promedio de pago
• Disponibilidad 24/7 incluyendo fines de semana
• Cero reconciliación manual