Colombia

Colombia es uno de los principales mercados que soportan nuestros servicios de pago. Este país ofrece una amplia variedad de métodos para realizar pagos (Pay-In) y recibir fondos (Pay-Out), lo que lo convierte en una opción estratégica para negocios en línea, plataformas de servicios y comercio electrónico.

Con nuestra solución, puede aprovechar los métodos locales como transferencias bancarias, pagos en efectivo y billeteras digitales para maximizar la accesibilidad y conveniencia para los usuarios colombianos.

tip

Tenga en cuenta que el proceso es siempre el mismo, antes de procesar la transacción debe crear la orden, aquí hay un ejemplo del cuerpo de la orden para este país.

{
    "country": "COL",
    "origin": "api",
    "amount": "3000",
    "email": "test@gmail.com"
}

Tipos de documentos de identificación aceptados

• CC: Cédula de Ciudadanía
• CE: Cédula de Extranjería
• PS: Pasaporte
• TI: Tarjeta de Identidad
• NIT: Número de Identificación Tributaria

Pay In

Los métodos de pago disponibles para recibir fondos en Colombia incluyen opciones flexibles que incluyen tarjetas de crédito y débito, transferencias bancarias y pagos en efectivo.

Tarjeta de crédito y débito

Tipo de transacción	Tipo de pago	Método de pago	Proveedores admitidos	Logotipos
card+	credit / debit	tc	Visa, Mastercard

Completar transacción - Cuerpo (Solicitud de ejemplo)

{
    "hash": "U2FsdGVkX19oU6%....",
    "paymentMethod" : "tc",
    "typePayment" : "credit",
    "typeTransaction":"card+",
    "description" : "Orden de prueba",
    "customer": {
        "typeDocument":"CC",
        "document" : "1234567890",
        "name": "Juan",
        "lastName":"Pérez",
        "phoneNumber":"3133133131"
    },
    "card": {
        "number": "4111111111111111",
        "cvv": "123",
        "month": "12"
        "year": "2025",
    },
    "address": {
            "line1": "123 First Street",
            "countryCode": "CO",
            "stateProvince": "CU",
            "city": "Bogota",
    },
}

---

Transferencia bancaria

Tipo de transacción	Tipo de pago	Método de pago	Proveedores admitidos	Logotipos
bankin	bank	pse	PSE

Completar transacción - Cuerpo (Solicitud de ejemplo)

{
    "hash": "U2FsdGV...",
    "paymentMethod": "PSE",
    "typePayment": "cash",
    "typeTransaction": "cashin",
    "customer": {
        "document": "100000000",
        "name": "Test user",
        "phoneNumber": "3181234567",
        "email": "test@gmail.com"
    },
    "urlReturn": "https://www.youtube.com"
}

---

Billetera

PayPal

Este endpoint permite iniciar un proceso de pago con PayPal a través de nuestra API.
Generaremos una URL de checkout a la que el cliente podrá ser redirigido para completar de forma segura el proceso de pago.

Completar transacción - Body (Ejemplo de solicitud)

{
  "hash": "U2FsdGV...",
  "paymentMethod": "paypal",
  "typePayment": "wallet",
  "typeTransaction": "walletin",
  "merchantId": "564153131",
  "urlReturn": "https://google.com",
  "urlRejected": "https://youtube.com",
  "urlWebhook": "https://webhook/ok"
}

Notas adicionales

• El comercio debe redirigir al usuario a la URL de payer-action inmediatamente después de recibir la respuesta.
• No se debe confiar únicamente en la redirección del usuario para confirmar el pago; siempre se debe validar el estado final del pago utilizando el webhook.

---

Pay Out

Cash - Cash out

Completar transacción - Cuerpo (Solicitud de ejemplo)

{
    "hash": "U2FsdGV...",
    "paymentMethod": "BANCOLOMBIA",
    "typePayment": "cash",
    "typeTransaction": "cashout",
    "reference": "reference-test010-out",
    "expirationDate": "2025-05-3",
    "customer": {
        "document": "100000000",
        "name": "Test user",
        "phoneNumber": "573005102545",
        "email": "test@gmail.com"
    },
    "additionalInformation": {
        "bankAccountType": "AHORRO",
        "bankAccountNumber": "4126161645451616"
    }
}

Respuestas de ejemplo

202 Accepted

{
    "status": {
        "code": 202,
        "message": "success",
        "kind": "unknown"
    },
    "data": {
        "CODE": "0000",
        "DATA": {
            "amount": 10,
            "currency": "COP",
            "description": "Orden de prueba",
            "document": "112384939",
            "otp": "1102",
            "operation": "e0a1d2e6-xxxx-xxxx-xxxx-775e41450d65",
            "expire": "2024-10-27",
        },
        "DESC": "OK",
        "payment": {
            "id": 140,
            "uuid": "e0ebd9cf-xxxx-xxxx-xxxx-401f5da67049",
            "merchant": "d6d29ad2-xxxx-xxxx-xxxx-55d518578434",
            "country": "COL",
            "origin": "api",
            "status": "processing",
            "createdAt": "2024-07-31T06:59:52.000Z",
            "type": "cash",
            "amount": 10,
            "rate": null,
            "rateAmount": null,
            "total": null,
            "paymentPocketStatus": "PENDING",
            "rateProviderAmount": null,
            "sandbox": 1,
            "paymentMethod": "NA",
            "typeMethod": "cashout"
        }
    }
}

Bank - Bank out

Completar transacción - Cuerpo (Solicitud de ejemplo)

{
    "hash": "U2FsdGVkX1%2FYy%2F0....",
    "paymentMethod" : "bancolombia",
    "typePayment" : "bank",
    "typeTransaction":"bankout",
    "description" : "top up",
    "customer": {
        "typeDocument":"CC",
        "document" : "1234567890",
        "name": "Juan",
        "lastName":"Pérez",
        "phoneNumber":"3133133131"
    },
    "address": {
        "line1": "123 First Street",
        "countryCode": "CO",
        "stateProvince": "Province 1",
        "city": "Medellin"
    }
    "additionalInformation":{
        "ctry":"CO",
        "bankAccount":"bancolombia",
        "bankAccountNumber":"12345678912",
        "bankAccountType":"Ahorro"
    }
}

Respuestas de ejemplo

202 Accepted

{
    "status": {
        "code": 202,
        "message": "success",
        "kind": "unknown"
    },
    "data": {
        "statusCode": "Done",
        "data": {
            "transaction": {
                "id": "56e6af48-xxxx-xxxx-xxxx-2407443859",
                "orderId": "f85b47d8-xxxx-xxxx-xxxx-07b5",
                "date": "2024-11-06T18:37:33.098Z",
                "state": "Registered",
                "amount": "10"
            },
        },
        "payment": {
            "id": 524,
            "uuid": "f85b47d8-xxxx-xxxx-xxxx-07b5",
            "merchant": "test.88pay@gmail.com",
            "merchantUuid": "eb81c-123c456cb789",
            "country": "COL",
            "origin": "api",
            "createdAt": "2024-11-06T18:36:52.000Z",
            "amount": 10,
            "rate": null,
            "rateAmount": null,
            "total": null,
            "rateProviderAmount": null,
            "sandbox": 1,
            "paymentMethod": "bancolombia",
            "typeMethod": "bank"
        }
    }
}

---

Limites

💡 Nota: Los valores expresados en esta sección de "Límites" están en COP.

PSE

Metodo de Pago	Minimo	Maximo	Min. Transacciones Diarias / Max. Transacciones Diarias
PSE	5.000 COP	5.000.000 COP	5 Transacciones pendientes por usuario

Transferencia bancaria

Minimo	Maximo	Min. Transacciones Diarias / Max. Transacciones Diarias
$5,000.00	$1,500,000	5 Transacciones pendientes por usuario

Tarjeta de crédito y débito

Minimo	Maximo	Min. Transacciones Diarias / Max. Transacciones Diarias
$5,000.00	$1,500,000	5 Transacciones pendientes por usuario

---

💰 Tarifas y Tasas

A continuación, se detallan las comisiones de procesamiento aplicables (antes del IVA) para transacciones en Colombia, agrupadas por método de pago.

Método de Pago	Tipo	Proveedores	Comisión
💳 Tarjetas Crédito/Débito	Pay In		2.99% + 0.18 USD
🏦 Transferencia Bancaria	Pay In (PSE)		2.00%
🏦 Transferencia Bancaria	Pay Out		0.5% + 1.50 USD
💵 Efectivo	Cash In		2.80% + 0.18 USD
💸 APMs	Wallets / Cash In		2.00% + 0.18 USD
💸 Retiro Efectivo	Cash Out		3.5% - min 1 USD

💡 Nota: Todas las tarifas se expresan en USD y excluyen IVA.