Custom Login Verification

Login verification allows you to integrate your own authentication layer into your webstore. Once you have setup player verification the webstore will ping an endpoint hosted on your own website with information about the player attempting to login.

Depending on your response you can deny/allow the customer from logging in and also enable sales, apply coupons automatically, or enable categories/packages.

The login verification system opens up a whole new world of opportunities for integrating with your own backend systems.

Please only use this feature if you know how to use it, incorrectly using this system (such as using a Discord webhook) will prevent players from logging in to your store.

How To Setup Player Verification

  1. Go to Integrations > Webhooks.

  2. Enter the full URL of your endpoint in the login webhooks config box, for example http://example.com/tebex/verification.php. You can use any programming language to create your endpoint as long as it returns the response as listed below.

Accepting Notifications And Returning A Response

Example Request

When a customer attempts to login to your webstore we will send a GET request request to the URL you have previously set as outlined above. An example request URL would look like the following: ​

http://example.com/tebex/verification.php?ign=Notch&ip=127.0.0.1&country=US

Request Query Parameters

  1. ign - The username of the customer attempting to login.

  2. ip - The IP address of the customer attempting to login.

  3. country - The country code of the customer (Based from GEO locating their IP address).

Example Response

To allow the customer to login based on the provided query parameters you need to return a JSON response such as the following example: ​

{
"verified":true,
"message":"An optional message to send to the customer upon login. This field is optional."
}

​ If you don't want to allow the customer to login you can return a JSON response such as: ​

{
"verified":false,
"error":"You are not allowed to access our webstore."
}

Applying Changes To The Webstore/Basket Upon Login

The login verification feature also allows you to make changes to the webstore or basket upon login such as the following:

  1. Apply a sale that otherwise would be inactive.

  2. Automatically apply a coupon code.

  3. Allow the customer to view a category or package that otherwise would be disabled.

Just return the following JSON object. Each additional element is completely optional (For example you might only want to apply a coupon and not enable a category). ​

{
"verified":true,
"actions":{
"enable_sales":[
6
],
"apply_coupons":[
"HIDDENCODE", "ANOTHERCODE"
],
"enable_categories":[
103
],
"enable_packages":[
242
]
}
}

I'm not a developer! Help!

We understand not everyone understands the world of programming, and if that's the case we recommend reaching out to a contractor who understands what they're doing. Just send them this article and it'll include enough information for them to develop you a custom system.