🇨🇴 Colombia - 88Pay Documentation

Market Size: 50M+ population · Currency: COP (Colombian Peso) · E-commerce growth: 25% YoY

Why Colombia?

17M+ Nequi Users

#1 digital wallet adoption in LATAM

7 Payment Methods

Most comprehensive coverage in the region

50M Banked Population

High financial inclusion rate

Available Methods

Method	Code	Category	Speed	Best For
💳 Cards	`CARDS`	`CARD`	Instant	Universal acceptance
📱 Nequi	`NEQUI`	`WALLET`	Instant	Young users (18-35)
📱 Daviplata	`DAVIPLATA`	`WALLET`	Instant	Banked adults
🏦 PSE	`PSE`	`BANK`	Instant	Large amounts, B2B
💵 Cash	`CASH`	`CASH`	24-72h	Unbanked, rural areas
🏦 Bank Transfer	`BANK_TRANSFER`	`BANK`	1-2 days	B2B payments
₿ USDT	`USDT`	`CRYPTO`	~10 min	International, stable value

Recommended combo: Cards + Nequi + PSE covers ~90% of Colombian online shoppers.

Method Details

💳 Cards
📱 Nequi
🏦 PSE
💵 Cash
₿ USDT

Credit & Debit Cards

Universal payment method with instant processing and 3D Secure support.Supported networks:

Network	Credit	Debit	Share
Visa	✅	✅	~45%
Mastercard	✅	✅	~40%
American Express	✅	❌	~10%
Diners Club	✅	❌	~5%

Pricing & Limits:

Attribute	Value
Processing fee	3.5% + $0.30 USD
Minimum	$5,000 COP (~$ 1.25 USD)
Maximum	$20,000,000 COP (~$ 5,000 USD)
Settlement	T+7

Request example:

{
  "flow": "PAYIN",
  "method_code": "CARDS",
  "method_category": "CARD",
  "country": "COL",
  "currency": "COP",
  "amount": 150000,
  "customer": {
    "email": "cliente@ejemplo.com",
    "document_type": "CC",
    "document_number": "1234567890",
    "first_name": "Juan",
    "last_name": "Pérez"
  },
  "order": {
    "reference": "ORDER-123",
    "description": "Compra en Mi Tienda"
  },
  "redirect": {
    "success_url": "https://mitienda.com/success",
    "failure_url": "https://mitienda.com/failure"
  }
}

Colombian regulations require customer document (CC, CE, or NIT) for all card transactions.

Nequi Digital Wallet

Colombia’s leading fintech with 17M+ users. Payment via push notification to customer’s phone.

Why Nequi? 70% of Colombian millennials and Gen-Z prefer Nequi over traditional banking apps.

How it works:Pricing & Limits:

Attribute	Value
Processing fee	2.0% (min $500 COP)
Minimum	$1,000 COP
Maximum	$8,000,000 COP (~$ 2,000 USD)
Settlement	T+1

Request example:

{
  "flow": "PAYIN",
  "method_code": "NEQUI",
  "method_category": "WALLET",
  "country": "COL",
  "currency": "COP",
  "amount": 75000,
  "customer": {
    "email": "cliente@ejemplo.com",
    "phone": "3001234567",
    "document_type": "CC",
    "document_number": "1234567890"
  },
  "order": {
    "reference": "ORDER-456",
    "description": "Suscripción mensual"
  }
}

Response:

{
  "id": "chg_abc123",
  "status": "PENDING",
  "method_code": "NEQUI",
  "payment_details": {
    "push_status": "SENT",
    "expires_at": "2025-01-18T15:30:00Z",
    "phone_masked": "300***4567"
  }
}

Show a countdown timer (5 minutes) and instructions to check the Nequi app for the push notification.

PSE (Pagos Seguros en Línea)

Colombia’s official interbank transfer system connecting 25+ banks. Ideal for large transactions.Supported banks:

Major Banks

Bancolombia · Davivienda · BBVA Colombia · Banco de Bogotá · Banco de Occidente · Banco Popular · Banco AV Villas · Banco Caja Social

Digital Banks

Nequi (via Bancolombia) · Daviplata (via Davivienda) · Lulo Bank · Nubank Colombia · Rappipay

Other Banks

Banco Agrario · Banco Falabella · Banco Finandina · Banco GNB Sudameris · Banco Pichincha · Citibank · Itaú · Scotiabank Colpatria

Pricing & Limits:

Attribute	Value
Processing fee	1.5% + $3,500 COP
Minimum	$10,000 COP
Maximum	$200,000,000 COP (~$ 50,000 USD)
Settlement	T+1

Step 1: Get bank list

GET /v1/payment-methods/PSE/banks?country=COL

{
  "banks": [
    { "code": "1007", "name": "Bancolombia" },
    { "code": "1051", "name": "Davivienda" },
    { "code": "1013", "name": "BBVA Colombia" }
  ]
}

Step 2: Create PSE charge

{
  "flow": "PAYIN",
  "method_code": "PSE",
  "method_category": "BANK",
  "country": "COL",
  "currency": "COP",
  "amount": 500000,
  "customer": {
    "email": "cliente@empresa.com",
    "document_type": "NIT",
    "document_number": "900123456"
  },
  "pse_details": {
    "bank_code": "1007",
    "user_type": "1"
  },
  "redirect": {
    "success_url": "https://miempresa.com/success",
    "failure_url": "https://miempresa.com/failure"
  }
}

PSE sessions expire in 15 minutes. Redirect the user immediately after receiving the URL.

Cash Payments

Accept payments at 15,000+ retail locations across Colombia.Networks:

Network	Locations	Coverage
Baloto	10,000+	Urban + Rural
Efecty	8,000+	Urban focus
SuRed	5,000+	Supermarkets
Punto Red	3,000+	Convenience

Pricing & Limits:

Attribute	Value
Processing fee	$2,500 COP fixed
Minimum	$10,000 COP
Maximum	$5,000,000 COP
Expiration	72 hours
Settlement	T+1 after payment

Request:

{
  "flow": "PAYIN",
  "method_code": "CASH",
  "method_category": "CASH",
  "country": "COL",
  "currency": "COP",
  "amount": 120000,
  "customer": {
    "email": "cliente@ejemplo.com",
    "document_type": "CC",
    "document_number": "1234567890"
  }
}

Response with voucher:

{
  "id": "chg_cash123",
  "status": "PENDING",
  "payment_details": {
    "voucher_code": "1234-5678-9012",
    "barcode": "7702151234567890123",
    "barcode_url": "https://api.88pay.io/voucher/chg_cash123.png",
    "pdf_url": "https://api.88pay.io/voucher/chg_cash123.pdf",
    "expires_at": "2025-01-21T23:59:59Z"
  }
}

USDT Cryptocurrency

Accept Tether for USD-stable international payments.Networks:

Network	Fee	Confirmation
TRC20 (Tron)	~$1	~3 minutes
ERC20 (Ethereum)	~$5-20	~5 minutes

Pricing:

Attribute	Value
Processing fee	1.0%
Settlement	Instant (USD)

Request:

{
  "flow": "PAYIN",
  "method_code": "USDT",
  "method_category": "CRYPTO",
  "country": "COL",
  "currency": "USD",
  "amount": 100.00,
  "customer": {
    "email": "crypto@ejemplo.com"
  },
  "crypto_details": {
    "preferred_network": "TRC20"
  }
}

Recommend TRC20 to users for lower network fees and faster confirmation.

Document Types

Colombian regulations require customer identification for most payment methods.

Code	Name	Format	Example
`CC`	Cédula de Ciudadanía	6-10 digits	`1234567890`
`CE`	Cédula de Extranjería	6-10 alphanumeric	`E123456`
`NIT`	NIT (businesses)	9 digits + DV	`900123456-7`
`PP`	Pasaporte	Alphanumeric	`AB1234567`
`TI`	Tarjeta de Identidad	10 digits	`1234567890`

Regulatory Considerations

Anti-Money Laundering (AML)

Transactions over $10,000,000 COP require enhanced verification
Suspicious activity reporting required (UIAF)
Customer identification mandatory for all methods

Tax Considerations

IVA (VAT): 19% applies to most goods/services
Withholding: 1.5% - 11% depending on transaction type
GMF: 0.4% financial transaction tax on some transfers

Data Protection (Ley 1581)

Customer consent required for data processing
Privacy notice must be provided
Data localization recommended but not required

Testing

Cards
Nequi
PSE
Cash

Card Number	Result
`4111111111111111`	✅ Approved
`4000000000000002`	❌ Declined
`4000000000000069`	⏳ Pending

Document: Use CC with 1234567890

Phone: 3001234567Sandbox auto-approves after 30 seconds.

Bank code: 1007 (Test Bank)Sandbox redirects to mock bank page.

Integration Checklist

Implement Cards + Nequi

These two methods cover 70%+ of Colombian online shoppers.

Add PSE

Essential for higher-value transactions and B2B payments.

Add Cash (optional)

Reach unbanked population and increase conversion for price-sensitive customers.

Configure webhooks

Handle async notifications for Nequi, PSE, and Cash payments.

Payment Methods

Detailed method guides

Webhooks

Handle payment notifications

Testing Guide

Complete sandbox documentation

API Reference

Technical documentation

​Why Colombia?

17M+ Nequi Users

7 Payment Methods

50M Banked Population

​Available Methods

​Method Details

​Credit & Debit Cards

​Nequi Digital Wallet

​PSE (Pagos Seguros en Línea)

​Cash Payments

​USDT Cryptocurrency

​Document Types

​Regulatory Considerations

​Testing

​Integration Checklist

​Related Resources

Payment Methods

Webhooks

Testing Guide

API Reference

Why Colombia?

Available Methods

Method Details

Credit & Debit Cards

Nequi Digital Wallet

PSE (Pagos Seguros en Línea)

Cash Payments

USDT Cryptocurrency

Document Types

Regulatory Considerations

Testing

Integration Checklist

Related Resources