> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cuenta virtual con intención de pago - Argentina

Asigna un CVU por transacción para Argentina. El pago se confirma solo cuando el pagador transfiere el monto exacto antes del vencimiento del plazo.

La Cuenta Virtual con Intención de Pago asigna un CVU (Cuenta Virtual Uniforme) a cada transacción, vinculado a un importe y una fecha de vencimiento específicos. A diferencia de una cuenta virtual estándar que acepta cualquier depósito, este producto solo confirma el PayIn cuando el pagador transfiere exactamente el importe indicado antes de la fecha de vencimiento.

## Antes de comenzar

Asegúrate de tener:

> [card] [Credenciales de API](https://docs.localpayment.com/es/docs/api-keys-and-environments.md)
>
> Credenciales API válidas y token de acceso para la autenticación.

> [card] [Configuración de la cuenta](https://docs.localpayment.com/es/docs/make-your-first-test-payment.md)
>
> Configuración adecuada de la cuenta para el país de destino y verificación de la empresa.

> [card] [Lista blanca de IP](https://docs.localpayment.com/es/docs/dashboard-whitelist-your-ips.md)
>
> Incluye en la lista blanca las direcciones IP de tus servidores para el acceso a la API.

> [card] [Endpoint del webhook](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Configura una URL de webhook para recibir notificaciones de pago.

***

## Cómo funciona

El flujo difiere de la cuenta virtual CVU estándar en un aspecto clave: a cada pago se le asigna una CVU vinculada a **un importe específico**.

1. Tu sistema llama a `POST /api/payin/` con `paymentMethod.code: "1060"` y el importe esperado.
2. Localpayment devuelve un código CVU único, los datos bancarios del beneficiario y una fecha de vencimiento.
3. Tú muestras al pagador el CVU, el importe exacto y la fecha de vencimiento.
4. El pagador inicia una transferencia bancaria al CVU desde su aplicación bancaria o billetera.
5. Cuando la transferencia llega con el importe exacto antes de su vencimiento, Localpayment confirma el pago y envía un webhook a tu sistema.

***

## Paso 1: Crear una intención de pago

Envía una solicitud `POST` al endpoint [Crear Payin](https://docs.localpayment.com/es/reference/payins.md).

### Solicitud

| Parámetro | Tipo | Descripción | Requerido |
| - | - | - | - |
| `externalId` | string | Identificador único para esta transacción en tu sistema. Utiliza el formato UUID4. | ✅ |
| `accountNumber` | string | Tu número de cuenta de Localpayment. | ✅ |
| `country` | string | Debe ser `ARG`. | ✅ |
| `currency` | string | Debe ser `ARS`. | ✅ |
| `amount` | number | La cantidad **exacta** que el pagador debe transferir. | ✅ |
| `paymentMethod.type` | string | Debe ser `BankTransfer`. | ✅ |
| `paymentMethod.code` | string | Debe ser `1060`. | ✅ |
| `paymentMethod.flow` | string | Debe ser `DIRECT`. | ✅ |
| `payer.type` | string | `INDIVIDUAL` o `COMPANY`. | ✅ |
| `payer.name` | string | Nombre del pagador. | ✅ |
| `payer.lastName` | string | Apellido del pagador. Obligatorio cuando `type` es `INDIVIDUAL`. | ✅ |
| `payer.document.type` | string | Tipo de documento, p. ej., `DNI` o `CUIT`. | ✅ |
| `payer.document.id` | string | Número de documento. | ✅ |
| `payer.email` | string | Dirección de correo electrónico del pagador. | |
| `merchant` | object | Datos del comerciante/negocio. | ✅ |

#### Ejemplo de solicitud

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
     --url https://api.stage.localpayment.com/api/payin/ \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "externalId": "550e8400-e29b-41d4-a716-446655440000",
  "accountNumber": "{{yourAccountNumber}}",
  "country": "ARG",
  "currency": "ARS",
  "amount": 5000.00,
  "conceptCode": "0003",
  "comment": "Add any relevant information related to the transaction",
  "paymentMethod": {
    "type": "BankTransfer",
    "code": "1060",
    "flow": "DIRECT"
  },
  "merchant": {
    "type": "COMPANY",
    "name": "Merchant Name",
    "document": {
      "type": "CUIT",
      "id": "30000000000"
    },
    "email": "merchant@example.com",
    "phone": {
      "countryCode": "54",
      "areaCode": "11",
      "number": "87654321"
    },
    "address": {
      "street": "Street",
      "number": "938",
      "city": "Buenos Aires",
      "state": "Buenos Aires",
      "country": "ARG",
      "zipCode": "1000"
    }
  },
  "payer": {
    "type": "INDIVIDUAL",
    "name": "Jane",
    "lastName": "Doe",
    "document": {
      "type": "CUIT",
      "id": "20000000000"
    },
    "email": "jane.doe@example.com",
    "phone": {
      "countryCode": "54",
      "areaCode": "11",
      "number": "12345678"
    },
    "address": {
      "street": "Street",
      "number": "1234",
      "city": "Buenos Aires",
      "state": "Buenos Aires",
      "country": "ARG",
      "zipCode": "1000"
    },
    "birthdate": "1990-01-01",
    "nationality": "ARG"
  }
}'
```

#### Respuesta exitosa

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "transactionType": "PayIn",
  "externalId": "550e8400-e29b-41d4-a716-446655440000",
  "internalId": "5aced5da-40c1-4bec-85ff-c8cd1bcb4526",
  "paymentMethod": {
    "type": "BankTransfer",
    "code": "1060",
    "flow": "DIRECT"
  },
  "country": "ARG",
  "currency": "ARS",
  "amount": 5000.00,
  "accountNumber": "{{yourAccountNumber}}",
  "confirmed": {
    "currency": "ARS",
    "fxQuote": 1,
    "amount": 5000.00
  },
  "payment": {
    "currency": "ARS",
    "fxQuote": 1,
    "financingFee": 0,
    "amount": 5000.00
  },
  "localTaxes": [],
  "withHoldings": [],
  "grossingUps": [],
  "fees": {
    "description": "Fee",
    "currency": "ARS",
    "fxSource": 1,
    "fxQuote": 1,
    "amount": 0,
    "account": "{{yourAccountNumber}}"
  },
  "status": {
    "code": "100",
    "description": "INPROGRESS",
    "detail": "The payin is pending the confirmation"
  },
  "merchant": {
    "type": "COMPANY",
    "name": "Merchant Name",
    "document": {
      "type": "CUIT",
      "id": "30000000000"
    },
    "email": "merchant@example.com",
    "phone": {
      "countryCode": "54",
      "areaCode": "11",
      "number": "87654321"
    },
    "address": {
      "street": "Street",
      "number": "938",
      "city": "Buenos Aires",
      "state": "Buenos Aires",
      "country": "ARG",
      "zipCode": "1000"
    }
  },
  "payer": {
    "type": "INDIVIDUAL",
    "name": "Jane",
    "lastName": "Doe",
    "document": {
      "type": "CUIT",
      "id": "20000000000"
    },
    "email": "jane.doe@example.com",
    "phone": {
      "countryCode": "54",
      "areaCode": "11",
      "number": "12345678"
    },
    "address": {
      "street": "Street",
      "number": "1234",
      "city": "Buenos Aires",
      "state": "Buenos Aires",
      "country": "ARG",
      "zipCode": "1000"
    },
    "birthdate": "1990-01-01",
    "nationality": "ARG"
  },
  "wireInstructions": {
    "beneficiary": {
      "type": "COMPANY",
      "name": "LOCALPAYMENT S.R.L.",
      "document": {
        "type": "CUIT",
        "id": "30716132028"
      },
      "bank": {
        "code": "000",
        "branch": {
          "code": "036"
        },
        "account": {
          "number": "0000000000000000000000"
        }
      }
    },
    "referenceCode": "5aced5da-40c1-4bec-85ff-c8cd1bcb4526"
  },
  "date": {
    "creationDate": "2024-01-15T10:30:00Z",
    "processedDate": "2024-01-15T10:30:01Z",
    "expirationDate": "2024-01-22T10:30:00Z"
  },
  "errors": []
}
```

#### Campos de respuesta clave

| Campo | Descripción |
| - | - |
| `wireInstructions.beneficiary.bank.account.number` | El CVU único al que el pagador debe transferir los fondos. |
| `wireInstructions.beneficiary.bank.name` | Nombre del banco receptor. |
| `date.expirationDate` | Fecha límite en la que el pagador debe completar la transferencia. |
| `status.code` | `100` (INPROGRESS) al crearse. Pasa a `200` (COMPLETED) o `300` (REJECTED) mediante webhook. |

#### Respuesta de error

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "externalId": "550e8400-e29b-41d4-a716-446655440000",
  "internalId": "5aced5da-40c1-4bec-85ff-c8cd1bcb4526",
  "status": {
    "code": "300",
    "description": "REJECTED",
    "detail": "Invalid param + [document.id] + verification failed"
  },
  "errors": [
    {
      "code": "300",
      "detail": "Invalid param + [document.id] + verification failed"
    }
  ]
}
```

***

## Paso 2: Mostrar las instrucciones de pago al pagador

Una vez que recibas la respuesta, muestra lo siguiente al pagador:

* **CVU**: el valor de `wireInstructions.beneficiary.bank.account.number`
* **Importe**: la cantidad exacta de tu solicitud. El pagador debe enviar esta cifra precisa.
* **Vencimiento**: la fecha límite de `date.expirationDate`
* **Nombre del beneficiario**: el valor de `wireInstructions.beneficiary.name` (Localpayment S.R.L. como titular registrado de la cuenta)

> [!NOTE]
>
> ###
>
> Si el pagador transfiere una cantidad diferente, la transferencia se acredita como un pago entrante estándar a una cuenta virtual y no confirma la intención de pago.

***

## Paso 3: Gestionar las notificaciones de pago

A diferencia de una cuenta virtual estándar (donde solo se recibe un webhook cuando se acredita un pago), Pago con Intención activa **dos eventos de webhook**:

1. **Notificación de creación** (`INPROGRESS`): se activa inmediatamente cuando se crea la intención de pago e incluye el CVU asignado y la fecha de vencimiento en `wireInstructions`. Tu sistema puede utilizarla para confirmar la asignación del CVU.
2. **Notificación de finalización** (`COMPLETED`): se activa cuando se procesa la transferencia del pagador y se recibe el importe exacto antes del vencimiento.

### Notificación de finalización (COMPLETED)

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "transactionType": "PayIn",
  "externalId": "550e8400-e29b-41d4-a716-446655440000",
  "internalId": "5aced5da-40c1-4bec-85ff-c8cd1bcb4526",
  "paymentMethod": {
    "type": "BankTransfer",
    "code": "1060",
    "flow": "DIRECT"
  },
  "country": "ARG",
  "currency": "ARS",
  "amount": 5000.00,
  "accountNumber": "{{yourAccountNumber}}",
  "confirmed": {
    "currency": "ARS",
    "fxQuote": 1.0,
    "amount": 5000.00
  },
  "payment": {
    "currency": "ARS",
    "fxQuote": 1.0,
    "financingFee": 0.0,
    "amount": 5000.00
  },
  "localTaxes": [
    {
      "code": "0001",
      "percentage": 1.2,
      "description": "IDC",
      "currency": "ARS",
      "fxSource": 1,
      "fxQuote": 0.0,
      "amount": 60.00,
      "account": "{{yourAccountNumber}}"
    }
  ],
  "withHoldings": [],
  "grossingUps": [],
  "fees": {
    "description": "Fee",
    "currency": "ARS",
    "fxSource": 1,
    "fxQuote": 1,
    "amount": 0.0,
    "account": "{{yourAccountNumber}}"
  },
  "status": {
    "code": "200",
    "description": "COMPLETED",
    "detail": "The payin was credited"
  },
  "merchant": {
    "type": "COMPANY",
    "name": "Merchant Name",
    "document": {
      "type": "CUIT",
      "id": "30000000000"
    },
    "email": "merchant@example.com",
    "phone": {
      "countryCode": "54",
      "areaCode": "11",
      "number": "87654321"
    },
    "address": {
      "street": "Street",
      "number": "938",
      "city": "Buenos Aires",
      "state": "Buenos Aires",
      "country": "ARG",
      "zipCode": "1000"
    }
  },
  "payer": {
    "type": "INDIVIDUAL",
    "name": "Jane",
    "lastName": "Doe",
    "document": {
      "type": "CUIT",
      "id": "20000000000"
    },
    "email": "jane.doe@example.com",
    "phone": {
      "countryCode": "54",
      "areaCode": "11",
      "number": "12345678"
    },
    "address": {
      "street": "Street",
      "number": "1234",
      "city": "Buenos Aires",
      "state": "Buenos Aires",
      "country": "ARG",
      "zipCode": "1000"
    },
    "birthdate": "1990-01-01",
    "nationality": "ARG"
  },
  "wireInstructions": {
    "beneficiary": {
      "type": "COMPANY",
      "name": "LOCALPAYMENT S.R.L.",
      "document": {
        "type": "CUIT",
        "id": "30716132028"
      },
      "bank": {
        "code": "000",
        "branch": {
          "code": "036"
        },
        "account": {
          "number": "0000000000000000000000"
        }
      }
    },
    "referenceCode": "5aced5da-40c1-4bec-85ff-c8cd1bcb4526"
  },
  "date": {
    "creationDate": "2024-01-15T10:30:00Z",
    "processedDate": "2024-01-15T10:38:22Z",
    "expirationDate": "2024-01-22T10:30:00Z"
  },
  "errors": []
}
```

***

## Pruebas en Stage

Utiliza el endpoint [Simular pago de cuenta virtual](https://docs.localpayment.com/es/docs/simulate-virtual-account-payment.md) para realizar pruebas de extremo a extremo en Stage sin realizar transferencias bancarias reales.

Simula un pago exitoso usando `paymentMethod.code: "1060"` y el mismo `externalId` devuelto en la respuesta de creación.

***

## Demo

![](https://mintcdn.com/localpayment-1fee3d41/x0nXcqwNUmbD9R8W/images/docs/7946615aa9fa0357401cf5415179c6a3aeb14b407e6db588ad906ed268bdb917-Payment_Intent_Argentina.gif?s=0433b105db0501bd049d1bbd0fd1e475)

***

## Próximos pasos

> [card] [Recibir notificaciones de pago](https://docs.localpayment.com/es/docs/receive-payment-notifications.md)
>
> Configura tu endpoint de webhook y aprende cómo verificar y gestionar las notificaciones de PayIn para pagos de cuentas virtuales.

> [card] [Obtener el estado de la transacción](https://docs.localpayment.com/es/docs/get-virtual-account-status.md)
>
> Consulta el endpoint de estado de la transacción para verificar el estado actual de una intención de pago.

> [card] [Simular un pago](https://docs.localpayment.com/es/docs/simulate-virtual-account-payment.md)
>
> Prueba tu integración de principio a fin en el entorno de pruebas sin realizar transferencias bancarias reales.

> [card] [Descripción general de las cuentas virtuales](https://docs.localpayment.com/es/docs/virtual-accounts-overview.md)
>
> Conoce todos los productos de cuentas virtuales y sus casos de uso.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.