Create Wallets for your EPM accounts over API

The initial step in crafting an embedded experience involves creating a wallet for your Embedded Partner Merchant (EPM). By utilizing the API call detailed below, you can empower your EPM to establish a wallet for each asset type. This provision allows your EPM to have a permanent address for receiving crypto or fiat currencies when transferring funds from other platforms.

❗️

Executing API calls on behalf of your Merchant

It's crucial to include your EPM's x-account-reference in the API call headers to ensure you're conducting transactions on behalf of the correct account, rather than the Embedded Partner (EP) account.

For this process, we'll utilize the Create Wallet endpoint provided by the API.

Below are the details required to create a wallet for your EPM:

Example Request

Here is an example request for creating a wallet via the API:

{
     "currency": "ETH",
     "description": "ETH wallet"
}

Example Response

Once you've sent the request for creating the wallet, you should receive the following example response:

{
  "id": 313675,
  "description": "ETH wallet",
  "currency": {
    "id": 1773,
    "code": "ETH",
    "fiat": true,
    "icon": null,
    "name": "Ethereum",
    "withdrawalParameters": [],
    "options": {},
    "withdrawalFee": 0.4,
    "depositFee": 0,
    "supportsDeposits": true,
    "supportsWithdrawals": true,
    "quantityPrecision": 2,
    "pricePrecision": 2,
    "protocols": []
  },
  "supportsWithdrawals": true,
  "supportsDeposits": true,
  "custodianWallet": false,
  "protocol": ETH,
  "address": "0xEa61651823dEc1027565AFB908A0c5C06662cdBf",
  "lookup": null,
  "balance": 0,
  "available": 0,
  "withdrawalFee": 0,
  "depositFee": 0,
  "alternatives": null,
  "approxAvailable": "0",
  "approxBalance": "0"
}

Important Response Fields to Note:

The id from this response is essential for the subsequent step of creating a Merchant ID, facilitating the association between merchant activities and their designated wallet.