Generate SSO Token

After creating your user, you can provide them with single sign-on access.

Definition

https://sandbox.bluesnap.com/services/2/generateSSOLoginToken/?onbehalfofmid=


The Generate SSO Token API allows you to provide your user with single sign-on access to the Merchant Portal. Use the URL in the API response to redirect the browser to the Merchant Portal.

📘

Note:

Contact your e-support team (team who customized your merchant setup) to have them apply your principal role, so you can use this function.


Request Content

Send a JSON object, with the following:

requestingUserIp     string    required

Response Details

If successful, the response HTTP status code is 200 OK.


Examples

Request Example

curl -v -X POST https://sandbox.bluesnap.com/services/2/generateSSOLoginToken/1111001 \
-H 'Content-Type: application/json' 
-H 'Accept: application/json' 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='
{
    "requestingUserIp": " 62.216.234.216"
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/generateSSOLoginToken/1111001?onbehalfofmid=23424 \
-H 'Content-Type: application/json' 
-H 'Accept: application/json' 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='
{
    "requestingUserIp": " 62.216.234.216"
}'

Response Example

If successful, the response HTTP status code is 200 OK.

{
"loginToken":"44707702fb720f7be383722b5e767a77e78.-xn_70978e720abbc80e383722b5e767a77e78.-xn_70978e720abbc8070978e720abbc80e383722b5e767a77e78.-xn_70978e720abbc80",
    "loginLink":
"https://bluesnap.com/jsp/developer_login.jsp?ref=44707702fb720f7be383722b5e767a77e78.-xn_70978e720abbc80e383722b5e767a77e78.-xn_70978e720abbc8070978e720abbc80e383722b5e767a77e78.-xn_70978e720abbc80"
}

🚧

Note

  • Each session only remains active for 30 minutes. When a session expires, the data is not saved and you must create a new login request to activate a new session.
  • If the session was closed while working, you need to create a new login token since BlueSnap does not maintain the status of lost sessions.

Parameter Reference

Parameter

Description

onbehalfofmid

Creates SSO Token on behalf of a linked BlueSnap account

Note: This parameter specifies the BlueSnap account that owns the user.

userId

Provided in the Create User API response

requestingUserIp

Consists of user's IP address; for example, 62.216.234.216