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=


Documentation

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.

Example Descriptions

For details about the above examples, see:

Generate SSO Token

This example shows a Generate SSO Token request with the requestingUserIp value set. You will want to use this value to generate an SSO token for your user.

Generate SSO Token on behalf of linked BlueSnap account

This example shows a Generate SSO Token request on behalf of a linked BlueSnap account.

Parameter Reference

ParameterDescription
onbehalfofmidCreates SSO Token on behalf of a linked BlueSnap account

Note: This parameter specifies the BlueSnap account that owns the user.
userIdProvided in the Create User API response
requestingUserIpConsists of user's IP address; for example, 62.216.234.216
Language
Authorization
:
Click Try It! to start a request and see the response here!