1. Colombia
PayPaga V2 API
  • API Overview
    • Introduction
    • API Reference
    • Environments
    • Payment methods
    • Errors
    • Standard Codes and Values
    • Transaction Status Definitions and Lifecycle
    • Changelog
      • Format
  • OAuth2 Service
    • authenticate
      POST
    • Schemas
      • AuthRequest
      • AuthResponse
      • AuthFailed
  • PayPaga Integration API
    • Transactions Configuration
      • List available pay-in configurations.
      • List available pay-out configurations.
    • Pay-in Transactions
      • Search pay-in transactions
      • Create a pay-in transaction.
      • Retrieve a pay-in transaction.
    • Development Utilities
      • Override a pay-in transaction status
      • Override a pay-out transaction status
    • Pay-out Transactions
      • Search pay-out transactions
      • Create a pay-out transaction.
      • Retrieve a pay-out transaction.
    • Pay URLs
      • Create a hosted PayURL checkout
    • Balances
      • Retrieve merchant balance summary.
    • Catalog
      • List supported countries
      • List supported payment methods
    • Settlements
      • Search settlements
      • Retrieve settlement options
      • Retrieve settlement transactions
    • Reference Data
      • Retrieve exchange rates
      • Retrieve tax rates
    • Notifications
      • Create a notification subscription
      • List notification subscriptions
      • Retrieve a notification subscription
      • Delete a notification subscription
    • Schemas
      • MoneyAmount
      • Currency
      • Country
      • PaymentMethod
      • Product
      • OptionField
      • PayInTransactionStatus
      • PayOutTransactionStatus
      • NotificationType
      • PaginationMeta
      • MerchantOrderReference
      • MerchantTransactionReference
      • FeeMode
      • PaymentOption
      • Code
      • Message
      • ValidationErrorItem
      • ValidationErrorDetail
      • ErrorDetail
      • PayInTransaction
      • PayInTransactionListResponse
      • ReturnUrls
      • CreatePayInRequest
      • PaymentInstructions
      • CreatePayInResponse
      • PayInTransactionStatusOverrideRequest
      • PayOutTransaction
      • PayOutTransactionListResponse
      • CreatePayOutRequest
      • CreatePayOutResponse
      • PayOutTransactionStatusOverrideRequest
      • PredefinedFields
      • CreatePayURLRequest
      • CreatePayURLResponse
      • BalanceTotal
      • BalanceCountry
      • BalanceSummaryResponse
      • CountryCatalogEntry
      • PaymentMethodCatalogEntry
      • Settlement
      • SettlementsResponse
      • SettlementWindow
      • SettlementOptionsResponse
      • SettlementTransaction
      • SettlementTransactionsResponse
      • ExchangeRateQuote
      • ExchangeRatesResponse
      • TaxRate
      • ChannelType
      • NotificationSubscriptionResponse
      • ListNotificationSubscriptionsResponse
      • NotificationSubscriptionRequest
      • TransactionCallbackPayload
  • Examples
    • Pay In Examples
      • Argentina
        • Argentina CVU
      • Brazil
        • Brazil PIX
      • Chile
        • Chile Bank Transfer
        • Chile Khipu
      • Colombia
        • Colombia Dale
        • Colombia Daviplata
        • Colombia Efecty
        • Colombia Gana
        • Colombia Movii
        • Colombia Nequi
        • Colombia PSE
        • Colombia RappiPay
        • Colombia ReFacil
        • Colombia Susuerte
        • Colombia Western Union
      • Ecuador
        • Ecuador Bank Transfer
        • Ecuador Banco Guayaquil
        • Ecuador Bemovil
        • Ecuador Deuna
        • Ecuador Mi Negocio Efectivo
        • Ecuador Omniswitch
        • Ecuador RapiActivo
        • Ecuador Western Union
      • Guatemala
        • Guatemala BAM Efectivo
        • Guatemala BAM Transferencia
        • Guatemala Banco Industrial
        • Guatemala Akisi Pronet
      • Mexico
        • Mexico Pay With Cash
        • Mexico SPEI
      • Peru
        • Peru BBVA
        • Peru BCP
        • Peru BCP Efectivo
        • Peru Cell Power
        • Peru KasNet
        • Peru QR Interoperable
        • Peru Plin
        • Peru Yape
    • Pay Out Examples
      • Argentina
        • Argentina CVU
      • Brazil
        • Brazil PIX
      • Chile
        • Chile Bank Transfer
      • Colombia
        • Colombia Bank Transfer
          POST
      • Ecuador
        • Ecuador Bank Transfer
      • Guatemala
        • Guatemala Bank Transfer
      • Mexico
        • Mexico SPEI
      • Peru
        • Peru Bank Transfer
    • Schemas
      • Pay In
      • Country
      • Currency
      • PaymentMethod
      • MerchantOrderReference
      • MerchantTransactionReference
      • CreatePayOutRequest
      • ReturnUrls
      • CreatePayInRequest
      • CreatePayOutResponse
      • PaymentInstructions
      • CreatePayInResponse
  1. Colombia

Colombia Bank Transfer

Production
https://api.paypaga.com
Production
https://api.paypaga.com
POST
/v2/transactions/pay-out

Required Fields

FieldDescriptionValidation
first_nameFirst name
last_nameLast name
document_typeIdentification document typeSee document types listed below
document_numberIdentification document numberSee document types listed below
bank_nameBank nameSee supported bank names below
account_typeAccount typeFrom options: Ahorro or Corriente
account_numberAccount number
emailEmail addressLength >= 5 <= 50, RegEx ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+.[a-zA-Z]{2,}$
phonePhone numberRegEx ^\d+$
addressFull address

Document types

NameDescriptionValidation
Cédula de CiudadaníaCCLength >= 6 <= 10, RegEx ^\d+$
Cédula de ExtranjeríaCELength >= 6 <= 10, RegEx ^[a-zA-Z0-9]+$
PasaportePPLength >= 7 <= 12, RegEx ^[a-zA-Z0-9]+$
Tarjeta de IdentificaciónTILength >= 6 <= 15, RegEx ^[a-zA-Z0-9]+$
Número de Identificación TributariaNILength >= 6 <= 15, RegEx ^[a-zA-Z0-9]+$

Bank Identifier Names

Bank Identifier Names
NameType
AV VILLASBank
BANCAMIABank
BANCO AGRARIOBank
BANCO BTG PACTUALBank
BANCO CAJA SOCIALBank
BANCO DE BOGOTABank
BANCO DE COMERCIO EXTERIORBank
BANCO DE LA REPUBLICABank
BANCO DE OCCIDENTEBank
BANCO FALABELLABank
BANCO FINANDINABank
BANCO MUNDO MUJERBank
BANCO PICHINCHABank
BANCO POPULARBank
BANCO SANTANDER DE NEGOCIOSBank
BANCO SERFINANZABank
BANCO WBank
BANCOLDEXBank
BANCOLOMBIABank
BANCOOMEVAFinancial
BBVABank
BNP PARIBAS COLOMBIABank
CITIBANKBank
COLSUBSIDIOFinancial
COLTEFINANCIERAFinancial
COMPENSARFinancial
CONFIARFinancial
COOFINEPFinancial
COOPERATIVA FINANCIERA DE ANTIOQUIAFinancial
COOTRAFAFinancial
COTRAFA COOPERATIVA FINANCIERAFinancial
CREDICORP CAPITAL COLOMBIAFinancial
DAVIPLATAWallet
DAVIVIENDABank
FEDECAJASFinancial
GIROS Y FINANZAS CFCFinancial
IRISFintech
ITAUBank
JURISCOOPFinancial
LULO BANKBank
MIBANCOFinancial
MOVIIWallet
NEQUIWallet
RAPPIPAYWallet
SCOTIABANK COLPATRIABank
UALAWallet

Amount

While ISO 4217 defines COP as having 2 decimal places in practice these are not used. Amounts in COP must be an integer amount with no decimal places.

Request

Authorization
OAuth 2.0
Client Credentials
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Token URL: https://api.paypaga.com/oauth2/token
or
Body Params application/jsonRequired

Examples

Responses

🟢202
application/json
Pay-out accepted for processing.
Headers

Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.paypaga.com/v2/transactions/pay-out' \
--header 'Content-Type: application/json' \
--data-raw '{
    "country": "CO",
    "currency": "COP",
    "payment_method": "bank_transfer",
    "merchant_transaction_reference": "TRX-2026-0026",
    "merchant_order_reference": "ORDER-2026-0001",
    "merchant_customer_id": "customer@mail.com",
    "customer_ip": "120.29.48.92",
    "amount": 125.5,
    "fields": {
        "first_name": "Juan",
        "last_name": "Pérez",
        "document_type": "CC",
        "document_number": "12345678",
        "bank_name": "BANCOLOMBIA",
        "account_type": "Ahorro",
        "account_number": "1234567890",
        "email": "juan.perez@email.com",
        "phone": "3001234567",
        "address": "Calle 123"
    }
}'
Response Response Example
{
    "transaction_id": "20240806-2010-4086-8342-c28f4979f834",
    "merchant_transaction_reference": "TRX-2026-0026",
    "merchant_order_reference": "ORDER-2026-0001"
}
Modified at 2026-06-09 14:06:36
Previous
Chile Bank Transfer
Next
Ecuador Bank Transfer
Built with