Transferencias

Una transferencia mueve fondos desde una cuenta corriente del customer hacia otra cuenta. Según el destino, hay dos tipos:

type	Descripción
OUTGOING_TRANSFER	Transferencia saliente a un tercero por CVU, CBU o alias (otra entidad o billetera).
INTERNAL_TRANSFER	Transferencia interna entre dos cuentas corrientes del mismo customer.

El origen de los fondos siempre es una cuenta corriente del customer (sourceAccountId). Podés indicar el destino de dos formas: inline (CVU/CBU + datos de la contraparte) o referenciando un destinatario de la agenda (contactId).

Solo ARS

Las transferencias operan en pesos argentinos. El currencyCode de la transferencia debe coincidir con el de la cuenta de origen.

Modelo

{
  "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
}

Campo	Tipo	Descripción
id	int64	ID de la transferencia
type	enum	OUTGOING_TRANSFER o INTERNAL_TRANSFER
status	enum	Estado actual. Ver Estados
sourceAccountId	int64	ID de la cuenta corriente de origen
amount	decimal	Monto a transferir. Debe ser > 0
currencyCode	string	ISO 4217. Hoy solo ARS
destination	object	Datos del destino. Ver Destino
contactId	int64	Presente si el destino se tomó de un destinatario de la agenda
description	string	Concepto libre del customer (opcional)
externalId	string	Referencia del customer para conciliación (opcional)
scheduledDate	date	Fecha de ejecución, si la transferencia se agendó a futuro. null si es inmediata
executionDate	ISO 8601	Momento en que se ejecutó. null mientras está SCHEDULED o PENDING_APPROVAL
failureReason	string	Motivo de la falla. Presente solo si status es FAILED

Destino

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

Campo	Tipo	Descripción
cbuCvu	string	CBU o CVU del destino (22 dígitos). Para transferencias internas puede reemplazarse por accountId
alias	string	Alias bancario del destino (alternativa a cbuCvu)
accountId	int64	Solo en INTERNAL_TRANSFER: ID de la otra cuenta corriente del customer
counterParty.name	string	Nombre/razón social del destinatario
counterParty.taxId	string	CUIT/CUIL del destinatario (11 dígitos sin guiones)

Estados

Estado	Descripción
SCHEDULED	Agendada para una scheduledDate futura. Todavía no se ejecutó
PENDING_APPROVAL	A la espera de aprobación, si el customer tiene habilitado control por aprobación
PENDING	Aceptada y encolada para ejecutar
IN_PROGRESS	En proceso de acreditación
COMPLETED	Fondos acreditados en el destino
FAILED	No se pudo completar (ej. saldo insuficiente, destino rechazado). Ver failureReason
CANCELLED	Cancelada por el customer antes de ejecutarse

Una transferencia solo puede cancelarse mientras está en SCHEDULED o PENDING_APPROVAL. Una vez en PENDING o posterior, ya no es cancelable.

Endpoints

Método	Path	Descripción
POST	/v1/transfers	Crear una transferencia (saliente o interna)
GET	/v1/transfers	Listar transferencias
GET	/v1/transfers/{id}	Detalle de una transferencia
POST	/v1/transfers/{id}/cancellations	Cancelar una transferencia SCHEDULED o PENDING_APPROVAL

Listado

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

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

Cómo enviar una transferencia

Para la receta paso a paso (saliente, interna, agendada, con aprobación y cancelación), ver Enviar transferencias.