> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mesadepagos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet

> Creacion, administracion y consulta de wallets digitales.

El modulo Wallet permite crear wallets, agregar assets por blockchain y consultar balances disponibles para el business autenticado.

Los endpoints de Wallet en v3 mantienen los mismos parámetros y respuestas que en v2. Envía el JWT obtenido desde `POST /v3/auth/login` en el header `Authorization: Bearer {accessToken}`. Consulta [Autenticación](https://docs.mesadepagos.com/v3/auth.md) para obtener el token.

## Endpoints

| Nombre | Metodo | Ruta |
| - | - | - |
| Crear wallet | `POST` | `/v3/wallets` |
| Listar wallets | `GET` | `/v3/wallets` |
| Agregar asset a wallet | `POST` | `/v3/wallets/{id}/assets` |
| Consultar balance wallet | `GET` | `/v3/wallets/{id}/balance` |

## Crear wallet

```http theme={null}
POST /v3/wallets
```

El asset inicial depende del ambiente:

| Ambiente | Asset inicial |
| - | - |
| Sandbox | `USDC/Ethereum` |
| Producción | `USDC/Polygon` |

El siguiente ejemplo corresponde a Sandbox.

```json theme={null}
{
  "walletName": "main_wallet"
}
```

### Response

```json theme={null}
{
  "walletId": "550e8400-e29b-41d4-a716-446655440001",
  "status": "ACTIVE",
  "createdAt": "2026-05-12T12:00:00.000Z",
  "assets": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "walletAddress": "0x0000000000000000000000000000000000000000",
      "legacyAddress": null,
      "symbol": "USDC",
      "blockchain": "Ethereum"
    }
  ]
}
```

Los assets de wallets creadas anteriormente no se modifican. Antes de transferir fondos, utiliza siempre la blockchain informada en la respuesta de la API.

## Listar wallets

```http theme={null}
GET /v3/wallets
```

### Response

El siguiente ejemplo muestra una wallet creada en Sandbox. En Producción, el asset inicial utiliza `Polygon`.

```json theme={null}
{
  "wallets": [
    {
      "walletId": "550e8400-e29b-41d4-a716-446655440001",
      "status": "ACTIVE",
      "createdAt": "2026-05-12T12:00:00.000Z",
      "assets": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "walletAddress": "0x0000000000000000000000000000000000000000",
          "legacyAddress": null,
          "symbol": "USDC",
          "blockchain": "Ethereum"
        }
      ]
    }
  ]
}
```

## Agregar asset a wallet

```http theme={null}
POST /v3/wallets/{id}/assets
```

```json theme={null}
{
  "symbol": "USDC",
  "blockchain": "Polygon"
}
```

### Response

```json theme={null}
{
  "walletId": "550e8400-e29b-41d4-a716-446655440001",
  "status": "ACTIVE",
  "createdAt": "2026-05-12T12:00:00.000Z",
  "assets": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "walletAddress": "0x0000000000000000000000000000000000000000",
      "legacyAddress": null,
      "symbol": "USDC",
      "blockchain": "Polygon"
    }
  ]
}
```

## Consultar balance wallet

```http theme={null}
GET /v3/wallets/{id}/balance
```

### Query Params

| Parametro | Requerido | Descripcion |
| - | - | - |
| `symbol` | No | Asset para filtrar el balance. |
| `blockchain` | No | Blockchain para filtrar el balance. |

### Response

```json theme={null}
{
  "walletId": "550e8400-e29b-41d4-a716-446655440001",
  "balances": [
    {
      "assetId": "550e8400-e29b-41d4-a716-446655440000",
      "symbol": "USDC",
      "blockchain": "Polygon",
      "walletAddress": "0x0000000000000000000000000000000000000000",
      "balance": 100.5
    }
  ]
}
```

## Depósitos cripto

Los depósitos cripto se reciben directamente en `walletAddress`, usando el asset y la blockchain indicados en la wallet.

**1. Crear o consultar una wallet**

Usa `POST /v3/wallets` o `GET /v3/wallets` y guarda `walletId`,
`walletAddress`, `symbol` y `blockchain`.

**2. Transferir el asset**

Envía fondos a `walletAddress` desde una wallet del mismo ambiente y sobre
la blockchain indicada.

**3. Esperar la confirmación**

ON RAMP registra automáticamente el depósito después de su confirmación y
notifica el resultado mediante un webhook `deposit_crypto`.

**4. Consultar el balance**

Verifica el saldo actualizado con `GET /v3/wallets/{id}/balance`.

> [!WARNING]
>
> Confirma si estás utilizando testnet o mainnet antes de transferir fondos. No
> envíes fondos reales a una dirección de prueba.

Consulta el contrato de la notificación en [Webhooks de transacciones cripto](https://docs.mesadepagos.com/v3/webhooks.md#payloads-de-transacciones-cripto).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.