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.

Endpoint

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

Headers

Header	Required	Description
`Auth`	Yes	Authentication credential
`X-Merchant-Ref`	Yes	Merchant reference

Request Body

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

Request Parameters

Parameter	Type	Required	Description
`user_ref`	string	Yes	Unique reference identifying the user.
`wallet_id`	string	Yes	Wallet 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

Field	Description
`status`	Indicates whether the request was successful.
`message`	Confirmation that the wallet was successfully bound for KYC billing.
`data.user_ref`	Reference of the user whose wallet was bound.
`data.wallet_id`	Wallet bound to the user for KYC billing.
`data.currency`	Currency of the bound wallet.