GuidesAPI Reference
Log In
Guides

Fund an Account

📘

Remember

Upon KYC completion for your Organization, that Organization will be automatically provisioned a Mural Account. You will not need to manually create one (unless you need multiple accounts per Organization).

Get Account details

To get the account details for funding, query for all accounts associated with your Organization.

Example request

curl --request GET \
     --url http://api.muralpay.com/api/accounts \
     --header 'accept: application/json' \
     --header 'authorization: Bearer $API-KEY' \
     --header 'on-behalf-of: 807742f0-e76c-44cd-bbe9-30b02e0060f4'

Example response

[
    {
        "id": "5d75e362-0812-4ea8-b203-c7c3a09f8473",
        "createdAt": "2025-04-05T03:31:00.360Z",
        "updatedAt": "2025-04-05T03:31:00.360Z",
        "name": "Main Account",
        "isApiEnabled": true,
        "status": "ACTIVE",
        "accountDetails": {
            "balances": [
                {
                    "tokenAmount": 0,
                    "tokenSymbol": "USDC"
                }
            ],
            "walletDetails": {
                "walletAddress": "0xD3AC55f624fe1430182E1937467BCe1Cf1B8d360",
                "blockchain": "POLYGON"
            },
            "depositAccount": {
                "id": "ed70754e-48f7-45bd-8632-54d122e1fc0d",
                "accountId": "5d75e362-0812-4ea8-b203-c7c3a09f8473",
                "status": "ACTIVATED",
                "currency": "USD",
                "bankBeneficiaryName": "Sun Tree Capital LLC",
                "bankBeneficiaryAddress": "123 Main St., Austin, TX 78730",
                "bankName": "Lead Bank",
                "bankAddress": "1801 Main St., Kansas City, MO 64108",
                "bankRoutingNumber": "101019644",
                "bankAccountNumber": "123456789",
                "paymentRails": [
                    "ACH_PUSH",
                    "WIRE"
                ]
            }
        }
    }
]

Fund the Account in Production

❗️

Fund using the correct token and blockchain

Please ensure you are sending the correct asset on the correct blockchain. Funds sent on the wrong chain will be irrecoverable. You can determine this by looking at blockchain and the tokenSymbol in the Account details

Now that you have the account details for an Organization, you can fund the accounts in two ways:

  • Via Stablecoins: Using the wallet address returned as walletAddress, you can deposit stablecoins from external wallet(s). No API calls are required to create deposits. The account will be credited as soon as the funds are confirmed / received.
  • Via Fiat: Using the virtual account details returned as the payinMethods array. Fiat will be converted to stablecoins upon receipt and automatically credited in your Account.

Fund the Account in our Sandbox

If you are operating within our Sandbox, you can fund your account with test net tokens. For more detail, please see our Sandbox Environment.


What’s Next