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

Argentina Instant Transfer

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

Important Considerations

Instant Transfers in Argentina allow end users to send funds directly to a CVU/CBU, both inside and outside of a checkout flow.
This behavior is expected and inherent to Instant Transfers (CBU/CVU) in Argentina.
PayPaga has built a transaction matching logic to cover the majority of use cases. However, there are known situations where an incoming payment cannot be matched to an existing pay-in previously created via the API.
Matching logic is configured on a per account basis and dependant on orchestration configuration.


Unmatched or Unplanned Payments

You may receive incoming transfers that cannot be matched to a previously created 'Pending' transaction in the following situations:

ScenarioDescription
Unmatched payerThe payment is initiated by the expected customer, but the payer identification (CUIL/CUIT) does not match the one provided when the transaction was created
Unsolicited paymentThe end user performs a transfer without creating a prior transaction, sending funds directly to your assigned CVU/CBU
Expired transactionA transaction was created but expired before the transfer was completed
Third-party paymentThe payment is initiated by a different person or legal entity than the customer defined in the original transaction, even if the amount or reference matches

Important
You cannot currently reject or automatically refund unsolicited payments.
Once funds are received in your assigned CVU/CBU, the pay-in is considered approved and reflected accordingly.


System Behavior for Unmatched Payments

When an incoming transfer cannot be matched to an existing pending transaction (including cases where a previous transaction exists but is already expired), the system behaves as follows:

StepBehavior
Pay-in creationThe system automatically creates a new pay-in
ApprovalThe pay-in is instantly approved based on the received funds
NotificationYou are notified via your configured webhook notifications

As a result, you may receive a successful pay-in notification for a transaction that you did not explicitly create beforehand via the API.


What You Should Consider

If you integrate Instant Transfers (CVU/CBU), you should take the following into account:

  • Do not assume that every approved pay-in originates from a transaction you previously created.
  • Always rely on webhooks and reports as your source of truth for successful payments.
  • Ensure your system is capable of handling unsolicited/third-party payments. Note that unsolicited/third-party payments are not supported for Forex and Crypto industries.

This behavior is expected and inherent to Instant Transfers (CBU/CVU) in Argentina and must be considered as part of your integration logic.


Required Fields

FieldDescriptionValidation
first_nameFirst nameLength >= 2 <= 50, RegEx ^\p{L}*(?:[ '-]\p{L}+)*$
last_nameLast nameLength >= 2 <= 50, RegEx ^\p{L}*(?:[ '-]\p{L}+)*$
document_numberCUIL/CUITRegEx ^(20|23|24|25|26|27|30|33|34)(-?\d{8}-?\d|\d{8}\d)$ Must be valid CUIL/CUIT (length/format/check digit)

Optional Fields

FieldDescriptionValidation
bank_codeBank identifier codeOne of the bank identifier codes listed below

Bank Identifier Code

NameCode
Mercado Pagomercado_pago
Ualáuala
Naranja Xnaranja_x
Personal Paypersonal_pay
Brubankbrubank
Prexprex
Lemonlemon
Galiciagalicia
Santandersantander
BBVAbbva
Banco Provinciabanco_provincia
Banco Naciónbanco_nacion
ICBCicbc
Macromacro

User Experience

Logos for primary banks can be displayed to enhance the user experience as per the PayPaga demonstration site.
Logos can be sourced from the Assets in the documentation Appendix

Expiry

Initiated transactions that are not completed, transition to an Expired state after 72 hours.
The instructions to the payer encourage payment within 3 hours.

Response Fields

FieldDescription
referencePayment reference code generated for this transaction. Including it in the transfer's payment concept can help match the incoming payment, though matching is primarily done via the payer's document number (CUIL/CUIT).
bank_accountCVU/CBU account number the payer must transfer the funds to.
beneficiaryName of the receiving account holder (Razón Social), when configured for your account.
aliasAlias of the receiving CVU/CBU account, when configured for your account.

Payment Instructions

  1. Open your banking app or digital wallet.
  2. Look for the "Transfer to CVU/CBU" option and paste the CVU/CBU number provided in the response.
  3. Confirm the payment details and complete the transfer.

Important
The CUIL/CUIT of the person initiating the payment must match the CUIL/CUIT registered with the bank, otherwise the payment will not go through.
Transfer the exact amount to the provided CVU/CBU.

Spanish:

  1. Abre tu app bancaria o billetera digital.
  2. Busca la opción "Transferir a CVU/CBU" y pega el número de CVU/CBU.
  3. Confirma los datos del pago y completa la transferencia.

Importante
El CUIL/CUIT de quien inicia el pago debe coincidir con el CUIL/CUIT del banco, de lo contrario, el pago no se efectuará.
Transfiere el importe exacto al CVU/CBU proporcionado.

When configured for your account, the response may also include beneficiary (receiving account holder name / Razón Social) and alias (receiving account alias) to help the payer verify the destination account.

Request

Authorization
or
Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
Pay-in accepted.
Headers

Bodyapplication/json

🟠400ValidationAndBadRequestError
🔴500InternalError
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": "AR",
    "currency": "ARS",
    "customer_ip": "120.29.48.92",
    "fields": {
        "document_number": "20084908488",
        "first_name": "João",
        "last_name": "Silva"
    },
    "merchant_customer_id": "customer@email.com",
    "merchant_order_reference": "ORDER-2026-0001",
    "merchant_transaction_reference": "TRX-2026-0001",
    "payment_method": "cvu",
    "return_urls": {
        "failure_url": "https://merchant.com/payment-failure",
        "success_url": "https://merchant.com/payment-success"
    }
}'
Response Response Example
201 - Argentina CVU
{
    "expires_at": "2026-06-09T14:13:05.143073869Z",
    "instructions": {
        "alias": "PAYPAGA.PAGOS.ARS",
        "bank_account": "50053763000179",
        "beneficiary": "PAYPAGA ARGENTINA S.A.",
        "reference": "WDCMRMNPBE4CG"
    },
    "payment_method_reference": "129930",
    "transaction_id": "20260205-1127-4678-8883-5e4868d33e4e"
}
Modified at 2026-09-16 10:28:01
Previous
ChannelType
Next
Bolivia Qr Interoperable
Built with