User Wallet Verification API Documentation

Overview

This API allows you to verify a user's wallet information by querying their user ID. It checks the wallet against the provided referral code and indicates whether the verification task is completed. Rewards are only provided if the user is verified as "yes".

Base URL

https://partner-verify-taskdata.pencho.com/

Endpoint

GET /?userid={userid}

Parameters

Parameter	Type	Description
userid	string	The unique ID of the user you want to verify.

Query Example

GET https://partner-verify-taskdata.pencho.com/?userid=2059563305

Response

Success Response

If the request is successful, the API will return a JSON object with the following structure:

{
  "wallet": "1020552739",

  "referredBy": null,

  "username": "Rahul",

  "status": "success",

  "verified": "yes"
}

Fields

Field	Type	Description
wallet	string	The wallet ID associated with the user.
referredBy	string	The referral code that referred this user (can be null). Cross-verify this value with your referral code.
username	string	The name of the user.
status	string	Indicates the status of the request (e.g., "success").
verified	string	Indicates if the task is completed ("yes") or not ("no").

Example Response

{
  "wallet": "1020552739",

  "referredBy": null,

  "username": "Rahul",

  "status": "success",

  "verified": "yes"
}

Reward Eligibility

If verified is "yes": The user is eligible for rewards. Ensure to process the reward for this user.

If verified is "no": The user is not eligible for rewards, as they have not completed the task.

Cross-verify the referredBy value: Ensure it matches your referral code. If it does not match, it means someone else referred this user.

Error Response

In case of an error (e.g., user not found, invalid request), the API will return an error message. The structure is as follows:

{
  "status": "error",

  "message": "User not found"
}

Fields

Field	Type	Description
status	string	Indicates the status of the request (e.g., "error").
message	string	A description of the error.

Example Error Response

{
  "status": "error",

  "message": "User not found"
}

Notes

Ensure the userid is valid and exists in the system for a successful response.

The verified field indicates whether the user has completed the referral task. A value of "yes" means the task is completed, while "no" means the user started but has not completed the task.

Rewards should only be issued to users with a verified status of "yes".

Conclusion

This API provides a straightforward way to verify user wallet information based on their unique user ID and indicates the completion status of referral tasks. Ensure to check the verified status to determine reward eligibility.