kamiPay LogokamiPay Docs
Account administration

Wallets

List the wallets available to your merchant account.

Wallets are pre-registered during onboarding and determine where USDt settlements are sent after a payment is received. Each checkout must be linked to one wallet. Use the endpoint below to retrieve your available wallets before creating a checkout.


List Wallets

GET /v2/merchants/wallets

Returns all wallets associated with your merchant account.

Example Request

const url = `${baseURL}/v2/merchants/wallets`

const response = await fetch(url, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${access_token}`,
  },
});
import requests

url = f"{base_url}/v2/merchants/wallets"

headers = {
  "Authorization": f"Bearer {access_token}",
}

response = requests.get(url, headers=headers)
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := baseURL + "/v2/merchants/wallets"

  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", fmt.Sprintf("Bearer %s", accessToken))

  client := &http.Client{}
  resp, err := client.Do(req)
  if err != nil {
    fmt.Println("Error making request:", err)
    return
  }
  defer resp.Body.Close()
}

Response

[
  {
    "merchant_id": 1,
    "wallet_id": 1,
    "wallet_desc": "Main wallet",
    "currency_id": 1,
    "address": "0x46d52020**********1fbdcc297d",
    "network_id": 1
  },
  {
    "merchant_id": 1,
    "wallet_id": 2,
    "wallet_desc": "Secondary wallet",
    "currency_id": 1,
    "address": "0x8fa31120**********3acde918f",
    "network_id": 1
  }
]
{
  "message": "Unauthorized",
  "request_id": "30e87ab5xxxxxxxxxxxxf8249f594cfb"
}
{
  "detail": "Internal Server Error"
}

Response Fields

FieldTypeDescription
merchant_idintegerYour merchant ID.
wallet_idintegerWallet identifier. Use this when creating a checkout.
wallet_descstringHuman-readable description of the wallet.
currency_idintegerCurrency associated with this wallet.
addressstringBlockchain address where settlements are sent.
network_idintegerBlockchain network identifier (e.g. Polygon).

On this page