THNDR SDK
  • Introduction
  • Integration
    • Configure SDK
    • Authenticate Users
    • Debit & Credit Users
    • Go Live
  • Customisation
    • Styling
  • Github
    • THNDR SDK
  • Demos
    • Blackjack
    • Blocks
    • Solitaire
Powered by GitBook
On this page
  • Configuration
  • Callbacks
  • Example Code Overview
  1. Integration

Configure SDK

PreviousIntroductionNextAuthenticate Users

Last updated 15 days ago

This script integrates the THNDR SDK into your web app, enabling secure communication between your parent window and the embedded iframe.

All interactions with your users balances are made via server to server APIs

Below is a brief overview of the callbacks and configuration.

Configuration

Pass in the following query params into the Iframe url to configure the app.

  • operatorId: This ID will be provided to you by THNDR

  • gameId: 'solitaire', 'blocks' or 'blackjack'

  • language: Two-letter country code. If language is not supported, defaults to English.

Callbacks

The SDK requires two key callback functions, each responsible for handling specific actions within the THNDR Iframe.

  • getToken: Returns the authentication token for the user.

  • getBalance: Retrieves the user's balance from your system and return it to the THNDR Iframe for display.

  • handleError: Will return client safe errors returned from the

  • analyticsEvent: Returns events that occur in the iframe, should it be required to capture these for your own analytics

  • closeIframe: The host application should close the webview hosting the iframe. This means the user indicated they want to close the game.

Example Code Overview

The code integrates the THNDR SDK with the specified configuration and callbacks:

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>THNDR</title>
  </head>
  <body>
    <iframe 
      src="https://embed-sandbox.clinch.gg?operatorId=operator_id&gameId=solitaire&language=en" 
      id="games_iframe"
      style="position:fixed; top:0; left:0; bottom:0; right:0; width:100%; height:100%; border:none; margin:0; padding:0; overflow:hidden; z-index:999999;">
        Your browser doesn't support iframes
    </iframe>
    <script type="module">
      import { enableLogging, demoBalance, initGame, analyticsEvent, cancelInvoice } from '/thndr-sdk.js';
        
      function async getToken() {
        console.log("THNDR SDK: Get the server to server thndr authentication token");
        return "eyJhbGciOiJSUzI1NiIsInR5cC...";
      }
    
      function async getBalance() {
        return {
          balance: 100, // $1.00
          currency: "cents", // Must be either - sats, btc, or cents (USD)
        };
      }
      
      function async handleError(error) {
        console.log("Error code", error.code);
        return false;
      }

      function async analyticsEvent(name) {
        console.log("Analytics event:", name);
      }
      
      function closeIframe() {
        console.log("Close the iFrame");
      }
      
      //enableLogging(); // Optional, enable logging for debugging
    
      initGame(
        "games_iframe",
        "https://embed-sandbox.clinch.gg",
        getToken,
        getBalance,
        closeIframe,
        handleError,
      );
    </script>
  </body>
</html>

pay request