- The introduction of Subscription Tokens, to provide a single identifier for a customer's subscription to an application.
- The use of Application Keys, which replace product and vendor software IDs to control API access.
- For details of the operations to manage subscriptions, please see the Accounts section of the API-NG Reference Guide.
Sign up for subscription
- A customer with an existing Betfair account visits vendorapp.com and wants to sign up for the vendor application.
- The customer wants to purchase a 12 month subscription to vendorapp, so they purchase this from vendorapp.com.
- vendorapp.com then call the Account API-NG operation getApplicationSubscriptionToken, passing in their Application Key, a valid session token (to prove that they own that app key) and the length of the subscription required.
- Betfair return to the vendor a Subscription Token of the form ABCD-EFGH-IJKL.
- The subscription token is then provided to the user (e.g. by e-mail) at registration.
- The subscription is then activated by calling activateApplicationSubscription token, passing in the subscription token and a valid session token for the customer (in the X-Authentication header).
- The activateApplicationSubscription service should be used in conjunction with the interactive login method. See sample code here