Retiro y fondeo

Retiro

POST /api/v1/wallet/withdraw

Retira fondos de la wallet a un destino externo (CBU/CVU/alias). Requiere KYC aprobado. El amount va en unidades.

Body:

{
  "amount": 5000.00,
  "destination": "0000076500000098765432",
  "concept": "Retiro a cuenta propia"
}

Respuesta 200: el débito es optimista y la transferencia queda pending hasta que el webhook del proveedor confirma el estado terminal.

{
  "ok": true,
  "approvalId": "a1b2c3d4-e5f6-4718-2930-a4b5c6d7e8f9",
  "settlement": "pending",
  "providerRef": "txn_ext_5f60718293a4b5c6",
  "balance": 10000.50
}

Errores:

Status	Body
`400`	`{ "error": "invalid_amount" }`
`400`	`{ "error": "missing_destination" }`
`401`	`{ "error": "unauthorized" }`
`403`	`{ "error": "no_cardholder" }`
`403`	`{ "error": "kyc_required", "kycStatus": "pending" }`
`422`	`{ "error": "<payout_error>" }` (el riel rechazó el payout)

Fondeo

GET  /api/v1/wallet/fund-info
POST /api/v1/wallet/fund

fund-info devuelve los datos para fondear el CVU. La inyección de fondos la resuelve el proveedor de CVU. Ver Guardar y fondear.

Respuesta 200 de fund-info:

{
  "cvu": "0000076500000012345678",
  "alias": "joe.argentive",
  "holder_name": "Joe Castro",
  "tax_id": "20123456789",
  "rails": ["cvu", "transferencias-3.0"]
}

Sin sesión → 401 unauthorized.

En MCP: wallet_fund_info.

Retiro

Fondeo

On this page