Login Webhooks

Login verification allows you to integrate your own authentication layer into your webstore. Once you have set up player verification the webstore will ping an endpoint hosted on your own website with information about the player attempting to log in. Depending on your response you can deny/allow the customer from logging in.

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 customers from logging in to your store.

How To Setup Player Verification

  1. Go to 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 log in to your webstore we will send a GET 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 log in.

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

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

Example Response

To allow the customer to log in 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."
}

Last updated