Presence SDK

The Ticketmaster Presence SDK provides a simple way to add Ticketmaster features in your 3rd party iOS and Android apps

SDK

Download Presence SDK v1.13.1 iOS - Swift 4.2.0.

Download Presence SDK v1.13.1 iOS - Swift 4.2.1.

Download Presence SDK v1.13.3 Android.

Sample App

The Sample App empowers clients and integrators to easily demo the newest version of the Presence SDK on their Mobile Phones.

Check out new features, understand expected functionality, and even experiment with color schemes to customize the SDK for your particular app: no developer resources required!

What You Need

To integrate the Presence SDK in your application, you will need PresenceSDK.framework and iOSExperienceSDK.framework.

Release Notes Version 1.13.1

Requirements for using Swift 4.2.0 build

  • To build, you must use XCode 10.0.x and the iOS 12.0 SDK

Requirements for using Swift 4.2.1 build

  • To build, you must use XCode 10.1.x and the iOS 12.1 SDK

General Requirements

  • Only Portrait Orientation Supported.
  • iPhone support only.
  • Minimum iOS 11.0, supported through iOS 12.x
  • Offline Ticket Mode, which allows fans to access their tickets without a network connection, also requires that the app be accessible offline.

What’s New?

  • Respect rules set by Archtics memberInfo, in regards to transfer and resale permissions.
  • Renamed “Send” to “Transfer” throughout the SDK.
  • For AU clients, renamed “Transfer” to “Forward” throughout the SDK.
  • Host only and Archtics only login flows now share the same updated visual UI.
  • Validation for terms of service updates on each sdk load.

To integrate Presence sdk in your application, you will need the following aar file:

  • You need to download Experience SDK 7.0.3 from Experience private maven repo server. Please refer to Step 11 in the integrations guide.

  • Dependencies list has changed. Please refer to Step 4 in the integration guide below.

  • PresenceSDK-release-1.13.*.*.aar

Supported API levels

  • API level 21 ~ 28

Release Notes Version 1.13.3

Requirements

  • Supported API level 21 ~ 28.
  • Only Portrait Orientation Supported.
  • Offline Ticket Mode, which allows fans to access their tickets without a network connection, also requires that the app be accessible offline.

Permissions

  • INTERNET
  • ACCESS_NETWORK_STATE
  • READ_CONTACTS
  • WAKE_LOCK

What’s New?

  • Addressed an issue related to Purchase SDK.

Reference and Integration Guides

Here you can learn how to integrate the Presence SDK into your application. In addition, you will find a reference guide for methods to customize your integration, analytics, and release information for when your app is ready to be publish to the Apple App or Google Play store.

iOS Presence SDK Reference and Integration Guide

iOS Presence SDK Reference and Integration Guide

Integrating the Presence SDK into your iOS app is fast and simple.

Learn more
Android Presence SDK Reference and Integration Guide

Android Presence SDK Reference and Integration Guide

Integrating the Presence SDK into your Android app is fast and simple.

Learn more

Change log

Changes(02/08/2019 Release 1.13.1)

  • Respect rules set by Archtics memberInfo, in regards to transfer and resale permissions.
  • Renamed “Send” to “Transfer” throughout the SDK.
  • For AU clients, renamed “Transfer” to “Forward” throughout the SDK.
  • Host only and Archtics only login flows now share the same updated visual UI.
  • Validation for terms of service updates on each sdk load.

Changes(01/24/2019 Release 1.12.2)

  • Fixed an issue related to legacy account login.

Changes(12/17/2018 Release 1.12.1)

  • iOS 11 and up now supported (up from iOS 10.0)
  • Updated variable names for things like user ‘email’. You will see warnings / errors when first loading up the new SDK.
  • Updated a few methods as well like “loginWindowDidDisplay” became “onLoginWindowDidDisplay(backendName: )” Xcode will tell you the new values and will make the change very painless.
  • Cleaned up the back of the ticket information page.
  • Removed Lottie 3rd party library from SDK.
  • Posting resale tickets for Ticketmaster events now displays the correct values.
  • Added ability to use optional completion handler for login functions.
  • Integrators can now choose between Create Account or Forgot Password to match their NAM settings as only one can be supported at a time.
  • Updated font to Averta away from system font.
  • Fixed an issue where if a user had a space in any of the transfer flow, the ticket would fail to send.
  • Removed iPad as supported device type for Sample app, as it was never supposed to be supported. Presence SDK is strictly an iPhone SDK.

Changes(10/31/2018 Release 1.11.0)

  • Custom icon configuration with brandLogo image URL support for Link Account Screen and Drop-Down Menu.
  • Recipient Name added on Transferred (Pending and Claimed) Ticket Cards.
  • Added the ability to view the price at which a ticket was resold at.
  • Fixed bug which prevented postings with Canadian currency.
  • Fixed bug which prevented transfers with names containing leading or trailing whitespace.
  • Fixed bug which incorrectly allowed splits when editing a posting that did not allow splits.
  • Fixed bug which added a blue background on the barcode screen.
  • Microphone and Bluetooth Permissions removed.

Changes(10/03/2018 Release 1.10.0)

  • Xcode 10 / Swift 4.2 / iOS 12 Support
  • New default branding colors.
  • Launch Login with Team ONLY configuration for custom Archtics only flows. (see integration document)

Changes(8/29/2018 Release 1.9.0)

  • Account switching - If the signed in Archtics account is linked to other accounts, all related accounts will be shown in SDK.
  • Fixed an issue where integrators were not able to present the PresenceSDKView modally in certain cases.
  • Added new notification methods for highly requested actions. Please see Analytics section in implementation file.
  • Changed how our notifications work for onLoginSuccessful. You will now get a response for both Team and TM login separately. This brings this in line with how Android has been working.
  • Fixed an issue in the transfer and resale flows where the send button would become the incorrect branding color.
  • Fixed an issue where GA seat numbers were being displayed in the transfer flow.
  • Added @objc to some methods to reduce warnings for non Swift 4 projects.

Changes(7/27/2018 Release 1.8.0)

  • New Email Flow to capture recipient information.
  • The round, floating action contact from previous versions has now been added into a new view shown at the top of the events list page.
  • Add to Wallet changes including:
  • Wallet button loads faster.
  • Bulk add options, when there are multiple passes available.
  • Once added, ability to click View In Wallet to see pass in Apple Wallet.
  • Available offline once cached for up to a day.
  • added Eventday integration to help with high server load days.
  • Added a default image for events with no image.
  • exposed more values in the PresenceMember object.
  • Fixed layout issues on some smaller device sizes.
  • Sample app enhancements / clean up.

Changes(6/19/2018 Release 1.7.1)

  • Fixed an issue where add to apple wallet button would not appear in certain cases.

Changes(5/23/2018 Release 1.7.0)

  • New Federated Login - This login screen will intelligently log a fan into their Ticketmaster and/or Account Manager account based on the entered credentials
  • Xcode 9.3 and Swift 4.1 support
  • Expired refresh token handling improved for revocation use-cases
  • Larger Apple Wallet UI button used for higher visibility
  • Minor bugs, logic improvements

Changes(3/29/2018 Release 1.6.5)

  • General Admission ticket send / sell screens allow selection by numbered tickets instead of numbered seats
  • Fixed series event caching issue which could display invalid barcode
  • Various performance enhancements

Changes(3/06/2018 Release 1.6.2)

  • Swift iOS Swift 4.0.3 Support
  • Price guidance for selling Archtics tickets, based on similarly listed ticket prices
  • Sample App enhancements to save & edit profiles
  • Demo project to provide full examples and best practices for integrators
  • Support for viewing and sending Host series events consisting of multiple tickets
  • Improved error handling when prefetching tickets
  • Improved code comments for public methods, classes, structures, enums
  • Fixed display issues “Add the Apple Wallet” button while loading tickets
  • Fixed potential crashes from forced unwrapping of nil variables
  • Various Bug Fixes

Changes(01/31/2018 Release 1.5.0)

  • Created a Sample App for clients and integrators to easily demo the SDK.
  • Added local in-app notifications to alert user if tickets could not be refreshed.
  • Identity Host Login to enable future support of social logins, such as Facebook.
  • Updated the access token to be valid for 15 minute minimum.
  • Added a new getMemberInfo() method that can be used to fetch logged in member information.
  • Fixed event time to be displayed in event’s timezone.
  • Minor UI Improvements and bug fixes.

Changes(01/09/2018 Release 1.4.1)

  • Add new method for fetching the access token for Host and Archtics.
  • Add Experience SDK SSO Pinless Feature to disable pin prompt within add, return, and upgrade buttons.
  • Upgrade to Experience iOS SDK v4.9.3 for Swift 3.1 and Experience iOS SDK v5.0.5 for Swift 4.0.0 to allow access to certain Experience Swift objects.
  • Updated onLoginSuccessful() PresenceLoginDelegate method to return accessToken from the specified backend.
  • Updated onLoginCancelled() PresenceLoginDelegate method to return the backend name associated with a callback event.
  • Bug fixes and performance enhancements.

Changes (12/05/2017 Release 1.4.0)

  • Added support for prefetching all tickets in background so barcodes are accessible even in offline mode.
  • Added support for VIP color and text.
  • Added option to choose between Dark and Light theme for the SDK that works together with configured branding color.
  • Added few more delegate methods for the Login flow to have function parity between iOS and Android SDK.
  • Added a new method for accessing SDK’s version number.
  • Made Add to Wallet button more accessible by making it available on both front and back of ticket card.
  • Made some overall improvements and fixed some critical bugs.

Changes (11/21/17 Release 1.3.1)

  • Fixed experience sdk integration issues.
  • Fixed crash while adding a credit card for Host.

Changes (11/6/17 Release 1.3.0)

  • Experience SDK Integration.
  • Improved Login Screen for the SDK.
  • Support for iPhone X screen size.
  • Added refresh button for fans with no tickets
  • Added support for honoring custom tint color for navigation bar configured via UIAppearance.
  • Bug fixes for adding Mastercard as refund card and other UI issues.

Changes (10/16/17 Release 1.2.0)

  • Added support for entering verification code for linking TMR account for Archtics.
  • Fixed seat description selection for posting flow for Archtics.
  • Separated the login flow from main SDK so it can just be used for login and fetching valid access token.

Changes (10/5/17 Release 1.1.1)

  • Added support for choosing between different payout methods during Resale flow for Archtics.

Changes (09/29/17 Release 1.1.0)

  • Added support for Apigee and made integration with SDK much simpler.
  • Added support for seat selection in Transfer and Resale flow.
  • Added support for pre-fetching Apple Wallet Passes
  • Added 3 new helper methods for checking login status
  • Fixed few minor issues in the SDK

Changes (09/15/17 Release 1.0.8)

  • Switched to XCode 9 and Swift 4.

Changes (09/13/17 Release 1.0.7)

  • Fixed couple of issues related to accepting terms of use if user has not accepted it yet.
  • Cancel Transfer option is immediately available after initiating a transfer.
  • Scan Barcode option is immediately available after canceling transfer if barcode is available.
  • Added a configuration parameter in the SDK to select new accounts manager flow for resetting password and creating account on main login screen.
  • Added SDK version number on the main login screen.

Changes (09/5/17 Release 1.0.6)

  • Fixed the issue related to not able to post multiple tickets for resale at the same time.
  • Removed ticket price information from the Ticket Details View since that information is not provided.
  • Fixed an issue related to ‘Cancel’ button not appearing on Login screen in some cases.
  • Fixed an issue related to automatic scrolling to ticket card which has been successfully posted for resale.
  • Fixed the appearance of login button on Events List View when the current logged in account does not have any tickets.

Changes (08/24/17 Release 1.0.5)

  • Updated the main login screen and added a button for user to create new account or reset password.
  • Fixed a bug related to SDK hanging during the login flow.

Changes (08/22/17 Release 1.0.4)

  • Added some safety checks to avoid some crashes during Login flow.
  • Handled case for events that don’t have date and have TBD or some date override text.

Changes (08/18/17 Release 1.0.3)

  • Fixed issue related to grouping of ticket card when multiple tickets are transferred together.
  • Fixed another issue related to missing tickets from Transfer Group Selection View.

Changes (08/17/17 Release 1.0.2)

  • Fixed issue related to missing tickets from Transfer Group Selection View.

Changes (08/11/17 Release 1.0.1)

  • Added support to Add to Apple Wallet for ticket passes.
  • Added support for html tags in Accept Terms of Use screen.
  • Fixed couple of bugs while Adding and Editing deposit account.
  • Fixed issue related to handling of “Session Expired” error.

Changes(02/15/2019 Release 1.13.3)

  • Addressed an issue related to Purchase SDK.

Changes(02/08/2019 Release 1.13.2)

  • Addressed a cookie issue related to login.

Changes(02/08/2019 Release 1.13.1)

  • Removed TODAY and TOMORROW callouts on event list to align with iOS.
  • Renamed “Send” to “Transfer” throughout the SDK.
  • For AU clients, renamed “Transfer” to “Forward” throughout the SDK.
  • Host only and Archtics only login flows now share the same updated visual UI.
  • Validation for terms of service updates on each sdk load.
  • Addressed an issue where updating ACH accounts for Archtics would not work properly.
  • Addressed manual ticket transfer flow crash.
  • Addressed NPE for missing time_zone.
  • Addressed invalid server error during resale flow.
  • Support for CAD posting flows.

Changes(12/17/2018 Release 1.12.0)

  • API 21 - 28 Supported (up from 19)
  • Made changes to step 7 and step 8 of the integration documentation. These include changes that you will need to implement for your project to build. Major change for these steps is TMLoginListener has been renamed to PresenceLoginListener.
  • Removed ‘EventTimer-1.0.0.aar’ dependency. Please remove this from your projects!
  • Due to some integrators not being able to support the newer version of picasso, we have 2 versions on the dev portal this release. Please make sure your build.gradle includes the correct version you wish to use! (Support 2.5.2 and 2.71828)
  • Fixed an issue where if attempting to update the posting price of a listed ticket, and the get ticket info call was not finished, would cause a crash.
  • Fixed an issue where event times were being displayed incorrectly around DST change.
Cleaned up the back of the ticket information page.
  • Posting resale tickets for Ticketmaster events now displays the correct values.
  • Now handle when a user uses an incorrect ACH account. Proper error shows.
  • Fixed a crash that could occasionally happen around selecting a contact for the transfer flow.
  • Updated font to Averta away from system font.
  • Properly respect date and time overrides for events.
  • Integrators can now choose between Create Account or Forgot Password to match their NAM settings as only one can be supported at a time.
  • Fixed an issue where if a user had a space in any of the transfer flow, the ticket would fail to send.

    Changes(10/31/2018 Release 1.11.0)

  • Custom icon configuration with brandLogo image URL support for Link Account Screen and Drop-Down Menu
  • Recipient Name added on Transferred (Pending and Claimed) Ticket Cards
  • Added the ability to view the price at which a ticket was resold at.
  • Cleaned up the ticket view for small devices so users can see all functionality without having to scroll.
  • Fixed bug which added a blue background on the barcode screen
  • Fixed bug which incorrectly allowed splits when editing a posting that did not allow splits
  • Minimum API level is now 20 (Previously 19)
  • Picasso update to version 2.71828 is mandatory, otherwise a runtime crash will occur.

Changes(10/12/2018 Release 1.10.1)

  • Added support for a scenario on Android Pie where web view has been launched in the app before PSDK is loaded.

Changes(10/03/2018 Release 1.10.0)

  • New default branding colors.
  • Android Pie support
  • Minimum API level is now 19 (Previously 16)
  • Experience SDK v7.0.3 Support
  • Added new dependencies to integration document for enhanced customer experience.
  • Launch Login with Team ONLY configuration for custom Archtics only flows. (see integration document)
  • All methods related to oAuth tokens (including getAccessToken) that used to be in TMLoginApi relocated to com.ticketmaster.presencesdk.login.TokenManager class.

Changes(8/28/2018 Release 1.9.0)

  • Account switching - If the signed in Archtics account is linked to other accounts, all related accounts will be shown in SDK.
  • Added new notification methods for highly requested actions. Please see Analytics section in implementation file.
  • Addressed sample App crashes/restarts in airplane mode.
  • Sample app now supports Android Pie.
  • Claimed state for transferred tickets now shown properly.
  • “No Connection” banner now shows under proper circumstances.

Changes(7/31/2018 Release 1.8.1)

  • Fixed issues related to Eventday flow.

Changes(7/27/2018 Release 1.8.0)

  • New Email Flow to capture recipient information.
  • The round, floating action contact from previous versions has now been added into a new view shown at the top of the events list page.
  • Added Eventday integration to help with high server load days.
  • Added a new default image for events with no image.
  • Exposed more values in the PresenceMember object.
  • Fixed layout issues on some smaller device sizes.
  • Sample app enhancements / clean up.
  • Fixed an issue where prefetching was not happening in certain circumstances.
  • Fixed a rare crash after using the reset password screen.
  • Fixed wording on errors with linking accounts in federated login flow.
  • Fixed wording on transferring GA seats.

Changes(6/05/2018 Release 1.7.1)

  • Fixed an issue with onMemberUpdate() callback not firing off
  • Fixed an issue where prefetch was not firing after initial login

Changes(5/23/2018 Release 1.7.0)

  • New Federated Login - This login screen will intelligently log a fan into their Ticketmaster and/or Account Manager account based on the entered credentials
  • TLS 1.2 support
  • Expired refresh token handling improved for revocation use-cases
  • Consolidated transfer ticket cards to be grouped by transaction
  • Corrected seat number disparities on transferred tickets
  • Fixed missing ticket details issue on small-screen devices
  • Ticket status symbols updated
  • Minor bugs, logic improvements
  • Sample App: UI text updated, network connection notification added when offline, memory leak fixed when using large number of accounts

Changes(3/29/2018 Release 1.6.5)

  • General Admission ticket send / sell screens allow selection by numbered tickets instead of numbered seats
  • Disabled multiple login webviews from opening due to multiple clicks
  • Team Logout functionality restored
  • Updated send ticket messaging for series events which incorrectly mentioned selling tickets
  • De-duplication of sent Host tickets upon refresh
  • Sample app login screen buttons no longer disappear on smaller screens
  • Sample app unnecessary toast messages removed
  • Fixed compile errors due multiple string substitutions
  • Fixed index out of bounds exception - TmxResalePaymentPresenter
  • Fixed null pointer exception - DeviceDimensionHelper
  • Fixed missing section, row, seat information after sending ticket
  • Various performance enhancements

Changes(3/06/2018 Release 1.6.2)

  • Price guidance for selling Archtics tickets, based on similarly listed ticket prices
  • Sample App enhancements to save & edit profiles
  • Demo project to provide full examples and best practices for integrators
  • Support for viewing and sending Host series events consisting of multiple tickets
  • Improved code comments for public methods, classes, structures, enums
  • Fixed potential crash affecting specific API Key configurations
  • Resolved Lint errors
  • Various Bug Fixes

Changes(02/01/2018 Release 1.5.1)

  • Updated dependency list error in localize french string
  • Fix Lint error
  • Updated Integration Guide
  • Created a Sample App for clients and integrators to easily demo the SDK.
  • Updated Experience SDK version to 5.0.3 that includes loading spinner fix.
  • Added local in-app notifications to alert user if tickets could not be refreshed.
  • Identity Host Login to enable future support of social logins, such as Facebook.
  • Added a new getMemberInfo() method that can be used to fetch logged in member information.
  • Fixed an issue related to empty screen being displayed (due to device no-network) on the app launch when user already has cached information.
  • Fixed a crash during cancel transfer flow.
  • Fixed a crash that could occur during seat selection in posting and transfer flow.
  • Experience SDK deep link removed to no longer force the app selection prompt for links.
  • Minor bug fixes and improvements in ticket caching logic and counters.

Changes(01/31/2018 Release 1.5.0)

  • Created a Sample App for clients and integrators to easily demo the SDK.
  • Updated Experience SDK version to 5.0.3 that includes loading spinner fix.
  • Added local in-app notifications to alert user if tickets could not be refreshed.
  • Identity Host Login to enable future support of social logins, such as Faceboo k.
  • Added a new getMemberInfo() method that can be used to fetch logged in member information.
  • Fixed an issue related to empty screen being displayed (due to device no-network) on the app launch when user already has cached information.
  • Fixed a crash during cancel transfer flow.
  • Fixed a crash that could occur during seat selection in posting and transfer flow.
  • Experience SDK deep link removed to no longer force the app selection prompt for links.
  • Minor bug fixes and improvements in ticket caching logic and counters.

Changes (01/09/2018 Release 1.4.1)

  • Add new method for fetching the access token for Host and Archtics.
  • Add Experience SDK SSO Pinless Feature to disable pin prompt within add, return, and upgrade buttons.
  • Bug fixes and performance enhancements.

Changes (12/05/2017 Release 1.4.0)

  • Added support for prefetching all tickets in background so barcodes are accessible even in offline mode.
  • Added support for VIP color and text.
  • Added option to choose between Dark and Light theme for the SDK that works together with configured branding color.
  • Added support for API level 26 (Android 8.0).
  • Added a new method for accessing SDK’s version number.
  • Made Add to Android Pay button more accessible by making it available on both front and back of ticket card.
  • Fixed the background color of Event List View and made it opaque.
  • Made some overall improvements and fixed some critical bugs.

Changes (11/21/2017 Release 1.3.1)

  • Fixed experience sdk integration issues.
  • Fixed experience button menu missing after second time the ticket view is visited.

Changes (11/06/2017 Release 1.3.0)

  • Experience sdk integration
  • Android wallet support
  • Main login entry screen change
  • Fixed potential resource naming collision issue with client projects. All presence sdk resources are named with “presence_sdk_” prefix.
  • Bug fixes for master card and branding coloring support for action bar

Changes (10/16/2017 Release 1.2.0)

  • Added support for entering verification code for linking TMR account for
  • Fixed seat description selection for posting flow for Archtics
  • Fixed intermittent logout issue
  • Separated the login flow from main SDK so it can just be used for login and fetching valid access token.
  • Fixed other in-field issues

Changes (10/05/2017 Release 1.1.1)

  • Added support for choosing between different payout methods during Resale flow for Archtics.

Changes (09/29/2017 Release 1.1.0)

  • Added support for Apigee and made integration with SDK much simpler.
  • Added support for seat selection in Transfer and Resale flow.
  • Added 3 new helper methods for checking login status
  • Fixed few minor issues in the SDK.

Changes (09/13/2017 Release 1.0.0)

  • Resolved login issue of getting stuck in log-in screen after logging in and clicking “authorize” button.
  • Resolved login issue of getting 401 status when clicking on an event
  • Handled session expiry error
  • Fixed crashlytics crashes
  • Fixed crash due to multiple loading of TmxMainView
  • Fixed missing seats at group selection view in transfer/resale flow
  • Fixed in-field crash/issues
  • Fixed edit resale operation with 4 digit price
  • Added forgot password on log-in UI (08/24/2017)
  • Fixed duplicate ticket card in listing pending state (09/05/2017)
  • Added price breakdown in ticket details (09/05/2017)
  • Supported upsell items (09/05/2017)
  • Fixed payment account delete operation failure in concurrent log-in scenario (09/05/2017)
  • Restored barcode immediately after resale/transfer cancel (09/12/2017)
  • Fix to automatically refresh the event list view once user logs in to second server (09/12/2017)
  • Bundle and unbundle multi tickets resale or transfer operations (09/12/2017)
  • Added support for password recovery for teams still on old account manager (09/13/2017)