Kutanapay Merchant API
  1. Merchant Wallet
Kutanapay Merchant API
  • Merchant API Keys
    • Create Api Key
      POST
    • Get Api Keys
      GET
    • Revoke Api Key
      DELETE
  • Merchant Wallet
    • Get All Wallets
      GET
    • Get Wallet Transactions
      GET
    • Process Refund
      POST
    • Get Settlement Batches
      GET
    • Update Wallet Status
      PATCH
    • Get Wallet By Currency
      GET
  • Merchant Customer Transactions
    • Get Merchant Transactions
      GET
    • Get Merchant Transaction
      GET
  • Merchant Checkout
    • Create Checkout
      POST
    • List Checkouts
      GET
    • Get Checkout
      GET
  • Merchant Webhooks
    • Create Webhook
      POST
    • Get Webhooks
      GET
    • Update Webhook
      PUT
    • Delete Webhook
      DELETE
  • Merchant Branding
    • Get Branding
      GET
    • Update Branding
      PUT
  • Merchant Payment Accounts
    • Add Payment Account
      POST
    • Get Payment Accounts
      GET
    • Get Payment Account
      GET
    • Update Payment Account
      PUT
    • Delete Payment Account
      DELETE
  • Merchant Withdrawals
    • Initiate Withdrawal
    • Get Withdrawal History
    • Cancel Withdrawal
    • Get Withdrawal
  • Merchant Payouts
    • Initiate Payout
    • Get Payout History
    • Cancel Payout
    • Get Payout
  1. Merchant Wallet

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 Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/v1/merchants/wallet/ngn' \
--header 'x-api-key: <api-key>'
Response 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
Previous
Update Wallet Status
Next
Get Merchant Transactions
Built with