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.
You may receive incoming transfers that cannot be matched to a previously created 'Pending' transaction in the following situations:
| Scenario | Description |
|---|---|
| Unmatched payer | The 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 payment | The end user performs a transfer without creating a prior transaction, sending funds directly to your assigned CVU/CBU |
| Expired transaction | A transaction was created but expired before the transfer was completed |
| Third-party payment | The 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.
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:
| Step | Behavior |
|---|---|
| Pay-in creation | The system automatically creates a new pay-in |
| Approval | The pay-in is instantly approved based on the received funds |
| Notification | You 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.
If you integrate Instant Transfers (CVU/CBU), you should take the following into account:
This behavior is expected and inherent to Instant Transfers (CBU/CVU) in Argentina and must be considered as part of your integration logic.
| Field | Description | Validation |
|---|---|---|
| first_name | First name | Length >= 2 <= 50, RegEx ^\p{L}*(?:[ '-]\p{L}+)*$ |
| last_name | Last name | Length >= 2 <= 50, RegEx ^\p{L}*(?:[ '-]\p{L}+)*$ |
| document_number | CUIL/CUIT | RegEx ^(20|23|24|25|26|27|30|33|34)(-?\d{8}-?\d|\d{8}\d)$ Must be valid CUIL/CUIT |
| Field | Description | Validation |
|---|---|---|
| bank_code | Bank identifier code | One of the bank identifier codes listed below |
| Name | Code |
|---|---|
| Mercado Pago | mercado_pago |
| Ualá | uala |
| Naranja X | naranja_x |
| Personal Pay | personal_pay |
| Brubank | brubank |
| Prex | prex |
| Lemon | lemon |
| Galicia | galicia |
| Santander | santander |
| BBVA | bbva |
| Banco Provincia | banco_provincia |
| Banco Nación | banco_nacion |
| ICBC | icbc |
| Macro | macro |
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
Initiated transactions that are not completed, transition to an Expired state after 72 hours.
The instructions to the payer encourage payment within 3 hours.
curl --location --request POST '/payment' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"transaction_id": "20251028-1319-425e-b6e6-6ef9eb963110",
"payment_method_code": "cvu",
"country_code": "AR",
"currency": "ARS",
"transaction_total": 1000,
"merchant_transaction_reference": "abc4561698162696828",
"transaction_fields": [
{
"name": "first_name",
"value": "Barão"
},
{
"name": "last_name",
"value": "Praça"
},
{
"name": "document_number",
"value": "20084908488"
}
]
}'{
"transaction_id": "20251028-1319-425e-b6e6-6ef9eb963110",
"transaction_payment_mode": "ASYNCHRONOUS",
"payment_method_reference": "129916",
"message": "Transaction Successfully",
"version": "0.1",
"next_steps_detail_instructions": [
{
"type": "label",
"key": "payment_method",
"label": "Metodo de Pago",
"description": "cvu"
},
{
"type": "label",
"key": "main_instructions",
"label": "Instrucciones",
"description": "Transfiere el monto exacto al CVU/CBU proporcionado para completar tu pago."
},
{
"type": "label",
"key": "reference",
"label": "Referencia",
"description": "WDCMRMNPBE4CG"
},
{
"type": "label",
"key": "bank_account",
"label": "CVU/CBU",
"description": "50053763000179"
}
]
}