1. Peru
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
      • Ecuador
        • Ecuador Bank Transfer
      • Guatemala
        • Guatemala Bank Transfer
      • Mexico
        • Mexico SPEI
      • Peru
        • Peru Bank Transfer
          POST
    • Schemas
      • Pay In
      • Country
      • Currency
      • PaymentMethod
      • MerchantOrderReference
      • MerchantTransactionReference
      • CreatePayOutRequest
      • ReturnUrls
      • CreatePayInRequest
      • CreatePayOutResponse
      • PaymentInstructions
      • CreatePayInResponse
  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 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
Documento nacional de identidadDNILength >= 2 <= 10, RegEx ^\d+$
Cédula de ExtranjeríaCELength >= 6 <= 10, RegEx ^[a-zA-Z0-9]+$

Bank Identifier Name

Bank Identifier Name
NameType
ALFIN BANCOBank
BANCO CENTRAL DE RESERVA DEL PERÚBank
BANCO DE COMERCIOBank
BANCO DE LA NACIÓNBank
BANCO FALABELLABank
BANCO GNBBank
BANCO INTERAMERICANO DE FINANZASBank
BANCO PICHINCHA PEBank
BANCO RIPLEYBank
BANCO SANTANDER PEBank
BANK OF CHINABank
BBVA CONTINENTALBank
BCI PEBank
BCPBank
CAJA LOS ANDESFinancial
CAJA METROPOLITANAFinancial
CITIBANKBank
CMAC AREQUIPAFinancial
CMAC CUSCOFinancial
CMAC HUANCAYOFinancial
CMAC ICAFinancial
CMAC MAYNASFinancial
CMAC PIURAFinancial
CMAC TACNAFinancial
CMAC TRUJILLOFinancial
COMPARTAMOS FINANCIERA S.A.Financial
COOPERATIVA ABACOFinancial
CREDISCOTIA FINANCIERA S.A.Financial
DALEWallet
EEDE TARJETAS PERUANASFinancial
FINANCIERA CONFIANZAFinancial
FINANCIERA EFECTIVAFinancial
FINANCIERA OHFinancial
FINANCIERA QAPAQFinancial
ICBC PEBank
INTERBANKBank
MIBANCOBank
PREXPEWallet
SCOTIABANK PEBank

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 bank account number 000000 must be used.

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": "PE",
    "currency": "PEN",
    "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": "Eryn",
        "last_name": "Rogahn",
        "document_type": "CE",
        "document_number": "97",
        "bank_name": "CAJA METROPOLITANA",
        "account_type": "Ahorro",
        "account_number": "62475804",
        "email": "customers@email.com",
        "phone": "(282) 797-0589",
        "address": "customers address"
    }
}'
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 15:02:25
Previous
Mexico SPEI
Next
Country
Built with