Transfers

A transfer moves funds from a customer's current account to another account. Depending on the destination, there are two types:

type	Description
OUTGOING_TRANSFER	Outgoing transfer to a third party via CVU, CBU, or alias (another entity or wallet).
INTERNAL_TRANSFER	Internal transfer between two current accounts of the same customer.

The source of funds is always a customer's current account (sourceAccountId). You can specify the destination in two ways: inline (CVU/CBU + counterparty data) or by referencing a recipient from the address book (contactId).

ARS only

Transfers operate in Argentine pesos. The transfer's currencyCode must match the source account's currency.

Model

{
  "id": 90021,
  "type": "OUTGOING_TRANSFER",
  "status": "COMPLETED",
  "sourceAccountId": 17,
  "amount": 150000.00,
  "currencyCode": "ARS",
  "destination": {
    "cbuCvu": "0000000088776655443322",
    "alias": "transportes.del.sur.ars",
    "counterParty": {
      "name": "Transportes del Sur S.R.L.",
      "taxId": "30123456789"
    }
  },
  "contactId": 540,
  "description": "Pago flete mayo",
  "externalId": "ERP-PAY-9001",
  "scheduledDate": null,
  "creationDate": "2026-05-27T09:15:00-03:00",
  "executionDate": "2026-05-27T09:15:04-03:00",
  "failureReason": null
}

Field	Type	Description
id	int64	Transfer ID
type	enum	OUTGOING_TRANSFER or INTERNAL_TRANSFER
status	enum	Current status. See States
sourceAccountId	int64	ID of the source current account
amount	decimal	Amount to transfer. Must be > 0
currencyCode	string	ISO 4217. Currently ARS only
destination	object	Destination data. See Destination
contactId	int64	Present if the destination was taken from a recipient in the address book
description	string	Free-form concept set by the customer (optional)
externalId	string	Customer reference for reconciliation (optional)
scheduledDate	date	Execution date, if the transfer was scheduled for the future. null if immediate
executionDate	ISO 8601	Moment when it was executed. null while SCHEDULED or PENDING_APPROVAL
failureReason	string	Failure reason. Present only if status is FAILED

Destination

"destination": {
  "cbuCvu": "0000000088776655443322",
  "alias": "transportes.del.sur.ars",
  "counterParty": {
    "name": "Transportes del Sur S.R.L.",
    "taxId": "30123456789"
  }
}

Field	Type	Description
cbuCvu	string	CBU or CVU of the destination (22 digits). For internal transfers it can be replaced by accountId
alias	string	Bank alias of the destination (alternative to cbuCvu)
accountId	int64	Only in INTERNAL_TRANSFER: ID of the customer's other current account
counterParty.name	string	Name/legal name of the recipient
counterParty.taxId	string	Tax ID (CUIT/CUIL) of the recipient (11 digits without dashes)

States

Status	Description
SCHEDULED	Scheduled for a future scheduledDate. Not yet executed
PENDING_APPROVAL	Awaiting approval, if the customer has approval control enabled
PENDING	Accepted and queued for execution
IN_PROGRESS	Crediting in progress
COMPLETED	Funds credited to the destination
FAILED	Could not be completed (e.g. insufficient balance, destination rejected). See failureReason
CANCELLED	Cancelled by the customer before execution

A transfer can only be cancelled while it is SCHEDULED or PENDING_APPROVAL. Once in PENDING or later, it is no longer cancelable.

Endpoints

Method	Path	Description
POST	/v1/transfers	Create a transfer (outgoing or internal)
GET	/v1/transfers	List transfers
GET	/v1/transfers/{id}	Transfer detail
POST	/v1/transfers/{id}/cancellations	Cancel a SCHEDULED or PENDING_APPROVAL transfer

List

GET /v1/transfers?type=OUTGOING_TRANSFER&status=COMPLETED&fromDate=2026-05-01&toDate=2026-05-31

200 OK
X-Total-Count: 1

[
  {
    "id": 90021,
    "type": "OUTGOING_TRANSFER",
    "status": "COMPLETED",
    "sourceAccountId": 17,
    "amount": 150000.00,
    "currencyCode": "ARS",
    "destination": {
      "cbuCvu": "0000000088776655443322",
      "alias": "transportes.del.sur.ars",
      "counterParty": { "name": "Transportes del Sur S.R.L.", "taxId": "30123456789" }
    },
    "externalId": "ERP-PAY-9001",
    "executionDate": "2026-05-27T09:15:04-03:00"
  }
]

Filters: type, status, sourceAccountId, fromDate, toDate, externalId, page, count.

How to send a transfer

For the step-by-step recipe (outgoing, internal, scheduled, with approval, and cancellation), see Send transfers.