Triple White Label UI
User Authentication

5min
When taking advantage of the Triple White Label UI, it is necessary to authenticate the end user (customer) with Triple in order for the platform provide adequate targeting & personalization, and to track offer activations.
As a Publisher you will have to implement the following flow to be executed when a customer is passed to the Triple White Label UI.
Step 1 - Requesting a partner token
You will have to request a Triple Partner Token using the specific client_id and client_secret provided by Triple. 
You can obtain a Triple Partner Token by making a x-www-form-urlencoded POST request to either:
Sandbox: https://auth.sandbox.tripleup.dev/oauth2/token﻿
Production: ﻿﻿https://auth.tripleup.dev/oauth2/token﻿﻿﻿
The complete procedure is detailed in the Getting Started Overview - Step 1: Perform Authentication section.﻿
Step 2 - Initiate a user session
After obtaining the Triple Partner Token, you will have to create a session token specific to the user.
You can obtain the User Session Token by making a POST request to either:
Sandbox: https://ui-api.partners.sandbox.tripleup.dev/initiate-session﻿
Production: https://ui-api.tripleup.dev/initiate-session﻿
Using Triple card_account_id
Using external_card_account_id
Response
Curl
curl --location 'https://ui-api.partners.sandbox.tripleup.dev/initiate-session

' \
--header 'Authorization: Bearer my_triple_partner_token' \
--header 'Content-Type: application/json' \
--data '{
    "card_account_id": "triple'\''s card_account_id",
    "token_expiry_duration": 60, 
    "default_postal_code": "90210" 
}'
curl --location 'https://ui-api.partners.sandbox.tripleup.dev/initiate-session

' \
--header 'Authorization: Bearer my_triple_partner_token' \
--header 'Content-Type: application/json' \
--data '{
    "card_account_id": "triple'\''s card_account_id",
    "token_expiry_duration": 60, 
    "default_postal_code": "90210" 
}'
﻿
Curl
curl --location 'https://ui-api.partners.sandbox.tripleup.dev/initiate-session

' \
--header 'Authorization: Bearer my_triple_partner_token' \
--header 'Content-Type: application/json' \
--data '{
    "card_account_external_id": "the publisher-set card account id",
    "card_program_external_id": "the publisher-set card program id",
    "token_expiry_duration": 60, 
    "default_postal_code": "90210" 
}'
curl --location 'https://ui-api.partners.sandbox.tripleup.dev/initiate-session

' \
--header 'Authorization: Bearer my_triple_partner_token' \
--header 'Content-Type: application/json' \
--data '{
    "card_account_external_id": "the publisher-set card account id",
    "card_program_external_id": "the publisher-set card program id",
    "token_expiry_duration": 60, 
    "default_postal_code": "90210" 
}'
﻿
JSON
{
    "baseUrl": "{{link_to_white_label_app}}",
    "redirectUrl": "{{link_to_white_label_app}}?token={{token}}",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
{
    "baseUrl": "{{link_to_white_label_app}}",
    "redirectUrl": "{{link_to_white_label_app}}?token={{token}}",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
﻿
Optional properties:
token_expiry_duration: Duration the user session token is valid for. The default and maximum value is 60 minutes
default_postal_code: The postal code to use for offers localization if location services are unavailable/not granted
Step 3 - Redirect the user to the Triple White Label UI
The response from /initiate-session contains the property redirectUrl. Using the content of redirectUrl is enough to direct and authenticate the user with the Triple White Label UI.
Special consideration
It is worth noting that the token expiry is based on the token's creation time. If the token is pre-generated with a token_expiry_duration: 20 and embedded within an existing page but the user doesn't interact with the link for 15 minutes, the user session will expire after only 300 seconds/5 minutes. It is recommended to either leave the token_expiry_duration to its default and maximum values of 60 minutes or to generate the token when a user clicks on the redirection to the Triple White Label UI.
﻿
Updated 30 May 2024
Did this page help you?
Introduction
Status Page