Skip to main content

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:

RailUse it when you haveBank name needed
AR_ACCOUNT_ID_TRANSFERA CBU, CVU or aliasNo
AR_LOCAL_TRANSFERA local bank account numberYes

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:

FieldDescription
currencyARS
amountAmount in ARS
destination.railAR_ACCOUNT_ID_TRANSFER
destination.countryAR
destination.accountIdentifierValueCBU or CVU (22 digits), or alias (6 to 20 characters)
destination.beneficiary.nameAccount holder name
destination.beneficiary.countryAR

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:

FieldDescription
currencyARS
amountAmount in ARS
destination.railAR_LOCAL_TRANSFER
destination.countryAR
destination.accountIdentifierValueBank account number
destination.institution.nameBank name
destination.beneficiary.nameAccount holder name
destination.beneficiary.countryAR

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&currency=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 id or 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​

EventEffect on Balance
Transfer createdamountInUSD is immediately deducted from the user's available balance
Transfer rejectedAmount 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.