How to Create an ARS Bank Transfer
ARS bank transfers send funds to an Argentine bank account. The destination is a payout destination: the bank details and the beneficiary that owns them. You don't need to create anything beforehand: the destination is created automatically when you submit the transfer, or you can reuse one you already have.
There are two payment rails for Argentina, and the one you pick decides which fields you need:
| Rail | Use it when you have | Bank name needed |
|---|---|---|
AR_ACCOUNT_ID_TRANSFER | A CBU, CVU or alias | No |
AR_LOCAL_TRANSFER | A local bank account number | Yes |
You can create an ARS transfer in three ways:
- Option A — New transfer using a CBU, CVU or alias
- Option B — New transfer using a local account number and bank name
- Option C — Reuse a previously created payout destination with its
id
PDF attachments are optional for ARS transfers. If included: maximum 10 files, maximum 1 MB per file, PDF format only.
Read the Bank Transfers Overview first for authentication, the request format and the transfer lifecycle.
Endpoint
POST /payout/transfer
API Reference: Create a bank transfer
The request is multipart/form-data. The destination field is sent as a JSON-encoded string.
Option A — CBU/CVU/Alias
Use rail AR_ACCOUNT_ID_TRANSFER. Pass the CBU, CVU or alias as accountIdentifierValue and the account holder name in beneficiary.name. The API detects whether the value is a CBU/CVU or an alias. No bank name is required.
Required fields for this option:
| Field | Description |
|---|---|
currency | ARS |
amount | Amount in ARS |
destination.rail | AR_ACCOUNT_ID_TRANSFER |
destination.country | AR |
destination.accountIdentifierValue | CBU or CVU (22 digits), or alias (6 to 20 characters) |
destination.beneficiary.name | Account holder name |
destination.beneficiary.country | AR |
destination.label is optional and lets you find the destination later. Beneficiary type, taxId, address and email are optional for this rail.
Request — CBU
curl -X POST "/api/v1/payout/transfer" \
-H "x-api-key: <your_api_key>" \
-H "Authorization: Bearer <token>" \
-F "currency=ARS" \
-F "amount=950000.00" \
-F 'destination={"rail":"AR_ACCOUNT_ID_TRANSFER","country":"AR","accountIdentifierValue":"2850590940090418135201","label":"María González - Galicia","beneficiary":{"name":"María González","country":"AR"}}'
Request — Alias
curl -X POST "/api/v1/payout/transfer" \
-H "x-api-key: <your_api_key>" \
-H "Authorization: Bearer <token>" \
-F "currency=ARS" \
-F "amount=950000.00" \
-F 'destination={"rail":"AR_ACCOUNT_ID_TRANSFER","country":"AR","accountIdentifierValue":"MARIA.GONZALEZ","beneficiary":{"name":"María González","country":"AR"}}'
Option B — Local Account Number
Use rail AR_LOCAL_TRANSFER. Pass the bank account number as accountIdentifierValue, the bank name in institution.name, and the account holder name in beneficiary.name.
Required fields for this option:
| Field | Description |
|---|---|
currency | ARS |
amount | Amount in ARS |
destination.rail | AR_LOCAL_TRANSFER |
destination.country | AR |
destination.accountIdentifierValue | Bank account number |
destination.institution.name | Bank name |
destination.beneficiary.name | Account holder name |
destination.beneficiary.country | AR |
Request
curl -X POST "/api/v1/payout/transfer" \
-H "x-api-key: <your_api_key>" \
-H "Authorization: Bearer <token>" \
-F "currency=ARS" \
-F "amount=950000.00" \
-F 'destination={"rail":"AR_LOCAL_TRANSFER","country":"AR","accountIdentifierValue":"0000003100012345678901","institution":{"name":"Banco Galicia"},"beneficiary":{"name":"María González","country":"AR"}}'
Option C — Existing Payout Destination
If a payout destination was created before, by a previous transfer or directly through the destinations API, reuse it by passing its id. No other destination fields are needed.
Find an existing Argentine destination
curl -X GET "/api/v1/payout-destination?country=AR¤cy=ARS" \
-H "x-api-key: <your_api_key>" \
-H "Authorization: Bearer <token>"
This returns a paginated list of the active payout destinations of the authenticated user. Use the optional search parameter to look for a label or bank name, and use the id of the destination you want.
Request
curl -X POST "/api/v1/payout/transfer" \
-H "x-api-key: <your_api_key>" \
-H "Authorization: Bearer <token>" \
-F "currency=ARS" \
-F "amount=950000.00" \
-F 'destination={"id":"d6c6c357-343f-4106-8f7d-b678c60ff10a"}'
Send either
idor the destination fields, never both.
Attaching PDF files (optional)
Add one -F "files=@..." part per file to any of the requests above.
-F "files=@invoice.pdf" \
-F "files=@transfer_order.pdf"
Response (201) — All options
{
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"type": "transfer",
"payoutNumber": "002095696342671878",
"status": "pending",
"currency": "ARS",
"amount": "950000.00",
"amountInUSD": "633.33",
"quote": "1500.00",
"pdfDocuments": [],
"destination": {
"id": "d6c6c357-343f-4106-8f7d-b678c60ff10a",
"label": "María González - Galicia",
"rail": "AR_ACCOUNT_ID_TRANSFER",
"country": "AR",
"currency": "ARS",
"accountIdentifierScheme": "AR_CBU",
"accountIdentifierValue": "2850590940090418135201",
"beneficiary": {
"name": "María González"
}
},
"createdAt": "2026-05-14T12:05:00.000Z",
"updatedAt": "2026-05-14T12:05:00.000Z"
}
destination is a snapshot of the destination taken when the transfer was created. Later edits to the destination don't change it.
Balance Impact
| Event | Effect on Balance |
|---|---|
| Transfer created | amountInUSD is immediately deducted from the user's available balance |
| Transfer rejected | Amount is automatically restored to the user's balance |
amountInUSD and quote are calculated by the API from the current ARS exchange rate when the transfer is created.