The Apple Passbook app allows users to store loyalty or gift cards in a digital format. Paytronix has developed functionality to generate a pass that includes account information. This page describes how to generate a pass through the Paytronix system.
Steps to Develop an “Add to Passbook” Function in Your App¶
In order to generate passes for your mobile app, you need to follow the following steps:
The integrator must create a new pass identifier in the Apple development portal. Paytronix requires that the fifth part of this identifier correspond to the unique Paytronix merchant id. For example:
The integrator must provide Paytronix with the
package.p12 package and the associated password. The formatting of the package must meet the following requirements: A PKCS12 bundle containing the private key used to sign the certificate generated by Apple, followed by a certificate chain of X509 certificates in the following order:
- The certificate generated by Apple and signed with the attached private key
- The intermediate certificate: Apple WWDR Certificate
This bundle must be protected with a password of non-zero length
Please refer to the flow section below
This flow supports the following authentication types: OAuth, B2B. Depending on the authentication type, more fields may be required. See this page for details: API Authentication Styles
Integration gathers information from the user. The information necessary depends on the authentication type
Integration sends passbookUrl call
The Paytronix System returns a success or failure
- If the result is success, then the integration should use the server response to obtain the user’s pass
- If the result is failure then the integration should inform the guest of the failure. We suggest that the integration uses the error code and error message returned by the system to inform the guest of the problem, though the merchant should have final approval on the message’s wording.