SDK

Setup Loyalty

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 26d9f13017

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

Developer portal identifiers 9733ae6534

In this new page, click in the plus icon:

Developer portal create app id 69beff6298

Then go ahead and select the Pass Type IDs option:

Developer portal pass type id option 4ecbd03b7b

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 e2be7367d9

When you are done, click in Continue:

Developer portal continue button 7a2ba64f8e

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 22cd84e398

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 26d9f13017

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

Developer portal create certificate e50a547578

Then go ahead and click in the plus icon:

Developer portal create certificate icon 1f8936ae01

In this page, locate and select the following option:

Developer portal pass type id certificate 5f146f9539

Go ahead and click in Continue:

Developer portal continue button 7a2ba64f8e

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

Developer portal select pass type id 0103f7342e

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

Developer portal continue button 7a2ba64f8e

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

Developer portal certificate signing request c43a29c960

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 7a2ba64f8e

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 82a1aa814b

You will be prompt with the following window:

Developer portal create signing certificate b0da07559d

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 1f42b11799

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 c43a29c960

Choose the file you just generated:

Developer portal certificate signing request selected 2687abcce2

And click in the Continue button:

Developer portal continue button 7a2ba64f8e

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 45f954c9ec

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 8e1cf44119

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 06276d0027

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 1e7507b4ea

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 2b0215fe64

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 your guides located here.

Creating Passes

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

Soon you've configure 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.