Wallet
Payees
Destinatarios: alta desde superficie de confianza.
Un payee es un destinatario (alias o CVU + titular). El proveedor de CVU resuelve el alias y devuelve
el titular real (toName / toLegalId) para validación y anti-fraude.
GET /api/v1/wallet/payees
POST /api/v1/wallet/payees
GET /api/v1/wallet/payees/{id}
DELETE /api/v1/wallet/payees/{id}El alta de payees es una superficie de confianza: se hace por la app web / sesión. Los agentes solo pueden pagar a payees existentes, no crearlos.
Listar GET
{
"data": [
{
"id": "pye_607182930a4b5c6d7e8f9001a2b3c4d5",
"label": "Proveedor principal",
"holderName": "Insumos SRL",
"cvu": "0000076500000098765432",
"alias": "insumos.srl",
"taxId": "30712345678",
"currency": "ARS",
"status": "active",
"createdAt": "2026-08-01T10:00:00.000Z",
"updatedAt": "2026-08-15T14:30:00.000Z"
}
]
}Crear POST (solo sesión web)
Body:
{
"label": "Proveedor principal",
"holder_name": "Insumos SRL",
"cvu": "0000076500000098765432",
"alias": "insumos.srl",
"tax_id": "30712345678",
"currency": "ARS"
}Devuelve 201 con el payee creado (mismo shape que el item de la lista).
Errores:
| Status | Body |
|---|---|
400 | { "error": "invalid_json" } |
400 | { "error": "<validation_code>", "message": "<detalle>" } |
401 | { "error": "web_session_required" } (una agent key no puede crear payees) |
404 | { "error": "not_found" } (en GET/DELETE por id) |
500 | { "error": "payee_creation_failed" } |
DELETE /payees/{id} devuelve { "deleted": true }.
En MCP:
wallet_list_payees.