Destinatarios (agenda)

Un destinatario es una cuenta guardada (CBU/CVU + alias) a la que transferís con frecuencia. La agenda de destinatarios te evita reingresar los datos del destino en cada transferencia y reduce errores de tipeo.

La agenda es opcional: podés transferir a un destino inline sin guardarlo. Pero si lo guardás, después transferís referenciando su contactId.

Modelo

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

Campo	Tipo	Descripción
id	int64	ID del destinatario
name	string	Nombre/razón social del destinatario
cbuCvu	string	CBU o CVU del destinatario (22 dígitos)
alias	string	Alias bancario del destinatario
taxId	string	CUIT/CUIL del destinatario (11 dígitos sin guiones)
entity	string	Entidad del destino (banco o billetera), informada por Max Pay

Endpoints

Método	Path	Descripción
GET	/v1/contacts	Listar la agenda del customer
POST	/v1/contacts	Agregar un destinatario
GET	/v1/contacts/{id}	Detalle
PUT	/v1/contacts/{id}	Actualizar un destinatario
DELETE	/v1/contacts/{id}	Eliminar un destinatario

Agregar un destinatario

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

Alcanza con cbuCvu o alias; si enviás solo uno, Max Pay completa el otro al resolver el destino. La entity se informa en la respuesta.

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

Destinatario duplicado

No se permiten dos destinatarios con el mismo CBU/CVU o el mismo alias. Un alta repetida devuelve 409 con duplicated-contact.

Listar la agenda

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

Filtros: taxId, alias, page, count.

Actualizar y eliminar

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

Eliminar un destinatario no afecta las transferencias ya realizadas hacia ese destino: el destination queda registrado en cada transferencia.

Usar un destinatario en una transferencia

Una vez guardado, transferí referenciando su contactId y omitiendo destination. Ver Enviar transferencias → A un destinatario de la agenda.