1. Transactions Configuration
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.
        GET
      • List available pay-out configurations.
        GET
    • 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
      • 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. Transactions Configuration

List available pay-in configurations.

Production
https://api.paypaga.com
Production
https://api.paypaga.com
GET
/v2/transactions/pay-in/config
Can be used to dynamically populate checkout options. Configuration contains payment methods supported for the merchant along with fees, limits, and required fields.

Fee Mode#

fixed: The fee charged to the customer will be the fixed fee amount. Fixed fee is fixed amount in the payment currency.
percentage: The fee charged to the customer will be the percentage fee amount. Percentage fee is calculated as (percentage_fee / 100) * transaction_amount.
both: The fee charged to the customer will be the sum of the fixed fee and the percentage fee. Calculated as fixed_fee + ((percentage_fee / 100) * transaction_amount).
greater: The fee charged to the customer will be the greater of the fixed fee or the percentage fee.

Error codes for List Available Pay-In Configurations#

HTTP statusError codeDescription
400VALIDATION_ERRORRequest validation failed
401UNAUTHORIZEDMissing or invalid authorization token
403FORBIDDENYou do not have permission to access this resource
500INTERNAL_ERRORUnexpected server error

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
Query Params

Responses

🟢200
application/json
Payment options for the merchant.
Bodyapplication/json

🟠400ValidationError
🟠401Unauthorized
🟠403Forbidden
🔴500InternalError
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.paypaga.com/v2/transactions/pay-in/config?country=undefined&payment_method=undefined'
Response Response Example
200 - Success
{
    "currency": "COP",
    "fee_mode": "greater",
    "fixed_fee": 2,
    "minimum_fee": 1,
    "payment_method": "pse",
    "percentage_fee": 3,
    "required_fields": [
        {
            "name": "first_name",
            "pattern": "^\\p{L}*(?:[ '-]\\p{L}+)*$",
            "type": "string"
        },
        {
            "name": "last_name",
            "pattern": "^\\p{L}*(?:[ '-]\\p{L}+)*$",
            "type": "string"
        },
        {
            "name": "document_type",
            "options": {
                "CC": "Cédula de Ciudadanía",
                "CE": "Cédula de Extranjería",
                "PP": "Pasaporte",
                "TE": "Tarjeta de Extranjería"
            },
            "type": "string"
        },
        {
            "name": "document_number",
            "type": "string"
        },
        {
            "name": "bank_code",
            "options": {
                "1001": "BANCO DE BOGOTA",
                "1002": "BANCO POPULAR",
                "1006": "BANCO ITAU",
                "1007": "BANCOLOMBIA",
                "1009": "CITIBANK",
                "1012": "BANCO GNB SUDAMERIS",
                "1013": "BANCO BBVA COLOMBIA S.A.",
                "1019": "SCOTIABANK COLPATRIA",
                "1023": "BANCO DE OCCIDENTE",
                "1032": "BANCO CAJA SOCIAL",
                "1040": "BANCO AGRARIO",
                "1047": "BANCO MUNDO MUJER S.A.",
                "1051": "BANCO DAVIVIENDA",
                "1052": "BANCO AV VILLAS",
                "1059": "BANCAMIA S.A.",
                "1060": "BANCO PICHINCHA S.A.",
                "1061": "BANCOOMEVA S.A.",
                "1062": "BANCO FALABELLA",
                "1063": "BANCO FINANDINA S.A. BIC",
                "1065": "BANCO SANTANDER COLOMBIA",
                "1066": "BANCO COOPERATIVO COOPCENTRAL",
                "1069": "BANCO SERFINANZA",
                "1070": "LULO BANK",
                "1071": "BANCO J.P. MORGAN COLOMBIA S.A.",
                "1097": "DALE",
                "1121": "FINANCIERA JURISCOOP SA COMPAÑÍA DE FINANCIAMIENTO",
                "1283": "CFA COOPERATIVA FINANCIERA",
                "1286": "JFK COOPERATIVA FINANCIERA",
                "1289": "COTRAFA",
                "1292": "CONFIAR COOPERATIVA FINANCIERA",
                "1303": "BANCO UNION antes GIROS",
                "1370": "COLTEFINANCIERA",
                "1507": "NEQUI",
                "1551": "DAVIPLATA",
                "1558": "BAN100",
                "1637": "IRIS",
                "1801": "MOVII S.A.",
                "1802": "DING",
                "1803": "POWWI",
                "1804": "UALÁ",
                "1808": "BOLD CF",
                "1809": "NU",
                "1811": "RAPPIPAY",
                "1812": "COINK SA",
                "1814": "GLOBAL66",
                "1815": "ALIANZA FIDUCIARIA",
                "1816": "CREZCAMOS"
            },
            "type": "string"
        },
        {
            "name": "email",
            "pattern": "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$",
            "type": "string"
        },
        {
            "name": "phone",
            "pattern": "^\\d+$",
            "type": "string"
        },
        {
            "name": "address",
            "pattern": "^[\\p{L}0-9][\\p{L}0-9\\s,'#/.°-]+$",
            "type": "string"
        }
    ]
}
Modified at 2026-06-09 15:16:31
Previous
PayPaga Integration API
Next
List available pay-out configurations.
Built with