Get Wallet By Currency

GET

/api/v1/merchants/wallet/{currency_code}

Get merchant wallet by currency code

Currency code is case-insensitive (e.g., USD, usd, Usd all work)

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Header Params

Responses

🟢200OK

application/json

Successful Response

Body

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/api/v1/merchants/wallet/ngn' \
--header 'x-api-key: <api-key>'

Response Example

200 - Success

{
    "data": {
        "id": "2d245db2-6a01-446f-808f-a414d45fbfc9",
        "merchant_id": "7bb54443-6fc9-4a1d-ab46-d787ec90c87f",
        "currency_id": "dd7fb8f3-c044-4dc5-a4ec-c0595a469876",
        "currency_name": "NGN",
        "holding_balance": 3200.0,
        "available_balance": 0.0,
        "settlement_hold": false,
        "settlement_hold_reason": null,
        "settlement_hold_visibility": null,
        "last_deposit_at": "2025-11-17T16:02:02.011257",
        "last_settlement_at": null,
        "last_payout_at": null,
        "status": "active",
        "created_at": "2025-11-11T15:38:38.385461",
        "updated_at": "2025-11-17T16:02:02.011263",
        "balance": 3200.0
    },
    "message": "Wallet retrieved successfully",
    "status": "success"
}

Modified at 2025-11-19 15:16:22

Update Wallet Status

Get Merchant Transactions