Recipients (address book)

A recipient is a saved account (CBU/CVU + alias) you transfer to frequently. The recipients address book spares you from re-entering the destination data on each transfer and reduces typos.

The address book is optional: you can transfer to an inline destination without saving it. But if you save it, you can later transfer by referencing its contactId.

Model

{
  "id": 540,
  "name": "Transportes del Sur S.R.L.",
  "cbuCvu": "0000000088776655443322",
  "alias": "transportes.del.sur.ars",
  "taxId": "30123456789",
  "entity": "MAX PAY",
  "creationDate": "2026-05-20T11:00:00-03:00",
  "modificationDate": "2026-05-20T11:00:00-03:00"
}

Field	Type	Description
id	int64	Recipient ID
name	string	Name/legal name of the recipient
cbuCvu	string	CBU or CVU of the recipient (22 digits)
alias	string	Bank alias of the recipient
taxId	string	Tax ID (CUIT/CUIL) of the recipient (11 digits without dashes)
entity	string	Destination entity (bank or wallet), reported by Max Pay

Endpoints

Method	Path	Description
GET	/v1/contacts	List the customer's address book
POST	/v1/contacts	Add a recipient
GET	/v1/contacts/{id}	Detail
PUT	/v1/contacts/{id}	Update a recipient
DELETE	/v1/contacts/{id}	Delete a recipient

Add a recipient

POST /v1/contacts
Idempotency-Key: dest-transportes-sur
Content-Type: application/json

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

cbuCvu or alias is enough; if you send only one, Max Pay fills in the other when resolving the destination. The entity is reported in the response.

201 Created
Location: /v1/contacts/540

{
  "id": 540,
  "name": "Transportes del Sur S.R.L.",
  "cbuCvu": "0000000088776655443322",
  "alias": "transportes.del.sur.ars",
  "taxId": "30123456789",
  "entity": "MAX PAY",
  "creationDate": "2026-05-20T11:00:00-03:00"
}

Duplicate recipient

Two recipients with the same CBU/CVU or the same alias are not allowed. A repeated creation returns 409 with duplicated-contact.

List the address book

GET /v1/contacts

200 OK
X-Total-Count: 2

[
  {
    "id": 540,
    "name": "Transportes del Sur S.R.L.",
    "cbuCvu": "0000000088776655443322",
    "alias": "transportes.del.sur.ars",
    "taxId": "30123456789",
    "entity": "MAX PAY"
  },
  {
    "id": 541,
    "name": "Proveedor Flete S.A.",
    "cbuCvu": "0000000011223344556677",
    "alias": "proveedor.flete",
    "taxId": "27999999993",
    "entity": "MAX PAY"
  }
]

Filters: taxId, alias, page, count.

Update and delete

PUT /v1/contacts/540
Content-Type: application/json

{
  "name": "Transportes del Sur SRL",
  "cbuCvu": "0000000088776655443322",
  "alias": "transportes.sur.nuevo",
  "taxId": "30123456789"
}

DELETE /v1/contacts/540

204 No Content

Deleting a recipient does not affect transfers already made to that destination: the destination remains recorded in each transfer.

Use a recipient in a transfer

Once saved, transfer by referencing its contactId and omitting destination. See Send transfers → To a recipient from the address book.