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
| 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. |
Updated 15 days ago
Did this page help you?
