Adding passes
Check support first
import { canAddPasses } from '@reeq/react-native-passkit';
const canAdd = await canAddPasses(); // JSON payloads
const canAddJwt = await canAddPasses('jwt'); // Android: checks the JWT API
- iOS returns
PKAddPassesViewController.canAddPasses(). Theformatargument is ignored. - Android asks Google Play services whether the save API for that payload format is available to this user and device. If you add passes with
addPassJWT, check'jwt'.
note
On Android, canAddPasses can return true on a device with no Google account signed in. In that case Google Wallet closes immediately and the result event reports cancelled.
Add a single pass
import { addPass } from '@reeq/react-native-passkit';
await addPass(base64EncodedPass);
| Platform | Payload |
|---|---|
| iOS | A signed .pkpass file, base64 encoded |
| Android | A Google Wallet JSON save payload (the unsigned body of a JWT), base64 encoded |
The promise resolves when the wallet UI is shown. Use the result event to find out what the user did.
Add several passes at once
0.3.0+import { addPasses } from '@reeq/react-native-passkit';
await addPasses([ticket1, ticket2, ticket3]);
- iOS shows a single Apple Wallet sheet with an Add All button (
PKAddPassesViewController(passes:)). - Android: Google Wallet saves several passes from one JSON payload, for example a
payload.eventTicketObjectsarray with several entries. Pass a single base64 encoded JSON in the array. More than one entry rejects withpass_error.
Add a pass from a JWT Android
When your backend signs the save payload, send the JWT as is:
import { addPassJWT } from '@reeq/react-native-passkit';
await addPassJWT(signedJwt);
This does nothing on iOS.
Skip passes that are already added iOS
import { containsPass } from '@reeq/react-native-passkit';
if (!(await containsPass(base64EncodedPass))) {
await addPass(base64EncodedPass);
}
On Android containsPass always resolves false. Track saved objects on your backend instead.
Show the right wallet name 0.3.0+
import { getWalletName } from '@reeq/react-native-passkit';
const name = await getWalletName();
// iOS: "Apple Wallet". Android: "Google Wallet", or "Google Pay" in markets that still use that name.