1. Peru
PayPaga V2 API
  • API Overview
    • Introduction
    • API Reference
    • Environments
    • Payment methods
    • Errors
    • Standard Codes and Values
    • Transaction Status Definitions and Lifecycle
    • Assets
    • Authorization
    • Changelog
      • Format
    • Transactions Status Notification
      • Transactions Status Notification
      • How to verify callback signature
      • Signing public keys
  • OAuth2 Service
    • authenticate
    • 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 transactions
      • Retrieve settlement options
    • Reference Data
      • Retrieve exchange rates
      • Retrieve tax rates
    • Notifications
      • List notification subscriptions
      • Create a notification subscription
      • Retrieve a notification subscription
      • Delete a notification subscription
    • Schemas
      • MoneyAmount
      • Currency
      • Country
      • PayOutTransaction
      • CreatePayURLRequest
      • PredefinedFields
      • PayOutTransactionStatusOverrideRequest
      • CreatePayOutResponse
      • ReturnUrls
      • CreatePayOutRequest
      • TaxRate
      • PaymentInstructions
      • PayInTransactionStatusOverrideRequest
      • CreatePayInRequest
      • CreatePayInResponse
      • CreatePayURLResponse
      • BalanceTotal
      • BalanceCountry
      • BalanceSummaryResponse
      • TransactionCallbackPayload
      • PaymentMethodCatalogEntry
      • Settlement
      • NotificationSubscriptionRequest
      • SettlementWindow
      • SettlementOptionsResponse
      • SettlementTransaction
      • ListNotificationSubscriptionsResponse
      • NotificationSubscriptionResponse
      • ExchangeRatesResponse
      • PayInTransaction
      • ValidationErrorDetail
      • ValidationErrorItem
      • PaymentOption
      • PaymentMethod
      • OptionField
      • Product
      • PayInTransactionStatus
      • PayOutTransactionStatus
      • NotificationType
      • PaginationMeta
      • MerchantOrderReference
      • MerchantTransactionReference
      • FeeMode
      • Code
      • Message
      • ErrorDetail
      • PayInTransactionListResponse
      • Money
      • PayOutTransactionListResponse
      • CountryCatalogEntry
      • SettlementsResponse
      • SettlementTransactionsResponse
      • ExchangeRateQuote
      • ChannelType
  • Examples
    • Pay In Examples
      • Argentina
        • Argentina Instant Transfer
      • Bolivia
        • Bolivia Qr Interoperable
      • 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 Banco Guayaquil
        • Ecuador Bank Transfer
        • Ecuador Bemovil
        • Ecuador Deuna
        • Ecuador Mi Negocio Efectivo
        • Ecuador Omniswitch
        • Ecuador RapiActivo
        • Ecuador Western Union
      • Guatemala
        • Guatemala Akisi Pronet
        • Guatemala BAM Efectivo
        • Guatemala BAM Transferencia
        • Guatemala Banco Industrial
      • Honduras
        • Honduras Cash Voucher
        • Honduras Digital Voucher
      • Mexico
        • Mexico Pay With Cash
        • Mexico SPEI
      • Peru
        • Peru BBVA
        • Peru BCP
        • Peru BCP Efectivo
        • Peru Cell Power
        • Peru KasNet
        • Peru Plin
        • Peru QR Interoperable
        • Peru Yape
    • Pay Out Examples
      • Argentina
        • Argentina Instant Transfer
      • Bolivia
        • Bolivia Bank Transfer
      • 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
          POST
    • Schemas
      • Pay In
        • Country
        • Currency
        • PaymentMethod
        • MerchantOrderReference
        • MerchantTransactionReference
        • ReturnUrls
        • CreatePayInRequest
        • PaymentInstructions
        • CreatePayInResponse
      • Country
      • Code
      • CreatePayInRequest
      • Currency
      • CreatePayInResponse
      • CreatePayOutRequest
      • CreatePayOutResponse
      • MerchantTransactionReference
      • MerchantOrderReference
      • ErrorDetail
      • PaymentInstructions
      • PaymentMethod
      • ReturnUrls
      • Message
      • ValidationErrorDetail
      • ValidationErrorItem
  1. Peru

Peru Bank Transfer

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

Required Fields

FieldDescriptionValidation
first_nameFirst nameLength >= 2 <= 50, RegEx ^\p{L}(?:[ '-]\p{L}+)$
last_nameLast nameLength >= 2 <= 50, RegEx ^\p{L}(?:[ '-]\p{L}+)$
document_typeIdentification document typeSee document types listed below
document_numberIdentification document numberSee document types listed below
bank_codeBank codeSee supported bank codes 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,}$

Optional fields

FieldDescriptionValidation
phonePhone numberRegEx ^\d+$
addressFull address
transfer_typeTransfer typeFrom options: phone or account

Document types

NameDescriptionValidation
Documento nacional de identidadDNILength >= 2 <= 10, RegEx ^\d+$
Cédula de ExtranjeríaCELength >= 6 <= 10, RegEx ^[a-zA-Z0-9]+$

Bank Identifier Code

Bank Identifier Name
CodeNameType
0051AGROBANCOBank
0058ALFIN BANCOBank
0001BANCO CENTRAL DE RESERVA DEL PERÚBank
0023BANCO DE COMERCIOBank
0018BANCO DE LA NACIÓNBank
0054BANCO FALABELLABank
0053BANCO GNBBank
0038BANCO INTERAMERICANO DE FINANZASBank
0035BANCO PICHINCHA PEBank
0055BANCO RIPLEYBank
0056BANCO SANTANDER PEBank
0062BANK OF CHINABank
0011BBVA CONTINENTALBank
0063BCI PEBank
0002BCPBank
0950BITELWallet
0849CAJA LOS ANDESFinancial
0800CAJA METROPOLITANAFinancial
0059CAT (CENCOSUD)Financial
0007CITIBANKBank
0803CMAC AREQUIPAFinancial
0806CMAC CUSCOFinancial
0808CMAC HUANCAYOFinancial
0809CMAC ICAFinancial
0811CMAC MAYNASFinancial
0801CMAC PIURAFinancial
0813CMAC TACNAFinancial
0802CMAC TRUJILLOFinancial
0071COFIDEBank
0091COMPARTAMOS FINANCIERA S.A.Financial
0911COOPAC PACIFICOFinancial
0910COOPERATIVA ABACOFinancial
0043CREDISCOTIA FINANCIERA S.A.Financial
0922DALEWallet
0853DEL CENTROFinancial
0807DEL SANTAFinancial
0921EEDE TARJETAS PERUANASFinancial
0099FINANCIERA CONFIANZAFinancial
0096FINANCIERA EFECTIVAFinancial
0094FINANCIERA OHFinancial
0093FINANCIERA QAPAQFinancial
0052FONDO MIVIVIENDABank
0060ICBC PEBank
0852INCASURFinancial
0003INTERBANKBank
0778JETCASHWallet
0061JP MORGANBank
0049MIBANCOBank
0097MITSUI AUTO FINANCEFinancial
0810PAITAFinancial
0902PLINWallet
0776PREXPEWallet
0098PROEMPRESAFinancial
0850PRYMERAFinancial
0080SANTANDER FINANCIAMIENTOS (SUGIR)Financial
0009SCOTIABANK PEBank
0901YAPEWallet

Note for bank account number:

For BCP bank you must use the Standard Bank Account number (13 digits for Corriente account type and 14 digits for Ahorro account type), for all other insitutions use the CCI (Código de Cuenta Interbancario) with 20 digits.
When specifying phone transfer type the phone number is required and must be a valid Peruvian phone number with a bank account associated.

Request

Authorization
or
Body Params application/jsonRequired

Examples

Responses

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

Bodyapplication/json

🟠400ValidationAndBadRequestError
🔴500InternalError
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.paypaga.com/v2/transactions/pay-out' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 125.5,
    "country": "PE",
    "currency": "PEN",
    "customer_ip": "120.29.48.92",
    "fields": {
        "account_number": "00235017098310904175",
        "account_type": "Ahorro",
        "address": "customers address",
        "bank_code": "0002",
        "document_number": "97",
        "document_type": "CE",
        "email": "customers@email.com",
        "first_name": "Eryn",
        "last_name": "Rogahn",
        "phone": "(282) 797-0589"
    },
    "merchant_customer_id": "customer@mail.com",
    "merchant_order_reference": "ORDER-2026-0001",
    "merchant_transaction_reference": "TRX-2026-0026",
    "payment_method": "bank_transfer"
}'
Response Response Example
202 - Generic response for all payment methods
{
    "merchant_order_reference": "ORDER-2026-0001",
    "merchant_transaction_reference": "TRX-2026-0026",
    "transaction_id": "20240806-2010-4086-8342-c28f4979f834"
}
Modified at 2026-09-07 16:09:06
Previous
Mexico SPEI
Next
Country
Built with