> ## 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.

# Virtual Account com intenção de pagamento - Argentina

Atribua um CVU por transação para a Argentina. O pagamento só será confirmado quando o pagador transferir o valor exato antes do prazo de validade.

A Virtual Account com Intenção de Pagamento atribui uma CVU (Cuenta Virtual Uniforme) a cada transação, vinculada a um valor específico e a um prazo de validade. Ao contrário de uma Virtual Account padrão que aceita qualquer depósito, este produto só confirma o PayIn quando o pagador transfere exatamente o valor indicado antes da data de vencimento.

## Antes de começar

Certifique-se de ter:

> [card] [Credenciais da API](https://docs.localpayment.com/pt-br/docs/api-keys-and-environments.md)
>
> Credenciais de API e token de acesso válidos para autenticação.

> [card] [Configuração da conta](https://docs.localpayment.com/pt-br/docs/make-your-first-test-payment.md)
>
> Configuração adequada da conta para o país de destino e verificação da empresa.

> [card] [Lista branca de IPs](https://docs.localpayment.com/pt-br/docs/dashboard-whitelist-your-ips.md)
>
> Adicione os endereços IP do seu servidor à lista de permissões para acesso à API.

> [card] [Endpoint do webhook](https://docs.localpayment.com/pt-br/docs/webhooks.md)
>
> Configure um URL de webhook para receber notificações de pagamento.

***

## Como funciona

O fluxo difere da Virtual Account CVU padrão em um aspecto fundamental: **a cada pagamento é atribuído um CVU vinculado a um valor específico**.

1. Seu sistema chama `POST /api/payin/` com `paymentMethod.code: "1060"` e o valor esperado.
2. O Localpayment retorna um CVU exclusivo, os dados bancários do beneficiário e uma data de validade.
3. Você exibe o CVU, o valor exato e a data de vencimento para o pagador.
4. O pagador inicia uma transferência bancária para a CVU a partir do seu aplicativo bancário ou carteira digital.
5. Quando a transferência chega com o valor exato antes do vencimento, o Localpayment confirma o PayIn e envia um webhook para o seu sistema.

***

## Passo 1: Criar uma intenção de pagamento

Envie uma requisição `POST` para o endpoint [Criar Payin](https://docs.localpayment.com/pt-br/reference/payins.md).

### Solicitação

| Parâmetro | Tipo | Descrição | Obrigatório |
| - | - | - | - |
| `externalId` | string | Identificador único para esta transação em seu sistema. Use o formato UUID4. | ✅ |
| `accountNumber` | string | Seu número de conta Localpayment. | ✅ |
| `country` | string | Deve ser `ARG`. | ✅ |
| `currency` | string | Deve ser `ARS`. | ✅ |
| `amount` | number | O valor **exato** que o pagador deve transferir. | ✅ |
| `paymentMethod.type` | string | Deve ser `BankTransfer`. | ✅ |
| `paymentMethod.code` | string | Deve ser `1060`. | ✅ |
| `paymentMethod.flow` | string | Deve ser `DIRECT`. | ✅ |
| `payer.type` | string | `INDIVIDUAL` ou `COMPANY`. | ✅ |
| `payer.name` | string | Primeiro nome do pagador. | ✅ |
| `payer.lastName` | string | Sobrenome do pagador. Obrigatório quando `type` é `INDIVIDUAL`. | ✅ |
| `payer.document.type` | string | Tipo de documento, por exemplo `DNI` ou `CUIT`. | ✅ |
| `payer.document.id` | string | Número do documento. | ✅ |
| `payer.email` | string | Endereço de e-mail do pagador. | |
| `merchant` | object | Detalhes do comerciante/empresa. | ✅ |

#### Exemplo de solicitação

```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"
  }
}'
```

#### Resposta bem-sucedida

```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 resposta principais

| Campo | Descrição |
| - | - |
| `wireInstructions.beneficiary.bank.account.number` | O CVU exclusivo para o qual o pagador deve transferir os fundos. |
| `wireInstructions.beneficiary.bank.name` | Nome do banco destinatário. |
| `date.expirationDate` | Prazo limite para que o pagador conclua a transferência. |
| `status.code` | `100` (INPROGRESS) na criação. Passa para `200` (COMPLETED) ou `300` (REJECTED) via webhook. |

#### Resposta de erro

```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"
    }
  ]
}
```

***

## Etapa 2: Exibir as instruções de pagamento ao pagador.

Após receber a resposta, mostre o seguinte ao pagador:

* **CVU**: o valor de `wireInstructions.beneficiary.bank.account.number`
* **Valor**: o valor exato da sua solicitação. O pagador deve enviar esse valor preciso.
* **Validade**: o prazo de `date.expirationDate`
* **Nome do beneficiário**: o valor de `wireInstructions.beneficiary.name` (Localpayment S.R.L. como titular registrado da conta)

> [!NOTE]
>
> ###
>
> Se o pagador transferir um valor diferente, a transferência será creditada como um PayIn padrão de Virtual Account e não confirmará a intenção de pagamento.

***

## Etapa 3: Gerenciar notificações de pagamento

Ao contrário de uma virtual account padrão (onde você só recebe um webhook quando um pagamento é creditado), o Pagamento com Intenção aciona **dois eventos de webhook**:

1. **Notificação de criação** (`INPROGRESS`): é acionada imediatamente quando a intenção de pagamento é criada, contendo o CVU atribuído e a data de validade em `wireInstructions`. Seu sistema pode usá-la para confirmar a atribuição do CVU.
2. **Notificação de conclusão** (`COMPLETED`): é acionada quando a transferência do pagador é processada e o valor exato é recebido antes do vencimento.

### Notificação de conclusão (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": []
}
```

***

## Teste no Stage

Use o endpoint [Simulate Virtual Account Payment](https://docs.localpayment.com/pt-br/docs/simulate-virtual-account-payment.md) para testar o processo de ponta a ponta no ambiente de teste (Stage) sem realizar transferências bancárias reais.

Simule um pagamento bem-sucedido usando `paymentMethod.code: "1060"` e o mesmo `externalId` retornado na resposta de criação.

***

## Demonstração

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

***

## Próximos passos

> [card] [Receba notificações de pagamento](https://docs.localpayment.com/pt-br/docs/receive-payment-notifications.md)
>
> Configure seu endpoint de webhook e aprenda como verificar e lidar com notificações PayIn para pagamentos de virtual account.

> [card] [Obter status da transação](https://docs.localpayment.com/pt-br/docs/get-virtual-account-status.md)
>
> Consulte o endpoint de status da transação para verificar o estado atual de uma intenção de pagamento.

> [card] [Simular um pagamento](https://docs.localpayment.com/pt-br/docs/simulate-virtual-account-payment.md)
>
> Teste sua integração de ponta a ponta no ambiente de teste, sem transferências bancárias reais.

> [card] [Visão geral de Virtual Accounts](https://docs.localpayment.com/pt-br/docs/virtual-accounts-overview.md)
>
> Conheça todos os produtos de virtual account e seus casos de uso.


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