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

Argentina CVU

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.

Payment Instructions

Transfer the exact amount to the provided CVU/CBU to complete your payment.

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": "AR",
    "currency": "ARS",
    "payment_method": "cvu",
    "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": {
        "first_name": "João",
        "last_name": "Silva",
        "document_number": "20084908488"
    },
    "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": {
        "reference": "WDCMRMNPBE4CG",
        "bank_account": 50053763000179
    }
}
Modified at 2026-06-09 11:24:50
Previous
Examples
Next
Brazil PIX
Built with