1. Chile
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
          POST
        • Chile Khipu
          POST
      • 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. Chile

Chile Khipu

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

Required Fields#

FieldDescriptionValidation
bank_codeBank identifier codeSee Bank Identifier Codes below

Bank Identifier Code#

NameCodeMinimum amount
Banco de Chilebanco_chile200 CLP
Banco Estadobanco_estado200 CLP
Banco BCIbci200 CLP
Banco Falabellafalabella200 CLP
Banco Itaúitau200 CLP
Banco Santandersantander1000 CLP
Banco Securitysecurity200 CLP
Scotiabankscotiabank200 CLP
Banco BICEbanco_bice200 CLP
Banco Consorciobanco_consorcio2000 CLP
Banco Internacionalbanco_internacional200 CLP
Banco Ripleybanco_ripley200 CLP
Coopeuchcoopeuch1500 CLP
Prepago Los Héroesprepago_los_heroes1000 CLP

Amount#

CLP has no minor currency units, supplied amounts must be an integer amount with no decimal places
Valid:
3724
193457345
Invalid:
3724.00
3724.50

Payment Flows#

The Pay-In response provides three distinct URLs:
Payment URL: A unified link that allows the end user to choose between manual transfer and simplified transfer.
Manual Transfer URL: A direct link that enables the user to complete the payment manually through their bank.
Simplified Transfer URL: A direct link that redirects the user to Khipu’s checkout for a simplified payment experience.

Expiry#

Initiated transactions that are not completed, transition to an Expired state after 72 hours.

Simulator#

By default requests in the Sandbox environment are processed by a Provider simulator, to enable Provider Sandbox processing set DisablePartnerMock header to true.
This header only applies to the Sandbox environment.

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

🟢201
application/json
Pay-in accepted.
Headers

Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.paypaga.com/v2/transactions/pay-in' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 1000,
    "country": "CL",
    "currency": "CLP",
    "payment_method": "khipu",
    "merchant_order_reference": "ORDER-2026-0001",
    "merchant_transaction_reference": "TRX-2026-0001",
    "merchant_customer_id": "customer@email.com",
    "customer_ip": "120.29.48.92",
    "fields": {
        "bank_name": "bci"
    },
    "return_urls": {
        "success_url": "https://merchant.com/payment-success",
        "failure_url": "https://merchant.com/payment-failure",
        "cancel_url": "https://merchant.com/payment-cancelled"
    }
}'
Response Response Example
{
    "transaction_id": "20260205-1127-4678-8883-5e4868d33e4e",
    "payment_method_reference": 129930,
    "expires_at": "2026-06-09T14:13:05.143073869Z",
    "instructions": {
        "payment_method_reference": "azkcl5oof0ie",
        "reference_url": "https://khipu.com/payment/manual/75msm1ddc66a"
    }
}
Modified at 2026-06-17 14:36:41
Previous
Chile Bank Transfer
Next
Colombia Dale
Built with