Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

Interactive login is to be used when the user is present to login (for example, 3rd Party Desktop Applications) and will manage any additional information required at login depending upon a customer's account (such as 2 Factor Authentication codes or National Identifiers). 

This is achieved by embedding the Betfair IdentitySSO login page in your application and then obtaining a successful session token upon login. The keep alive operation should be called every 7 minutes if the user is still actively using your application. The embedded login page initially looks like this:

 

You should be able to detect the presence of a session token in the requests upon successful login for use by your application.

Interface

 

Login

URL definition

International users:

https://identitysso.betfair.com/view/login?product=<theProductDescriptor>&url=<theRedirectUrl>

Spanish jurisdiction users:

 

https://identitysso.betfair.es/view/login?product=<theProductDescriptor>&url=<theRedirectUrl>

 

Italian jurisdiction users:

 

https://identitysso.betfair.it/view/login?product=<theProductDescriptor>&url=<theRedirectUrl>

 

Parameters

NameDescriptionSample
product(mandatory)the product for which the login page is used and on which the user will do the login; this is used in pair with the url param, for whitelisting purposes. 
It can be any string which could define the application (including an AppKey value)
"IhDSui3ODdsdwo"
url (mandatory)The url to which the the browser should be redirected in case of a successful login. 
This must be whitelisted, paired with the product parameter.
https://www.betfair.com

 

Keep Alive

URL definition

International jurisdictions:

Spanish jurisdiction:

Italian jurisdiction:

Parameters

NONE

 

Logout

URL definition

International jurisdictions:

Spain jurisdiction:

Italian jurisdiction:

Parameters

Sample Code

A sample client, written in C#, is available to demonstrate this process on Github.  This is a C# project created under Visual Studio 2010, written against .Net 4, and is a Winforms Application.

...