Current accounts (MAIN/SUB)

Current accounts are the customer's operating accounts at Max Pay, where funds settled from receivable accounts accumulate. Unlike receivable accounts, they do not receive direct transfers from clients; they receive internal settlements.

Type	Description
MAIN	Customer's main account. Receives the bulk of settlements
SUB	Operating sub-accounts. Their usage depends on the customer's configuration

Read access and transfer origin

The current account itself is read-only via the API (it is not created or edited). It is, however, the funding source for outgoing and internal transfers. Other transactional operations (investments, etc.) are performed from the web panel.

Model

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

Field	Type	Description
id	int64	ID
accountType	enum	MAIN or SUB
cvu	string	Assigned CVU
alias	string	Banking alias
currencyCode	string	ISO 4217
status	enum	ACTIVE or DISABLED
lastSettlementDate	ISO 8601	Date of the last settlement that entered this account

Endpoints

Method	Path	Description
GET	/v1/current-accounts	List of customer accounts
GET	/v1/current-accounts/{id}	Detail
GET	/v1/current-accounts/{id}/balances	Itemized balances
GET	/v1/current-accounts/{id}/movements	Movements

List

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

Filters: 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"
}

Movements

Same model and filters as in receivable account movements. The main difference is that in current accounts, credit movements typically come from internal settlements (subtype: SETTLEMENT_IN) instead of external transfers.

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