1. Build your token

You should build on your backend a jwt to use it to instantiate widget. This token will be used to authenticate voucher reservation. It should be signed with you apiSignature, available in your backoffice. It will only work one time.

Note: A list of jwt librabry is avaivalable here.

Token can be verified on

Build your JWT token

PHP sample :

//composer require firebase/php-jwt
use \Firebase\JWT\JWT;

$signature = "monApiSignature";
      "amount" => 100,                // Amount to convert
      "cp" => "75000",                // User's zipcode
      "age" => 40,                    // User's age
      "gender" => "M",                // User's gender (M ou F)
      "userId" => "u-1234",                // User's unique ID
      "iat" => time(),                // Timestamp in seconds
      "notificationKey" => "12345"    // A key generate by you allowing to identify transaction
$jwt = JWT::encode($criteria, $signature);

Ruby sample :

# sudo gem install jwt 

require 'jwt'

signature = "monApiSignature"

criteria =
criteria["amount"] = 100                # Amount to convert
criteria["cp"] = "75000"                # User's zipcode
criteria["age"] = 40                    # User's age
criteria["gender"] = "M"                # User's gender (M ou F)
criteria["userId"] = "u-1234"     # User's unique ID
criteria["iat"] =         # Timestamp in seconds
criteria["notificationKey"] = "12345"   # A key generate by you allowing to identify transaction

token = JWT.encode criteria, signature, 'HS256'

Node.js sample :

  npm install --save jsonwebtoken
var jwt=require('jsonwebtoken');

var signature = "myApiSignature";
var criteria={
      amount: 100,                       // Amount to convert
      cp: "75000",                       // User's zipcode
      age: 40,                           // User's age
      gender: "M",                       // User's gender (M ou F)
      userId: "u-1234",                       // User's unique ID
      iat: Math.round(,  // Timestamp in seconds
      notificationKey: "12345"           // A key generate by you allowing to identify transaction

var token=jwt.sign(criteria,signature);

2. Display offers

Display widget on your page

  1. Add a <div> to define where the widget will be displayed
    <div id="widget-jackpot"></div>
  2. Load widget's script
    <script src=""></script>
  3. Get your div container in a javascript object
    var container = document.getElementById('widget-jackpot');
  4. Get your JWT token
    var token="myJWTToken";
  5. Create a callback function. This will be called when your user will reserve a voucher.
    var cb=function(voucher){
  6. Add an options object
    var options={
  7. Widget init
    JckptWidget.init(container, token, null, cb, options);

For an asynchronous loading, your should use window.jckptAsyncInit function.

Complete code
        @media screen and (max-width: 540px) {
        @media screen and (min-width: 540px) {
        @media screen and (min-width: 768px) {
        @media screen and (max-width: 768px) {
            #jackpot .detail .informations {
                flex-direction: column-reverse;
                align-items: center;
    <div id="widget-jackpot"></div>
      // Function called on page loading
      window.jckptAsyncInit = function(){
        // Widget container element
        var container = document.getElementById('widget-jackpot');
        // token jwt
        var token="myJWTToken";
        // Callback called at voucher reservation
        var cb=function(voucher){
        // Customization options
        var options={
          useBrowserHistory: false,
        // Instantiate widget
        JckptWidget.init(container, token, null, cb, options);
    <!-- Async loading -->
    <script src="" async defer></script>

The callback function get as parameter voucher the confirmed coupon object

  "id":"d9708add-6307-418b-a3fc-8c82aa11c9a9",              // Voucher's id
  "state":"CONFIRMED",                                      // Voucher's state
  "value":110,                                              // Majored amount
  "initialAmount":150,                                      // Initial amount
  "reservationDate":"2017-06-24T15:27:32.502Z",             // Reservation date
  "validityDate":"2018-01-31T00:00:00.000Z",                // Voucher's expiration date
  "resaExpireDate":"2017-06-26T15:27:37.502Z",              // Reservation's expiration date
  "couponId":"AGYPMNVXPJ",                                  // Human friendly id (for support)
  "confirmDate":"2017-06-25T00:36:04.014Z",                 // Voucher's confirmation date
  "paymentState":"DUE",                                     // Voucher's payment state
  "customTransactionId":"monIdDeTransaction",               // Platform's transaction id
  "backUrl":"'",    // notification's url
  "walletOperationId":"Transfer.Id",                        // Wallet operation ID to Jackpot's wallet
  "sendDate":null,                                          // Voucher's send date
  "url":null                                                // PDF's url

Use public API

We've released a public API to allow our partners build their own interface to display our offers.

You can find a full description here

3. Manual voucher confirmatioon (Optionnal)

If your platform want to manually confirm voucher for security checks purpose, we offer your possibility to manual validate vouchers.

  1. Through our API, please contact our team to set up this feature.

  2. Through our admin interface in "Coupon en attente" section.