Register KYC Wallet for billing

Allows a merchant to bind a user's wallet to their KYC billing. The endpoint validates the user's tag and phone number, then associates the specified wallet with the user for KYC billing.

Only USDT or EUSD wallets can be mapped for now.

Please create the above wallets before mapping

Endpoint

POST {{base_url}}/api/v1/user/kyc/bill-wallet

Headers

HeaderRequiredDescription
AuthYesAuthentication credential
X-Merchant-RefYesMerchant reference

Request Body

{
  "user_ref": "UREFB71CBD5EE9BE4AEFB0A1587839EAD87D007IK",
  "wallet_id": "LBWUSDT:POLA470B92AB905406EB84230E2D90PU8"
}

Request Parameters

ParameterTypeRequiredDescription
user_refstringYesUnique reference identifying the user.
wallet_idstringYesWallet to be bound to the user for KYC billing.

Success Response

{
  "status": "success",
  "message": "Wallet bound for KYC billing",
  "data": {
    "user_ref": "UREF52EAF03D45714E47A65BF451969A29FB00CHN",
    "wallet_id": "LBWUSDT:POL1649B6B5F7524B3C9DE3618DFH61947200F2Y",
    "currency": "USDT:POL"
  }
}

Response Fields

FieldDescription
statusIndicates whether the request was successful.
messageConfirmation that the wallet was successfully bound for KYC billing.
data.user_refReference of the user whose wallet was bound.
data.wallet_idWallet bound to the user for KYC billing.
data.currencyCurrency of the bound wallet.

Did this page help you?