Developer | Studza.se

Hi Developer!

For full access to our developer site, please visit this page on a larger screen.

Thank you!

For full access to our developer site, please visit this page on a larger screen.

Thank you!

Hi Developer!

This is a user guide on how to integrate our product at your site.

For full access to our developer site, please visit this page on a desktop.

See you on a larger screen!

Technical Guide For Implementing - Studza App

The Studza App allows your customers to win back the amount of their purchase on your website. To ensure a smooth experience, we recommend loading the app only after the purchase is completed.

You can choose to load the Studza App automatically upon page load or trigger it via a button or link (e.g., on the purchase confirmation page). Implementation flexibility allows you to integrate it according to your website’s needs.

Follow the instructions below to prepare your website for embedding the Studza App.

Description of parameters:

Parameter name	Mandatory	Description
show_second_toggle	Y	This should always be set to "true". If you set it to false the user will not be able to approve for us to do analytics on their purchase.
appScreen	Y	Is used to start the Studza app in mobile or desktop mode. If mobile you send "true" and if not mobile you send "false"
callbackGameFinished	N	JavaScript function to be called when the purchase of the Studza lottery ticket is done. You can use this to perform an action on your website when the ticket purchase is completed (e.g., add/remove certain buttons).
callbackUrl	N	REST endpoint with basic auth. The app will POST: { "orderid": "<customerOrderRef>" }. Used for actions like sending confirmation emails when a Studza ticket is bought. Most reliable method as it's triggered server-side, even if the user closes the page early.
apiURL	Y	This should always have the same value. You get this from Studza together with the information you need to start the app.
winAmount	Y	This is the order amount and also the amount the customer can win in the lottery.
phone	N	If empty, the customer must enter this information in the app before starting payment with Swish.
email	N	Needed if you want Studza to send an email directly to your customers.
customerNo	N	The customer identifier in your system. Not needed if you can use customerOrderRef to identify the customer.
customerOrderRef	Y	Main identifier for the purchase (for example, order number). This must be a unique value for each purchase. With this value, you should be able to find the purchase (and the customer) for the current purchase in your system

Embedding Guide

Before you begin, ensure you have the following credentials provided by Studza:

· JAVASCRIPT_URL

· API_KEY

· USER_ID

· API_URL

To integrate Studza, include the provided JavaScript URL in your HTML and set up an event listener before loading the script.

Implementation Example

Insert the following code inside the <body> section of your page where the Studza App should be loaded:

Notes

Ensure that you add the event listener before loading the JavaScript file to prevent errors.
Replace placeholder values (<USER_ID>, <API_KEY>, etc.) with actual credentials.
The success event triggers when the transaction is completed successfully.

For any issues or further customization, refer to the Studza API documentation or contact our support team.

Need Help? If you encounter any issues, reach out to our developer support at support@studza.com.