Payment Methods by Country

Comprehensive guide to all supported payment methods across Latin America.

Overview

Koywe supports local payment methods for each country, optimized for the best conversion rates and user experience.

Colombia 🇨🇴

PSE (Pagos Seguros en Línea)

Description: Colombia’s most popular online bank transfer system. Customers pay directly from their bank account.

Currency: COP (Colombian Peso)

How it works:

1. Customer selects their bank
2. Redirected to bank’s website
3. Logs in and authorizes payment
4. Funds transferred instantly

Settlement: Instant - 2 hours

Implementation:

const order = await createPayinOrder(token, orgId, merchantId, {
  type: 'PAYIN',
  originCurrencySymbol: 'COP',
  destinationCurrencySymbol: 'COP',
  amountIn: 50000,
  paymentMethods: [
    {
      method: 'PSE',
      extra: { bankAccount: { name: 'BANCOLOMBIA' } }  // Bank selection (per-method extras)
    }
  ],
  // ... other fields
});

Supported Banks:

• BANCOLOMBIA
• DAVIVIENDA
• BANCO_DE_BOGOTA
• BANCO_POPULAR
• BBVA_COLOMBIA
• BANCO_OCCIDENTE
• BANCO_AV_VILLAS
• BANCO_GNB_SUDAMERIS
• And more…

Best for: E-commerce, services, subscriptions

User Experience:

• ✅ Instant confirmation
• ✅ No credit card needed
• ✅ Trusted by Colombians
• ⚠️ Requires bank account

Nequi

Description: Colombia’s popular mobile wallet. Customers pay using their Nequi app.

Currency: COP (Colombian Peso)

How it works:

1. Customer scans QR code or receives push notification
2. Opens Nequi app
3. Confirms payment
4. Instant transfer

Settlement: Instant

Implementation:

const order = await createPayinOrder(token, orgId, merchantId, {
  type: 'PAYIN',
  originCurrencySymbol: 'COP',
  destinationCurrencySymbol: 'COP',
  amountIn: 50000,
  paymentMethods: [
    {
      method: 'NEQUI'
      // No extra field needed
    }
  ],
  // ... other fields
});

Best for: Mobile-first experiences, small transactions

User Experience:

• ✅ Very fast
• ✅ Mobile-optimized
• ✅ Popular among young users
• ⚠️ Requires Nequi account

Brazil 🇧🇷

PIX

Description: Brazil’s instant payment system. The most popular payment method in Brazil.

Currency: BRL (Brazilian Real)

How it works:

1. Customer receives QR code or PIX code
2. Opens banking app
3. Scans QR or enters code
4. Confirms payment
5. Instant transfer

Settlement: Instant

Implementation:

const order = await createPayinOrder(token, orgId, merchantId, {
  type: 'PAYIN',
  originCurrencySymbol: 'BRL',
  destinationCurrencySymbol: 'BRL',
  amountIn: 100,  // 100 BRL
  paymentMethods: [
    {
      method: 'PIX_STATIC'  // or 'PIX_DYNAMIC'
    }
  ],
  // ... other fields
});

PIX Types:

Best for: All use cases - PIX is universally accepted in Brazil

User Experience:

• ✅ Instant confirmation
• ✅ Works 24/7
• ✅ All Brazilian banks support it
• ✅ Very low fees

Mexico 🇲🇽

SPEI

Description: Mexico’s electronic payment system for instant bank transfers.

Currency: MXN (Mexican Peso)

How it works:

1. Customer receives bank account details
2. Initiates transfer from their bank
3. Bank processes via SPEI network
4. Funds arrive instantly

Settlement: Instant ⚡

Implementation:

const order = await createPayinOrder(token, orgId, merchantId, {
  type: 'PAYIN',
  originCurrencySymbol: 'MXN',
  destinationCurrencySymbol: 'MXN',
  amountIn: 500,  // 500 MXN
  paymentMethods: [
    {
      method: 'SPEI'
    }
  ],
  // ... other fields
});

Best for: All transaction sizes, instant settlement required

User Experience:

• ✅ Widely accepted
• ✅ No payment limit
• ✅ Instant settlement
• ✅ Available 24/7

Cards (Credit/Debit) - International

Description: International credit and debit cards.

Currency: MXN (Mexican Peso)

Supported Cards:

• Visa
• Mastercard
• American Express

Settlement: Instant

Implementation:

const order = await createPayinOrder(token, orgId, merchantId, {
  type: 'PAYIN',
  originCurrencySymbol: 'MXN',
  destinationCurrencySymbol: 'MXN',
  amountIn: 500,
  paymentMethods: [
    {
      method: 'CARD'
    }
  ],
  // ... other fields
});

Best for: International customers, instant payments

User Experience:

• ✅ Instant confirmation
• ✅ Familiar to users
• ⚠️ Higher fees
• ⚠️ May require 3DS verification

Chile 🇨🇱

Khipu

Description: Chile’s popular payment aggregator, connecting to multiple banks.

Currency: CLP (Chilean Peso)

How it works:

1. Customer selects bank
2. Redirected to bank or Khipu app
3. Authorizes payment
4. Instant or near-instant transfer

Settlement: Instant - 2 hours

Implementation:

const order = await createPayinOrder(token, orgId, merchantId, {
  type: 'PAYIN',
  originCurrencySymbol: 'CLP',
  destinationCurrencySymbol: 'CLP',
  amountIn: 10000,  // 10,000 CLP
  paymentMethods: [
    {
      method: 'KHIPU'
    }
  ],
  // ... other fields
});

Best for: All Chilean payments

User Experience:

• ✅ Fast
• ✅ Multiple bank support
• ✅ Trusted in Chile

Testing Payment Methods

Sandbox Behavior

In sandbox, all payment methods automatically succeed:

// Success scenario (any amount except 666)
const order = await createPayinOrder(token, orgId, merchantId, {
  amountIn: 50000,
  paymentMethods: [{ method: 'PSE', extra: { bankAccount: { name: 'BANCOLOMBIA' } } }]
  // ... other fields
});
// Result: Order auto-completes successfully
 
// Failure scenario (amount = 666)
const order = await createPayinOrder(token, orgId, merchantId, {
  amountIn: 666,  // Special test amount
  paymentMethods: [{ method: 'PSE', extra: { bankAccount: { name: 'BANCOLOMBIA' } } }]
  // ... other fields
});
// Result: Order fails

Complete testing guide →

Choosing the Right Payment Method

By Country

Always offer the local payment method for best conversion:

By Use Case

E-Commerce:

• Colombia: PSE, Nequi
• Brazil: PIX
• Mexico: SPEI

Large Transactions:

• All countries: Bank transfers (PSE, SPEI, PIX)

Mobile-First:

• Colombia: Nequi
• Brazil: PIX
• All: Mobile-optimized checkout

Dynamic Payment Method Selection

Let customers choose their preferred method:

async function createOrderWithDynamicMethod(country, currency, amount, customerChoice) {
  // 1. Get available methods
  const methods = await getPaymentMethods(country, currency);
  
  // 2. Validate customer choice
  const selectedMethod = methods.find(m => m.method === customerChoice.method);
  if (!selectedMethod) {
    throw new Error('Payment method not available');
  }
  
  // 3. Create order
  const order = await createPayinOrder(token, orgId, merchantId, {
    originCurrencySymbol: currency,
    destinationCurrencySymbol: currency,
    amountIn: amount,
    paymentMethods: [
      {
        method: customerChoice.method,
        extra: customerChoice.extra  // e.g., bank for PSE
      }
    ],
    // ... other fields
  });
  
  return order;
}
 
// Usage
const order = await createOrderWithDynamicMethod(
  'CO',
  'COP',
  50000,
  {
    method: 'PSE',
    extra: { bankAccount: { name: 'BANCOLOMBIA' } }
  }
);

Next Steps