Колумбия

Колумбия является одним из ключевых рынков, поддерживающих наши платежные услуги. Эта страна предлагает широкий выбор методов для осуществления платежей (Pay-In) и получения средств (Pay-Out), что делает её стратегическим выбором для онлайн-бизнеса, сервисных платформ и электронной коммерции.

С нашим решением вы можете использовать локальные методы, такие как банковские переводы, оплата наличными и цифровые кошельки, чтобы максимизировать доступность и удобство для пользователей в Колумбии.

подсказка

Обратите внимание, что процесс всегда один и тот же: перед обработкой транзакции необходимо создать заказ, вот пример тела заказа для этой страны.

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

Принятые типы документов, удостоверяющих личность

• CC: Карта гражданства
• CE: Карта иностранца
• PS: Паспорт
• TI: Удостоверение личности
• NIT: Идентификационный номер налогоплательщика

доход

Доступные методы оплаты для получения средств в Колумбии включают гибкие варианты, такие как кредитные и дебетовые карты, банковские переводы и оплата наличными.

Кредитная и дебетовая карта

Тип транзакции	Тип оплаты	Способ оплаты	Поддерживаемые поставщики	Логотипы
card+	credit / debit	tc	Visa, Mastercard

Полная транзакция – тело (образец запроса)

{
    "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",
    },
}

---

Банковский перевод

Тип транзакции	Тип оплаты	Способ оплаты	Поддерживаемые поставщики	Логотипы
bankin	bank	pse	PSE

Полная транзакция – тело (образец запроса)

{
    "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"
}

---

Кошелёк

PayPal

Этот endpoint позволяет инициировать процесс оплаты через PayPal с использованием нашего API.
Мы сгенерируем URL для оформления заказа (checkout), на который клиент сможет быть перенаправлен для безопасного завершения процесса оплаты.

Завершение транзакции - Тело запроса (Пример)

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

Дополнительные примечания

• Продавец должен перенаправить пользователя на URL payer-action сразу после получения ответа.
• Не полагайтесь только на перенаправление пользователя для подтверждения оплаты; всегда проверяйте окончательный статус оплаты, используя webhook.

---

платить

Наличные - вывод денег

Полная транзакция – тело (образец запроса)

{
    "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"
    }
}

Примеры ответов

202 Принято

{
    "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"
        }
    }
}

Банк - снять деньги

Полная транзакция – тело (образец запроса)

{
    "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"
    }
}

Примеры ответов

202 Принято

{
    "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-719c501cb757",
            "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"
        }
    }
}

---

пределы

💡 Примечание: значения, указанные в разделе «Лимиты», указаны в COP.

Наличные

Способ оплаты	Минимум	максимум	Мин. Ежедневные транзакции / Макс. Ежедневные транзакции
PSE	5.000 COP	5.000.000 COP	5 ожидающих транзакций на пользователя

Банковский перевод

Минимум	максимум	Мин. Ежедневные транзакции / Макс. Ежедневные транзакции
5.000 COP	1.500.000 COP	5 ожидающих транзакций на пользователя

Кредитная и дебетовая карта

Минимум	максимум	Мин. Ежедневные транзакции / Макс. Ежедневные транзакции
5.000 COP	1.500.000 COP	5 ожидающих транзакций на пользователя

---

💰 Тарифы и ставки

Ниже приведены применимые сборы за обработку (до НДС) для транзакций в Колумбии, сгруппированные по способу оплаты.

Payment Method	Type	Providers	Fee
💳 Credit/Debit Cards	Pay In		2.99% + 0.18 USD
🏦 Bank Transfers	Pay In (PSE)		2.00%
🏦 Bank Transfers	Pay Out		0.5% + 1.50 USD
💵 Cash (Cash In)	Cash In		2.80% + 0.18 USD
📲 Wallets (APMs)	Wallets / Cash In		2.00% + 0.18 USD
💸 Cash Out	Cash Out		3.5% - min 1 USD

💡 Примечание: Все сборы указаны в долларах США и не включают НДС.