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 All Wallets

GET
/api/v1/merchants/wallet
Get all merchant wallets

Request

Authorization
Add parameter in header
x-api-key
Example:
x-api-key: ********************
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' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Success
{
    "data": [
        {
            "id": "520331dd-4825-43cf-b31c-248d873ea07d",
            "merchant_id": "7bb54443-6fc9-4a1d-ab46-d787ec90c87f",
            "currency_id": "c13fc2db-d8c5-4786-be67-bca9fb22781d",
            "currency_name": "USD",
            "holding_balance": 3725.0,
            "available_balance": 0.0,
            "settlement_hold": false,
            "settlement_hold_reason": null,
            "settlement_hold_visibility": null,
            "last_deposit_at": "2025-11-17T16:01:28.916159",
            "last_settlement_at": null,
            "last_payout_at": null,
            "status": "active",
            "created_at": "2025-11-11T15:38:38.379166",
            "updated_at": "2025-11-17T16:01:28.916171",
            "balance": 3725.0
        },
        {
            "id": "43923168-8009-46c2-98a8-d276b330c065",
            "merchant_id": "7bb54443-6fc9-4a1d-ab46-d787ec90c87f",
            "currency_id": "bcee4c44-2cf8-43ae-b231-b519b93c5f76",
            "currency_name": "GHS",
            "holding_balance": 300.0,
            "available_balance": 0.0,
            "settlement_hold": false,
            "settlement_hold_reason": null,
            "settlement_hold_visibility": null,
            "last_deposit_at": "2025-11-17T16:23:16.800086",
            "last_settlement_at": null,
            "last_payout_at": null,
            "status": "active",
            "created_at": "2025-11-11T15:38:38.381446",
            "updated_at": "2025-11-17T16:23:16.800097",
            "balance": 300.0
        },
        {
            "id": "1fe71d01-145e-4a0a-99f3-9840ea83344d",
            "merchant_id": "7bb54443-6fc9-4a1d-ab46-d787ec90c87f",
            "currency_id": "9348cdf0-33bc-440b-9565-35debc98d545",
            "currency_name": "EUR",
            "holding_balance": 2000.0,
            "available_balance": 0.0,
            "settlement_hold": false,
            "settlement_hold_reason": null,
            "settlement_hold_visibility": null,
            "last_deposit_at": "2025-11-13T12:23:52.121958",
            "last_settlement_at": null,
            "last_payout_at": null,
            "status": "active",
            "created_at": "2025-11-11T15:38:38.382994",
            "updated_at": "2025-11-13T12:23:52.121979",
            "balance": 2000.0
        },
        {
            "id": "321e01dd-8026-4590-82bd-d7c998ea01da",
            "merchant_id": "7bb54443-6fc9-4a1d-ab46-d787ec90c87f",
            "currency_id": "e7a83f89-9892-410b-9abc-6d2da623593f",
            "currency_name": "GBP",
            "holding_balance": 0.0,
            "available_balance": 0.0,
            "settlement_hold": false,
            "settlement_hold_reason": null,
            "settlement_hold_visibility": null,
            "last_deposit_at": null,
            "last_settlement_at": null,
            "last_payout_at": null,
            "status": "active",
            "created_at": "2025-11-11T15:38:38.383920",
            "updated_at": "2025-11-11T15:38:38.383920",
            "balance": 0.0
        },
        {
            "id": "3a76faf2-15fc-4704-b26f-dcf5f9a509ab",
            "merchant_id": "7bb54443-6fc9-4a1d-ab46-d787ec90c87f",
            "currency_id": "b4657ed9-13e8-4a3a-9400-47bf3256db74",
            "currency_name": "KES",
            "holding_balance": 0.0,
            "available_balance": 0.0,
            "settlement_hold": false,
            "settlement_hold_reason": null,
            "settlement_hold_visibility": null,
            "last_deposit_at": null,
            "last_settlement_at": null,
            "last_payout_at": null,
            "status": "active",
            "created_at": "2025-11-11T15:38:38.384710",
            "updated_at": "2025-11-11T15:38:38.384710",
            "balance": 0.0
        },
        {
            "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
        },
        {
            "id": "71e74c51-b95f-4d89-8613-f0abe1c21992",
            "merchant_id": "7bb54443-6fc9-4a1d-ab46-d787ec90c87f",
            "currency_id": "3a356ceb-e801-4af6-8905-c566eb00856e",
            "currency_name": "ETB",
            "holding_balance": 0.0,
            "available_balance": 0.0,
            "settlement_hold": false,
            "settlement_hold_reason": null,
            "settlement_hold_visibility": null,
            "last_deposit_at": null,
            "last_settlement_at": null,
            "last_payout_at": null,
            "status": "active",
            "created_at": "2025-11-11T15:38:38.386387",
            "updated_at": "2025-11-11T15:38:38.386387",
            "balance": 0.0
        }
    ],
    "message": "Wallets retrieved successfully",
    "status": "success"
}
Modified at 2025-10-16 13:16:45
Previous
Revoke Api Key
Next
Get Wallet Transactions
Built with