SDK

Setup

In this page you'll learn how to setup your Notificare app to generate digital cards for the Wallet app.

Creating a Pass Type ID

In this document we'll assume you've already created an App ID, if you did not please read the guides located here. Go to the Apple's Developer Portal. Once you've sign in, you should click in the Certificates, IDs & Profiles menu item:

developer portal menu

This will take you to a new page where you should locate the Identifiers menu item:

developer portal identifiers

In this new page, click in the plus icon:

developer portal create app id

Then go ahead and select the Pass Type IDs option:

developer portal pass type id option

You are now about to create a Pass Type ID, go ahead and provide a name for your Pass Type ID and its unique identifier (for best results use the same bundle identifier as your app, if applicable, but start always with pass.xxx):

developer portal register pass type id

When you are done, click in Continue:

developer portal continue button

This will take you to a confirmation screen like the one below, if everything is OK go ahead and finish creating your Pass Type ID by clicking in Register:

developer portal confirm register pass type id

Generate a Pass Type ID Certificate

Once you've created a Pass Type ID or at least have one, you are now ready to create an Pass Type ID certificate. This certificate will allow us to generate passes for your app.

In Apple's Developer Portal, locate the Certificates, IDs & Profiles menu item:

developer portal menu

In this new page, click in the Certificates menu item:

developer portal create certificate

Then go ahead and click in the plus icon:

developer portal create certificate icon

In this page, locate and select the following option:

developer portal pass type id certificate

Go ahead and click in Continue:

developer portal continue button

In the following page, select the Pass Type ID you've previously generated:

developer portal select pass type id

After selecting the Pass Type ID you want to use, go ahead and click in Continue:

developer portal continue button

In this new tab, you will need to provide an existing Certificate Signing Request:

developer portal certificate signing request

We will explain how to generate one but if you already have one previously created, just go ahead and click in Continue:

developer portal continue button

If you do not have one, you will have to generate it. For that you will need to open the Keychain Access app from your applications, in your MacOS powered computer and request a signing certificate from an certificate authority by selecting the following:

developer portal keychain access request

You will be prompt with the following window:

developer portal create signing certificate

Simply provide an email and check the Saved to Disk option and then click in Continue, it will prompt you to save a file in your computer:

developer portal save signing certificate

You have now generated a CSR file and you we are ready to resume our Pass Type ID certificate creation, in Apple's Developer Portal. In the screen you left off:

developer portal certificate signing request

Choose the file you just generated:

developer portal certificate signing request selected

And click in the Continue button:

developer portal continue button

We've now generated a Pass Type ID certificate, hit the Download button to download the file to your computer:

developer portal download pass type id certificate

Double-click in that file to install it in your Keychain Access app. Then locate it in the Keychain Access app:

developer portal pass type id entry keychain access

Then we will need to export this file in a .p12 format. To do that, right-click the file and select the Export option:

developer portal export certificate keychain

This will allow you to name your export file and select the location in your computer where you going to export it. Then click in Save:

developer portal export p12 save

Because these files are extremely important and will give any push provider access to send notifications to your app, you will want to protect it with a password. Once you've provided a password twice, click in the OK button. This will save the file in your computer.

developer portal export p12 password

You now have to upload the resulting export file to Notificare. This will allow us to generate passes in your application. This step is covered in the guides located here.

Pass Designer

Before you can use digital cards in your apps, you will need to learn how to design a template. This is described in our guides located here.

Creating Passes

Once you have created at least one pass template, you can start generating digital cards. This is described in our guides located here.

Soon you've configured the Loyalty add-on, created your first template and at least one pass, you can go ahead and learn how you implement it in your app, by reading the guides located here.