Wallet - ON RAMP by Mesadepagos

The Wallet module creates wallets, adds blockchain assets, and retrieves available balances for the authenticated business.

Endpoints

Name	Method	Path
Create wallet	`POST`	`/v2/wallets`
List wallets	`GET`	`/v2/wallets`
Add asset to wallet	`POST`	`/v2/wallets/{id}/assets`
Retrieve wallet balance	`GET`	`/v2/wallets/{id}/balance`

Create a Wallet

POST /v2/wallets

The initial asset depends on the environment:

Environment	Initial asset
Sandbox	`USDC/Ethereum`
Production	`USDC/Polygon`

The following example applies to Sandbox.

{
  "walletName": "main_wallet"
}

Response

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

Assets in previously created wallets do not change. Before transferring funds, always use the blockchain returned by the API.

List Wallets

GET /v2/wallets

Response

The following example shows a wallet created in Sandbox. In Production, the initial asset uses Polygon.

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

Add an Asset to a Wallet

POST /v2/wallets/{id}/assets

{
  "symbol": "USDC",
  "blockchain": "Polygon"
}

Response

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

Retrieve a Wallet Balance

GET /v2/wallets/{id}/balance

Query Parameters

Parameter	Required	Description
`symbol`	No	Asset used to filter the balance.
`blockchain`	No	Blockchain used to filter balance.

Response

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

Crypto Deposits

Crypto deposits are sent directly to walletAddress using the asset and blockchain specified by the wallet.

Create or retrieve a wallet

Use POST /v2/wallets or GET /v2/wallets, then store walletId, walletAddress, symbol, and blockchain.

Transfer the asset

Send funds to walletAddress from a wallet in the same environment and on the specified blockchain.

Wait for confirmation

ON RAMP automatically records the deposit after confirmation and sends the result through a deposit_crypto webhook.

Retrieve the balance

Check the updated balance with GET /v2/wallets/{id}/balance.

Confirm whether you are using testnet or mainnet before transferring funds. Do not send real funds to a test address.

See the notification contract under crypto transaction webhooks.

​Endpoints

​Create a Wallet

​Response

​List Wallets

​Response

​Add an Asset to a Wallet

​Response

​Retrieve a Wallet Balance

​Query Parameters

​Response

​Crypto Deposits

Endpoints

Create a Wallet

Response

List Wallets

Response

Add an Asset to a Wallet

Response

Retrieve a Wallet Balance

Query Parameters

Response

Crypto Deposits