How to Verify Actions on Your Website with Callback Verification

If you host a giveaway, you might want to learn how to optimize the performance of your campaign, and gain leads and traffic.

Why Callback Verification?

With callback verification, you can get users to do tasks on your website such as sign up, deposit, purchase, clicks and everything else. It is VERIFIABLE regardless of the tasks. It is possible to add multiple tasks to the same website, as well as to use multiple websites.

Please follow the steps to set up the task and to integrate API callback.

Step 1

To verify the task, you will need to enable Callback verification first.

Step 2

To let participants know what the task is, choose one or more tasks and give them a name as a description. Single task: e.g. Choose Sign up as your website task and describe what you would like the user to do as the Task Name.

Multiple tasks: e.g. Choose Sign up and Play Game as your website tasks and describe what you would like the user to do as the Task Name.

Custom tasks: Moreover, it is also possible to customize tasks and add relevant required amount.


e.g. You create a task: like 3 articles in your website


Then your custom tasks will appear as follows:

Step 3

Then, you need to obtain url search params (e.g. track_id=U$MikHklwcY&sign_up=true&invite=true) from your website and parse out the trackId.

🔸About Track_Id:

  • Track_Id is necessary to detect the user's participation in the task and to verify it. We will detect when a user clicks to participate in the task, the ?track_id={{ track_id }} will be used for detection.

  • You will see the ?track_id={{ track_id }} applied to your website link:

If your website link is

the visitors may come to your site via the link:

Step 4

Please copy the API key we provide you to integrate it with your website.

Then enter the parameters according to the rules of const data, and encrypt the whole const data using the standard HmacSHA256 algorithm..

Note: remark is optional. You may omit it if you do not require it.

Step 5

Use our official API below and pass the corresponding parameters in the following code.

Official API: https://cwallet.com/public/v1/giveaway/task/callback

const api_key =
      "3lhpTSAJd6XDgBe4XWcozob4iMmYUlkPc9c4fwnoydGk4Bh5lSA3qrSiqgXeJcX7"; // your api_key

    const { track_id, send } = queryString.parse(window.location.search); // url search

    const remark = "remark"; // optional

    const data = `track_id=${track_id}&event=${send}&remark=${remark}`; // optional
    
    const sign = crypto.HmacSHA256(data, api_key).toString(); // HmacSHA256

    fetch("https://cwallet.com/public/v1/giveaway/task/callback", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        track_id,
        sign,
        event: send,
        remark,
      }),
    }).then(async (res) => {
      console.log(await res.json());
    });

Step 6

Upon successful completion of the above steps, you may click on the Check API callback to test it.

Note:

Each project you created on Cwallet Giveaway Tool will have a unique API key, and it will not change. So you only need to integrate once for a website. Also, you will be able to create tasks on multiple websites if you need to.

Last updated