Urban Airship Wallet is now Urban Airship Reach. Though the product name has changed, the features and functionality remain the same. All /wallet-api.urbanairship.com/ endpoints will continue to function as before. For more information about Urban Airship Reach, please see our news release.
To access account-related information, click Account from the right side of the Urban Airship dashboard header. Each section’s purpose and options are detailed below. Billing information follows.
Account Details displays your contact information. To update the information, click the Edit button, make your changes, then click the Save Changes button, or Cancel to discard.
You can also change your reach.urbanairship.com password from the Edit screen. You are required to enter your current password to confirm the change before Saving.
If you change your account’s email address, your API credentials will also change. See Reach API: Authentication.
Manage your Apple and Android certificates.
Certificates are added at the Account level, but you have the option to add multiple certificates then select which one will be associated with a particular project.
To integrate Apple Wallet with your account, you need:
- An Apple Pass Type Certificate
- The Certificate password
If you do not yet have them, see Getting Started: Certificate Set Up: Apple Wallet, then return to this screen to add them to your account.
Changing the Pass Type ID for the certificate used on your project will make it impossible to edit passes generated with the old certificate. For this reason, you should ensure you have uploaded a valid certificate before you begin making passes.
Add a New Certificate¶
Click the Add Apple Cert button.
Enter the Certificate password
Click the Choose File button, and select the .p12 (exported certificate) file.
Click the Save button, or cancel to discard.
Repeat these steps to add another certificate.
Hover your mouse at the end of a certificate’s row, then click on the three dots that appear to display its options.
Certificates cannot be deleted, however they may be Disabled.
Set as default¶
Use Set as default to designate which certificate is assigned when a new project is created. The certificate will be labeled as default.
You may change the default certificate as often as needed. This will not impact any previously created projects, only projects that are created after designating a new default certificate.
Change the certificate at the project level if you require a different certificate to be associated with a project. See Dashboard: Settings: Project Details.
If you have created any passes for a project and then change the certificate, Reach will be unable to interact with or update those passes. The certificate authorization will fail on those passes and they will be in an orphaned state.
Use Renew to replace the existing certificate. The new certificate is validated upon upload to verify it has the same basename and Team ID as the original.
- Enter the Certificate password.
- Click the Choose File button, and select the .p12 (exported certificate) file.
- Click the Save button, or cancel to discard.
API Management displays your Urban Airship Reach API key, which is used for issuing requests to the Reach API.
Save to Wallet¶
Save to Wallet allows allows end users to save wallet objects from your website to Android Pay. To activate this feature, define an Origin URL.
Click Save to Wallet Origin URL or the Edit button.
Enter the root URL where your Save to Android Pay button that will be placed, e.g., https://www.mysite.com.
Total Passes Installed¶
(For Urban Airship Reach contracts entered into or renewed on or after July 1, 2016)
For billing purposes, Urban Airship counts the total number of “Total Passes Installed” each month on a customer’s account. The Total Passes Installed count includes each Apple Wallet mobile wallet pass and Android Pay mobile wallet card that has been installed by an end user on a unique device during the current month, as well as those mobile wallet passes and/or mobile wallet cards that are still installed on devices from prior months.
Wallet passes and/or mobile wallet cards that fit the following conditions are counted in the month deleted or expired, but not the following months:
- Wallet passes and/or wallet cards deleted individually on each device by end users or systematically by Urban Airship Reach customers.
- Wallet passes and/or wallet cards that have expired on each device.
Mobile Wallet Items Under Management¶
(For Urban Airship Reach contracts entered into or renewed prior to July 1, 2016)
For billing purposes, Urban Airship counts the total number of “Wallet Items” each month on customer’s account that are managed by Urban Airship Reach. The Wallet Items under management count includes each unique Apple Wallet mobile wallet pass and Android Pay mobile wallet pass that was being managed by Urban Airship Reach during a given month. This includes Wallet Items that were created that month, as well as those wallet items still under management from prior months.
Wallet items that fit the following conditions are counted in the month deleted or expired, but not the following months:
- Wallet items deleted individually by end users or systematically by Urban Airship Reach customers.
- Wallet items that have expired.