Developers

See how Talon.One’s API works in a variety of programming languages in the API-sandbox.
You can change any select boxes you want in the requests section, to see how different data affects the responses. We set up a dedicated Talon deployment for this sandbox, so when you click “Send Request”, the data is sent and returned in real-time, exactly as it is for our customers.
You can also copy the curl command into your terminal to test the API on your own machine if you like.

#
Coupon Campaign
- This coupon campaign will return a discount relative to a value when the coupon (the customer enters) is valid. Which means:
  - the usage limit of the code has not been reached
  - the code is not expired
  - the code is not tied to another customer
  
  Please find the campaign by following this link:
  Coupon Campaign
  
  Username: readonly@talon.one
  Password: ReadOnly123
#
Free Gift Campaign
- If a customer has more than 3 items from the category “cosmetics” in the cart and a total cart value of more than €50, then add a gift.
  
  Please find the campaign by following this link:
  Free Gift Campaign
  
  Username: readonly@talon.one
  Password: ReadOnly123
#
Location-based Discount
- If a customer in "Berlin" books a flight in winter (Oct-Feb) to a country in the "Equatorial" category, and the flight costs at least 200€, then apply a 20% discount to their shopping cart.
  
  Please find the campaign by following this link:
  Location-based Campaign
  
  Username: readonly@talon.one
  Password: ReadOnly123
#
Referral Campaign
- If a customer refers a friend with a referral code, then the friend gets 50 game credits, and the advocate gains VIP access to the platform.
  
  Please find the campaign by following this link:
  Referral Campaign
  
  Username: readonly@talon.one
  Password: ReadOnly123
#
Loyalty - Collect points
- If a customer is registered in a loyalty program and drives a car 5 times for more than 5 minutes, then add 500 points to their Loyalty Wallet.
  
  Please find the campaign by following this link:
  Loyalty Campaign
  
  Username: readonly@talon.one
  Password: ReadOnly123
#
Loyalty - Spend points
- A customer converts their 500 points into 5€ credit, which is stored in their Wallet to use for future rentals.
  
  Please find the campaign by following this link:
  Loyalty Campaign
  
  Username: readonly@talon.one
  Password: ReadOnly123

Request

Bash
JS
Java
PHP
Python

curl -X PUT -H 'Content-Type: application/json' \
    -H 'Authorization: ApiKey-v1 953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676' \
    -d '{
    "coupon": "Coupon_10",
    "state": "open"
}' 'https://developerdocs.talon.one/v1/customer_sessions/TEST-SESSION-ID-Coupon'

var TalonOne = require('talon-one')
var applicationKey = '953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676'

var client = new TalonOne.IntegrationClient('https://developerdocs.talon.one', applicationKey)
var sessionId = 'TEST-SESSION-ID-Coupon'
client.updateCustomerSession({
  "coupon": "Coupon_10",
  "state": "open"
}, function (err, integrationState) {
  console.log(integrationState.profile)
  console.log(integrationState.session)
  console.log(integrationState.event)
});

import one.talon.api.*;
import one.talon.api.model.IntegrationState;
import one.talon.api.model.NewCustomerSession;

private static void updateSession(IntegrationApi api, NewCustomerSession session, final String sessionName) {
    try {
        IntegrationState response = api.updateCustomerSession(sessionName, session);
        System.out.println(response.toString());
    } catch (ApiException e) {
        System.out.println(e.getResponseBody());
        e.printStackTrace();
    }
}

public static void main(String[] args) {
    IntegrationApi integrationApi = new IntegrationApi();
    IntegrationApiClient integrationClient = integrationApi.getApiClient();
    integrationClient.setApplicationId("1");
          integrationClient.setApplicationKey("953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676");
          integrationClient.setBasePath("http://developerdocs.talon.one");
          
    NewCustomerSession session = new NewCustomerSession();
    session.setCoupon("Coupon_10");
    updateSession(integrationApi, session, "TEST-SESSION-ID-Coupon");
}

$t = new TalonOne();
$t->subdomain = "developerdocs";
$t->applicationKey = "953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676";

$acceptCoupon = function($response, $args) {
    $coupon = $args[0];
    echo "acceptCoupon $coupon: ".print_r($response,true);
};

$rejectCoupon = function($response, $args) {
    $coupon = $args[0];
    echo "rejectCoupon $coupon: ".print_r($response,true);
};

$setDiscount = function($response, $args) {
    // This is a good spot to update discount lines in the current cart
    $label = $args[0];
    $value = $args[1];
    echo "setDiscount: $label $value ".print_r($response,true);
};

$response = $t->put("customer_sessions/TEST-SESSION-ID-Coupon", array(
    'coupon'     => 'Coupon_10',
    'state'      => 'open'
));

if (!$response) {
    echo "Session update failed. Response: $response";
} else {
    // Register all effects you want to handle
    $t->processEffects($response, array(
        'acceptCoupon' => $acceptCoupon,
        'rejectCoupon' => $rejectCoupon,
        'setDiscount'  => $setDiscount)
    );
}

# Fill in the details of your Talon.One Application here

application_key = '953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676'

talon = integration.Client('https://developerdocs.talon.one',  application_key)

# When the customer adds an item to their cart

result = talon.update_customer_session("my_unique_session_id", {
    "state": "open",
    "coupon": "Coupon_10"
})

Request

Bash
JS
Java
PHP
Python

curl -X PUT -H 'Content-Type: application/json' \
    -H 'Authorization: ApiKey-v1 953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676' \
    -d '{
    "cartItems": [
        {
            "name": "Lipstick",
            "sku": "Z4522A12E",
            "quantity": selectable3,
            "price": 29.99,
            "category": "cosmetics"
        }
    ],
    "total": 89.97,
    "state": "open"
}' 'https://developerdocs.talon.one/v1/customer_sessions/lid4sh0bta8'

var TalonOne = require('talon-one')
var applicationKey = '953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676'

var client = new TalonOne.IntegrationClient('https://developerdocs.talon.one', applicationKey)
var sessionId = 'TEST-SESSION-ID-Coupon'
client.updateCustomerSession({
   "cartItems": [
        {
            "name": "Lipstick",
            "sku": "Z4522A12E",
            "quantity": selectable3,
            "price": 29.99,
            "category": "cosmetics"
        }
    ],
    "total": 89.97,
    "state": "open"
}, function (err, integrationState) {
  console.log(integrationState.profile)
  console.log(integrationState.session)
  console.log(integrationState.event)
});

import one.talon.api.*;
import one.talon.api.model.IntegrationState;
import one.talon.api.model.NewCustomerSession;

private static void updateSession(IntegrationApi api, NewCustomerSession session, final String sessionName) {
    try {
        IntegrationState response = api.updateCustomerSession(sessionName, session);
        System.out.println(response.toString());
    } catch (ApiException e) {
        System.out.println(e.getResponseBody());
        e.printStackTrace();
    }
}

public static void main(String[] args) {
    IntegrationApi integrationApi = new IntegrationApi();
    IntegrationApiClient integrationClient = integrationApi.getApiClient();
    integrationClient.setApplicationId("1");
          integrationClient.setApplicationKey("953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676");
          integrationClient.setBasePath("http://developerdocs.talon.one");
          
    NewCustomerSession session = new NewCustomerSession();
    session.setPayload( "cartItems": [
        {
            "name": "Lipstick",
            "sku": "Z4522A12E",
            "quantity": selectable3,
            "price": 29.99,
            "category": "cosmetics"
        }
    ],
    "total": 89.97,
    "state": "open");
    updateSession(integrationApi, session, "TEST-SESSION-ID-Coupon");
}

$t = new TalonOne();
$t->subdomain = "developerdocs";
$t->applicationKey = "953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676";

$acceptCoupon = function($response, $args) {
    $coupon = $args[0];
    echo "acceptCoupon $coupon: ".print_r($response,true);
};

$rejectCoupon = function($response, $args) {
    $coupon = $args[0];
    echo "rejectCoupon $coupon: ".print_r($response,true);
};

$setDiscount = function($response, $args) {
    // This is a good spot to update discount lines in the current cart
    $label = $args[0];
    $value = $args[1];
    echo "setDiscount: $label $value ".print_r($response,true);
};

$response = $t->put("customer_sessions/TEST-SESSION-ID-Coupon", array(
    'cartItems' => [
        {
            'name' => 'Lipstick',
            'sku' => 'Z4522A12E',
            'quantity' => selectable3,
            'price' => 29.99,
            'category' => 'cosmetics'
        }
    ],
    'total' => 89.97,
    'state' => 'open'
));

if (!$response) {
    echo "Session update failed. Response: $response";
} else {
    // Register all effects you want to handle
    $t->processEffects($response, array(
        'acceptCoupon' => $acceptCoupon,
        'rejectCoupon' => $rejectCoupon,
        'setDiscount'  => $setDiscount)
    );
}

# Fill in the details of your Talon.One Application here

application_key = '953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676'

talon = integration.Client('https://developerdocs.talon.one',  application_key)

# When the customer adds an item to their cart

result = talon.update_customer_session("my_unique_session_id", {
    "cartItems": [
        {
            "name": "Lipstick",
            "sku": "Z4522A12E",
            "quantity": selectable3,
            "price": 29.99,
            "category": "cosmetics"
        }
    ],
    "total": 89.97,
    "state": "open"
})

Request

Bash
JS
Java
PHP
Python

curl -X PUT -H 'Content-Type: application/json' \
    -H 'Authorization: ApiKey-v1 953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676' \
    -d '{
    "total": selectable210,
    "state": "open",
    "attributes": {
        "Destination_type": "Equatorial",
        "CurrentLocation": {
                "format": "point",
                "object": "13.427540899999999,52.4979898"
        }
    }
}' 'https://developerdocs.talon.one/v1/customer_sessions/o4k7hsy0haq'

var TalonOne = require('talon-one')
var applicationKey = '953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676'

var client = new TalonOne.IntegrationClient('https://developerdocs.talon.one', applicationKey)
var sessionId = 'TEST-SESSION-ID-Coupon'
client.updateCustomerSession({
    "total": selectable210,
    "state": "open",
    "attributes": {
        "Destination_type": "Equatorial",
        "CurrentLocation": {
                "format": "point",
                "object": "13.427540899999999,52.4979898"
        }
    }
}, function (err, integrationState) {
  console.log(integrationState.profile)
  console.log(integrationState.session)
  console.log(integrationState.event)
});

import one.talon.api.*;
import one.talon.api.model.IntegrationState;
import one.talon.api.model.NewCustomerSession;

private static void updateSession(IntegrationApi api, NewCustomerSession session, final String sessionName) {
    try {
        IntegrationState response = api.updateCustomerSession(sessionName, session);
        System.out.println(response.toString());
    } catch (ApiException e) {
        System.out.println(e.getResponseBody());
        e.printStackTrace();
    }
}

public static void main(String[] args) {
    IntegrationApi integrationApi = new IntegrationApi();
    IntegrationApiClient integrationClient = integrationApi.getApiClient();
    integrationClient.setApplicationId("1");
          integrationClient.setApplicationKey("953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676");
          integrationClient.setBasePath("http://developerdocs.talon.one");
          
    NewCustomerSession session = new NewCustomerSession();
    session.setPayload(  
        "total": selectable210,
        "state": "open",
        "attributes": {
            "Destination_type": "Equatorial",
            "CurrentLocation": {
                    "format": "point",
                    "object": "13.427540899999999,52.4979898"
            }
        }
    );
    updateSession(integrationApi, session, "TEST-SESSION-ID-Coupon");
}

$t = new TalonOne();
$t->subdomain = "developerdocs";
$t->applicationKey = "953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676";

$acceptCoupon = function($response, $args) {
    $coupon = $args[0];
    echo "acceptCoupon $coupon: ".print_r($response,true);
};

$rejectCoupon = function($response, $args) {
    $coupon = $args[0];
    echo "rejectCoupon $coupon: ".print_r($response,true);
};

$setDiscount = function($response, $args) {
    // This is a good spot to update discount lines in the current cart
    $label = $args[0];
    $value = $args[1];
    echo "setDiscount: $label $value ".print_r($response,true);
};

$response = $t->put("customer_sessions/TEST-SESSION-ID-Coupon", array(
    "total" => selectable210,
    "state" => "open",
    "attributes" => {
        "Destination_type" => "Equatorial",
        "CurrentLocation" => {
                "format" => "point",
                "object" => "13.427540899999999,52.4979898"
        }
    }
));

if (!$response) {
    echo "Session update failed. Response: $response";
} else {
    // Register all effects you want to handle
    $t->processEffects($response, array(
        'acceptCoupon' => $acceptCoupon,
        'rejectCoupon' => $rejectCoupon,
        'setDiscount'  => $setDiscount)
    );
}

# Fill in the details of your Talon.One Application here

application_key = '953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676'

talon = integration.Client('https://developerdocs.talon.one',  application_key)

# When the customer adds an item to their cart

result = talon.update_customer_session("my_unique_session_id", {
    "total": selectable210,
    "state": "open",
    "attributes": {
        "Destination_type": "Equatorial",
        "CurrentLocation": {
                "format": "point",
                "object": "13.427540899999999,52.4979898"
        }
    }
})

Request

Bash
JS
Java
PHP
Python

curl -X PUT -H 'Content-Type: application/json' \
    -H 'Authorization: ApiKey-v1 953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676' \
    -d '{
    "referral": "selectableEEUF-JQ45",
    "profileId": "friend",
    "state": "open"
}' 'https://developerdocs.talon.one/v1/customer_sessions/3lo3xxek1iu'

var TalonOne = require('talon-one')
var applicationKey = '953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676'

var client = new TalonOne.IntegrationClient('https://developerdocs.talon.one', applicationKey)
var sessionId = 'TEST-SESSION-ID-Coupon'
client.updateCustomerSession({
    "referral": "selectableEEUF-JQ45",
    "profileId": "friend",
    "state": "open"
}, function (err, integrationState) {
  console.log(integrationState.profile)
  console.log(integrationState.session)
  console.log(integrationState.event)
});

import one.talon.api.*;
import one.talon.api.model.IntegrationState;
import one.talon.api.model.NewCustomerSession;

private static void updateSession(IntegrationApi api, NewCustomerSession session, final String sessionName) {
    try {
        IntegrationState response = api.updateCustomerSession(sessionName, session);
        System.out.println(response.toString());
    } catch (ApiException e) {
        System.out.println(e.getResponseBody());
        e.printStackTrace();
    }
}

public static void main(String[] args) {
    IntegrationApi integrationApi = new IntegrationApi();
    IntegrationApiClient integrationClient = integrationApi.getApiClient();
    integrationClient.setApplicationId("1");
          integrationClient.setApplicationKey("953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676");
          integrationClient.setBasePath("http://developerdocs.talon.one");
          
    NewCustomerSession session = new NewCustomerSession();
    session.setPayload(  
        "referral": "selectableEEUF-JQ45",
        "profileId": "friend",
        "state": "open"
    );
    updateSession(integrationApi, session, "TEST-SESSION-ID-Coupon");
}

$t = new TalonOne();
$t->subdomain = "developerdocs";
$t->applicationKey = "953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676";

$acceptCoupon = function($response, $args) {
    $coupon = $args[0];
    echo "acceptCoupon $coupon: ".print_r($response,true);
};

$rejectCoupon = function($response, $args) {
    $coupon = $args[0];
    echo "rejectCoupon $coupon: ".print_r($response,true);
};

$setDiscount = function($response, $args) {
    // This is a good spot to update discount lines in the current cart
    $label = $args[0];
    $value = $args[1];
    echo "setDiscount: $label $value ".print_r($response,true);
};

$response = $t->put("customer_sessions/TEST-SESSION-ID-Coupon", array(
    "referral" => "selectableEEUF-JQ45",
    "profileId" => "friend",
    "state" => "open"
));

if (!$response) {
    echo "Session update failed. Response: $response";
} else {
    // Register all effects you want to handle
    $t->processEffects($response, array(
        'acceptCoupon' => $acceptCoupon,
        'rejectCoupon' => $rejectCoupon,
        'setDiscount'  => $setDiscount)
    );
}

# Fill in the details of your Talon.One Application here

application_key = '953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676'

talon = integration.Client('https://developerdocs.talon.one',  application_key)

# When the customer adds an item to their cart

result = talon.update_customer_session("my_unique_session_id", {
   "referral": "selectableEEUF-JQ45",
   "profileId": "friend",
   "state": "open"
})

Request

Bash
JS
Java
PHP
Python

curl -X PUT -H 'Content-Type: application/json' \
    -H 'Authorization: ApiKey-v1 953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676' \
    -d '{
    "attributes": {
        "Ride_duration": selectable10,
        "Ride_count": 6
    },
    "profileId": "loyaltyUser",
    "state": "open"
}' 'https://developerdocs.talon.one/v1/customer_sessions/0ugyhdcxnxgm'

var TalonOne = require('talon-one')
var applicationKey = '953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676'

var client = new TalonOne.IntegrationClient('https://developerdocs.talon.one', applicationKey)
var sessionId = 'TEST-SESSION-ID-Coupon'
client.updateCustomerSession({
   "attributes": {
        "Ride_duration": selectable10,
        "Ride_count": 6
    },
    "profileId": "loyaltyUser",
    "state": "open"
}, function (err, integrationState) {
  console.log(integrationState.profile)
  console.log(integrationState.session)
  console.log(integrationState.event)
});

import one.talon.api.*;
import one.talon.api.model.IntegrationState;
import one.talon.api.model.NewCustomerSession;

private static void updateSession(IntegrationApi api, NewCustomerSession session, final String sessionName) {
    try {
        IntegrationState response = api.updateCustomerSession(sessionName, session);
        System.out.println(response.toString());
    } catch (ApiException e) {
        System.out.println(e.getResponseBody());
        e.printStackTrace();
    }
}

public static void main(String[] args) {
    IntegrationApi integrationApi = new IntegrationApi();
    IntegrationApiClient integrationClient = integrationApi.getApiClient();
    integrationClient.setApplicationId("1");
          integrationClient.setApplicationKey("953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676");
          integrationClient.setBasePath("http://developerdocs.talon.one");
          
    NewCustomerSession session = new NewCustomerSession();
    session.setPayload(  
    "attributes": {
        "Ride_duration": selectable10,
        "Ride_count": 6
    },
    "profileId": "loyaltyUser",
    "state": "open");
    updateSession(integrationApi, session, "TEST-SESSION-ID-Coupon");
}

$t = new TalonOne();
$t->subdomain = "developerdocs";
$t->applicationKey = "953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676";

$acceptCoupon = function($response, $args) {
    $coupon = $args[0];
    echo "acceptCoupon $coupon: ".print_r($response,true);
};

$rejectCoupon = function($response, $args) {
    $coupon = $args[0];
    echo "rejectCoupon $coupon: ".print_r($response,true);
};

$setDiscount = function($response, $args) {
    // This is a good spot to update discount lines in the current cart
    $label = $args[0];
    $value = $args[1];
    echo "setDiscount: $label $value ".print_r($response,true);
};

$response = $t->put("customer_sessions/TEST-SESSION-ID-Coupon", array(
    "attributes" => {
        "Ride_duration" => selectable10,
        "Ride_count" => 6
    },
    "profileId" => "loyaltyUser",
    "state" => "open"
));

if (!$response) {
    echo "Session update failed. Response: $response";
} else {
    // Register all effects you want to handle
    $t->processEffects($response, array(
        'acceptCoupon' => $acceptCoupon,
        'rejectCoupon' => $rejectCoupon,
        'setDiscount'  => $setDiscount)
    );
}

# Fill in the details of your Talon.One Application here

application_key = '953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676'

talon = integration.Client('https://developerdocs.talon.one',  application_key)

# When the customer adds an item to their cart

result = talon.update_customer_session("my_unique_session_id", {
    "attributes": {
        "Ride_duration": selectable10,
        "Ride_count": 6
    },
    "profileId": "loyaltyUser",
    "state": "open"
})

Request

Bash
JS
Java
PHP
Python

curl -X PUT -H 'Content-Type: application/json' \
    -H 'Authorization: ApiKey-v1 953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676' \
    -d '{
    "attributes": {
        "Spending": true
    },
    "profileId": "loyaltyUser",
    "state": "open"
}' 'https://developerdocs.talon.one/v1/customer_sessions/oc217ikx5n'

var TalonOne = require('talon-one')
var applicationKey = '953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676'

var client = new TalonOne.IntegrationClient('https://developerdocs.talon.one', applicationKey)
var sessionId = 'TEST-SESSION-ID-Coupon'
client.updateCustomerSession({
    "attributes": {
        "Spending": true
    },
    "profileId": "loyaltyUser",
    "state": "open"
}, function (err, integrationState) {
  console.log(integrationState.profile)
  console.log(integrationState.session)
  console.log(integrationState.event)
});

import one.talon.api.*;
import one.talon.api.model.IntegrationState;
import one.talon.api.model.NewCustomerSession;

private static void updateSession(IntegrationApi api, NewCustomerSession session, final String sessionName) {
    try {
        IntegrationState response = api.updateCustomerSession(sessionName, session);
        System.out.println(response.toString());
    } catch (ApiException e) {
        System.out.println(e.getResponseBody());
        e.printStackTrace();
    }
}

public static void main(String[] args) {
    IntegrationApi integrationApi = new IntegrationApi();
    IntegrationApiClient integrationClient = integrationApi.getApiClient();
    integrationClient.setApplicationId("1");
          integrationClient.setApplicationKey("953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676");
          integrationClient.setBasePath("http://developerdocs.talon.one");
          
    NewCustomerSession session = new NewCustomerSession();
    session.setPayload(
        "attributes": {
            "Spending": true
        },
        "profileId": "loyaltyUser",
        "state": "open");
    updateSession(integrationApi, session, "TEST-SESSION-ID-Coupon");
}

$t = new TalonOne();
$t->subdomain = "developerdocs";
$t->applicationKey = "953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676";

$acceptCoupon = function($response, $args) {
    $coupon = $args[0];
    echo "acceptCoupon $coupon: ".print_r($response,true);
};

$rejectCoupon = function($response, $args) {
    $coupon = $args[0];
    echo "rejectCoupon $coupon: ".print_r($response,true);
};

$setDiscount = function($response, $args) {
    // This is a good spot to update discount lines in the current cart
    $label = $args[0];
    $value = $args[1];
    echo "setDiscount: $label $value ".print_r($response,true);
};

$response = $t->put("customer_sessions/TEST-SESSION-ID-Coupon", array(
    'attributes' => {
        'Spending' => true
    },
    'profileId' => 'loyaltyUser',
    'state' => 'open'
));

if (!$response) {
    echo "Session update failed. Response: $response";
} else {
    // Register all effects you want to handle
    $t->processEffects($response, array(
        'acceptCoupon' => $acceptCoupon,
        'rejectCoupon' => $rejectCoupon,
        'setDiscount'  => $setDiscount)
    );
}

# Fill in the details of your Talon.One Application here

application_key = '953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676'

talon = integration.Client('https://developerdocs.talon.one',  application_key)

# When the customer adds an item to their cart

result = talon.update_customer_session("my_unique_session_id", {
    "attributes": {
        "Spending": true
    },
    "profileId": "loyaltyUser",
    "state": "open"
})

Response

Effects

Full Response

Developer Documentation

Welcome to the Talon.One developer documentation. It provides guides, tutorials, SDKs and API reference documentation to help you integrate Talon.One.

What is Talon.One?

Talon.One is the world’s most flexible Promotion Engine. With it, you can create, manage and track coupon codes, discount campaigns, loyalty programs and referral rewards in one holistic system.

Talon.One empowers marketers to create effective campaigns and engineers to deliver a robust promotional infrastructure. Once you integrated with Talon.One, exchange data in real-time via API to trigger campaign effects or update third-party APIs.

Read more about the product in the end-user documentation, or start learning about how to integrate in Getting started.

Try out our interactive API sandbox

Developer newsletter

Sign up to the newsletter and keep your team in the loop about any changes made to Talon.One’s Integration process, the SDKs, APIs or Developer Documentation.

Documentation Updates

05.05.2021

Added some performance tips to the Integration checklist.

03.05.2021

Added the Creating a birthday promotion with Braze tutorial.

16.04.2021

Added the Events page.

30.03.2021

Added the Creating a giveaways program tutorial.

04.02.2021

Added the SSO with Okta tutorial
Improved the Creating custom coupons tutorial.

19.01.2021

Split the webhook tutorial page into 2 pages:
Getting started > Webhooks and Tutorial > Creating a webhook.

20.04.2020

Updated SDK overview page
Learn more
Updated API V2.0 overview page
Learn more

02.03.2020

Introducing API V2.0
Learn more

13.12.2019

New Integration API endpoint: Get the inventory items of a customer
Learn more

02.12.2019

New API Sandbox examples
Learn more

04.11.2019

We updated the UI of the developer documentation

15.10.2019

We updated Meta Responses
Learn more

20.09.2019

We are introducing API Keys as a new Integration API authentication method.
Learn more

Sitemap

Getting Started

Industries

Integration API

Management API

SDKs

Technology Partners

Tutorials

Was this article helpful?

Thank you! You have already voted

If you’d like a member of our support team to respond to you, please send a note to support@talon.one

Join Talon.One & meet Bobby