Cuentas corrientes (MAIN/SUB)

Las cuentas corrientes son las cuentas operativas del customer en Max Pay, donde se acumulan los fondos liquidados desde las cuentas recaudadoras. A diferencia de las cuentas recaudadoras, no reciben transferencias directas de clientes; reciben liquidaciones internas.

Tipo	Descripción
MAIN	Cuenta principal del customer. Recibe el grueso de las liquidaciones
SUB	Sub-cuentas operativas. Su uso depende de la configuración del customer

Lectura y origen de transferencias

La cuenta corriente en sí es read-only por API (no se crea ni se edita). Sí es el origen de fondos de las transferencias salientes e internas. Otras operaciones transaccionales (inversiones, etc.) se realizan desde el panel web.

Modelo

{
  "id": 17,
  "accountType": "MAIN",
  "cvu": "0000000099887766554400",
  "alias": "distribuidora.demo.main",
  "currencyCode": "ARS",
  "status": "ACTIVE",
  "lastSettlementDate": "2026-05-14T18:00:00-03:00",
  "creationDate": "2025-11-01T10:00:00-03:00",
  "modificationDate": "2026-05-14T18:00:00-03:00"
}

Campo	Tipo	Descripción
id	int64	ID
accountType	enum	MAIN o SUB
cvu	string	CVU asignado
alias	string	Alias bancario
currencyCode	string	ISO 4217
status	enum	ACTIVE o DISABLED
lastSettlementDate	ISO 8601	Fecha de la última liquidación que entró a esta cuenta

Endpoints

Método	Path	Descripción
GET	/v1/current-accounts	Lista de cuentas del customer
GET	/v1/current-accounts/{id}	Detalle
GET	/v1/current-accounts/{id}/balances	Saldos desglosados
GET	/v1/current-accounts/{id}/movements	Movimientos

Listado

GET /v1/current-accounts

200 OK
X-Total-Count: 2

[
  {
    "id": 17,
    "accountType": "MAIN",
    "cvu": "0000000099887766554400",
    "alias": "distribuidora.demo.main",
    "currencyCode": "ARS",
    "status": "ACTIVE",
    "lastSettlementDate": "2026-05-14T18:00:00-03:00"
  },
  {
    "id": 18,
    "accountType": "SUB",
    "cvu": "0000000099887766554401",
    "alias": "distribuidora.demo.impuestos",
    "currencyCode": "ARS",
    "status": "ACTIVE",
    "lastSettlementDate": "2026-05-14T18:00:00-03:00"
  }
]

Filtros: accountType, status, ids, page, count.

Balances

GET /v1/current-accounts/17/balances

{
  "currentAccountId": 17,
  "currencyCode": "ARS",
  "totalBalance": 4567890.50,
  "balanceByWallet": {
    "CVU": 4500000.00,
    "CASH": 67890.50,
    "CVU_TAX": 0.00
  },
  "asOf": "2026-05-15T14:30:00-03:00"
}

Movimientos

Mismo modelo y filtros que en movimientos de cuentas recaudadoras. La principal diferencia es que en cuentas corrientes los movimientos crediticios suelen venir de liquidaciones internas (subtype: SETTLEMENT_IN) en lugar de transferencias externas.

GET /v1/current-accounts/17/movements?fromDate=2026-05-01&toDate=2026-05-31