Métodos de Pago por País

Guía completa de todos los métodos de pago soportados en América Latina.

Resumen

Koywe soporta métodos de pago locales para cada país, optimizados para las mejores tasas de conversión y experiencia de usuario.

Colombia 🇨🇴

PSE (Pagos Seguros en Línea)

Descripción: El sistema de transferencia bancaria online más popular de Colombia. Los clientes pagan directamente desde su cuenta bancaria.

Moneda: COP (Peso Colombiano)

Cómo funciona:

1. Cliente selecciona su banco
2. Redirigido al sitio web del banco
3. Inicia sesión y autoriza el pago
4. Fondos transferidos instantáneamente

Liquidación: Instantáneo - 2 horas

Implementación:

1
const order = await createPayinOrder(token, orgId, merchantId, {
2
  type: 'PAYIN',
3
  originCurrencySymbol: 'COP',
4
  destinationCurrencySymbol: 'COP',
5
  amountIn: 50000,
6
  paymentMethods: [
7
    {
8
      method: 'PSE',
9
      extra: 'BANCOLOMBIA'  // Selección de banco
10
    }
11
  ],
12
  // ... otros campos
13
});

Bancos Soportados:

• BANCOLOMBIA
• DAVIVIENDA
• BANCO_DE_BOGOTA
• BANCO_POPULAR
• BBVA_COLOMBIA
• BANCO_OCCIDENTE
• BANCO_AV_VILLAS
• BANCO_GNB_SUDAMERIS
• Y más…

Mejor para: E-commerce, servicios, suscripciones

Experiencia de Usuario:

• ✅ Confirmación instantánea
• ✅ No necesita tarjeta de crédito
• ✅ Confiado por colombianos
• ⚠️ Requiere cuenta bancaria

Nequi

Descripción: La popular billetera móvil de Colombia. Los clientes pagan usando su app Nequi.

Moneda: COP (Peso Colombiano)

Cómo funciona:

1. Cliente escanea código QR o recibe notificación push
2. Abre app Nequi
3. Confirma el pago
4. Transferencia instantánea

Liquidación: Instantánea

Implementación:

1
const order = await createPayinOrder(token, orgId, merchantId, {
2
  type: 'PAYIN',
3
  originCurrencySymbol: 'COP',
4
  destinationCurrencySymbol: 'COP',
5
  amountIn: 50000,
6
  paymentMethods: [
7
    {
8
      method: 'NEQUI'
9
      // No se necesita campo extra
10
    }
11
  ],
12
  // ... otros campos
13
});

Mejor para: Experiencias mobile-first, transacciones pequeñas

Experiencia de Usuario:

• ✅ Muy rápido
• ✅ Optimizado para móvil
• ✅ Popular entre usuarios jóvenes
• ⚠️ Requiere cuenta Nequi

Brasil 🇧🇷

PIX

Descripción: El sistema de pago instantáneo de Brasil. El método de pago más popular en Brasil.

Moneda: BRL (Real Brasileño)

Cómo funciona:

1. Cliente recibe código QR o código PIX
2. Abre app bancaria
3. Escanea QR o ingresa código
4. Confirma pago
5. Transferencia instantánea

Liquidación: Instantánea

Implementación:

1
const order = await createPayinOrder(token, orgId, merchantId, {
2
  type: 'PAYIN',
3
  originCurrencySymbol: 'BRL',
4
  destinationCurrencySymbol: 'BRL',
5
  amountIn: 100,  // 100 BRL
6
  paymentMethods: [
7
    {
8
      method: 'PIX_STATIC'  // o 'PIX_DYNAMIC'
9
    }
10
  ],
11
  // ... otros campos
12
});

Tipos de PIX:

Mejor para: Todos los casos de uso - PIX es universalmente aceptado en Brasil

Experiencia de Usuario:

• ✅ Confirmación instantánea
• ✅ Funciona 24/7
• ✅ Todos los bancos brasileños lo soportan
• ✅ Comisiones muy bajas

México 🇲🇽

SPEI

Descripción: Sistema de pago electrónico de México para transferencias bancarias instantáneas.

Moneda: MXN (Peso Mexicano)

Cómo funciona:

1. Cliente recibe detalles de cuenta bancaria
2. Inicia transferencia desde su banco
3. Banco procesa vía red SPEI
4. Fondos llegan instantáneamente

Liquidación: Instantánea ⚡

Implementación:

1
const order = await createPayinOrder(token, orgId, merchantId, {
2
  type: 'PAYIN',
3
  originCurrencySymbol: 'MXN',
4
  destinationCurrencySymbol: 'MXN',
5
  amountIn: 500,  // 500 MXN
6
  paymentMethods: [
7
    {
8
      method: 'SPEI'
9
    }
10
  ],
11
  // ... otros campos
12
});

Mejor para: Todos los tamaños de transacción, liquidación instantánea requerida

Experiencia de Usuario:

• ✅ Ampliamente aceptado
• ✅ Sin límite de pago
• ✅ Liquidación instantánea
• ✅ Disponible 24/7

Tarjetas (Crédito/Débito) - Internacional

Descripción: Tarjetas de crédito y débito internacionales.

Moneda: MXN (Peso Mexicano)

Tarjetas Soportadas:

• Visa
• Mastercard
• American Express

Liquidación: Instantánea

Implementación:

1
const order = await createPayinOrder(token, orgId, merchantId, {
2
  type: 'PAYIN',
3
  originCurrencySymbol: 'MXN',
4
  destinationCurrencySymbol: 'MXN',
5
  amountIn: 500,
6
  paymentMethods: [
7
    {
8
      method: 'CARD'
9
    }
10
  ],
11
  // ... otros campos
12
});

Mejor para: Transacciones rápidas, usuarios internacionales

Experiencia de Usuario:

• ✅ Confirmación instantánea
• ✅ Familiar para usuarios
• ⚠️ Comisiones más altas
• ⚠️ Requiere tarjeta

Chile 🇨🇱

Khipu

Descripción: Plataforma de pagos que conecta con bancos chilenos para transferencias instantáneas.

Moneda: CLP (Peso Chileno)

Cómo funciona:

1. Cliente selecciona su banco
2. Redirigido a autenticación bancaria
3. Autoriza pago
4. Transferencia procesada

Liquidación: Instantánea - 2 horas

Implementación:

1
const order = await createPayinOrder(token, orgId, merchantId, {
2
  type: 'PAYIN',
3
  originCurrencySymbol: 'CLP',
4
  destinationCurrencySymbol: 'CLP',
5
  amountIn: 10000,  // 10,000 CLP
6
  paymentMethods: [
7
    {
8
      method: 'KHIPU'
9
    }
10
  ],
11
  // ... otros campos
12
});

Mejor para: E-commerce, servicios digitales

Experiencia de Usuario:

• ✅ Rápido y seguro
• ✅ Soporta principales bancos chilenos
• ✅ Sin necesidad de tarjeta
• ⚠️ Requiere cuenta bancaria

Argentina 🇦🇷

Métodos Locales

Descripción: Múltiples métodos de pago locales adaptados al mercado argentino.

Moneda: ARS (Peso Argentino)

Métodos disponibles:

• Transferencias bancarias
• Métodos locales populares

Implementación:

1
const order = await createPayinOrder(token, orgId, merchantId, {
2
  type: 'PAYIN',
3
  originCurrencySymbol: 'ARS',
4
  destinationCurrencySymbol: 'ARS',
5
  amountIn: 5000,  // 5,000 ARS
6
  paymentMethods: [
7
    {
8
      method: 'KHIPU'  // También funciona para Argentina
9
    }
10
  ],
11
  // ... otros campos
12
});

Mejores Prácticas

Mostrar Métodos Disponibles

1
async function getAvailablePaymentMethods(country, currency) {
2
  const response = await axios.get(
3
    'https://api-sandbox.koywe.com/api/v1/payment-methods',
4
    {
5
      params: {
6
        country: country,
7
        currency: currency
8
      }
9
    }
10
  );
11
  
12
  return response.data;
13
}
14
15
// Uso
16
const methods = await getAvailablePaymentMethods('CO', 'COP');
17
console.log('Métodos disponibles:', methods.map(m => m.method));
18
// ['PSE', 'NEQUI']

Permitir Selección del Usuario

1
// 1. Mostrar métodos disponibles al usuario
2
// 2. Usuario selecciona su preferido
3
// 3. Crear orden con método seleccionado

Manejo de Fallos

1
async function createOrderWithFallback(orderData) {
2
  try {
3
    // Intentar con método preferido
4
    return await createPayinOrder(token, orgId, merchantId, orderData);
5
  } catch (error) {
6
    if (error.response?.data?.code === 'PAYMENT_METHOD_NOT_SUPPORTED') {
7
      // Obtener métodos alternativos
8
      const methods = await getAvailablePaymentMethods(
9
        orderData.country,
10
        orderData.currency
11
      );
12
      
13
      console.log('Métodos alternativos:', methods);
14
      // Mostrar al usuario para que elija otro
15
    }
16
    throw error;
17
  }
18
}

Comparación de Métodos

Próximos Pasos