Wallet Cards

Give signed-in customers links to add their Tiquo wallet card, such as a membership or loyalty card, to Apple Wallet or Google Wallet. First, complete the setup and sign the customer in.

Getting wallet card links

Call getWalletCardLinks() with the name of a wallet card design configured in the dashboard:

const links = await tiquo.getWalletCardLinks({ designName: 'member-card' });

console.log(links.appleWalletUrl);
console.log(links.googleWalletUrl);

The design name can also be passed as a string: tiquo.getWalletCardLinks('member-card'). It must match an active wallet card design name exactly. If the account has several designs, call the method once per design name.

The links belong to the signed-in customer. Fetch them after sign-in, and remove them from the page when the customer signs out.

Add to Wallet buttons

<a id="apple-wallet" hidden>Add to Apple Wallet</a>
<a id="google-wallet" hidden>Add to Google Wallet</a>

const appleLink = document.querySelector('#apple-wallet');
const googleLink = document.querySelector('#google-wallet');

tiquo.onAuthStateChange(async (session) => {
  if (!session) {
    appleLink.hidden = true;
    googleLink.hidden = true;
    appleLink.removeAttribute('href');
    googleLink.removeAttribute('href');
    return;
  }

  const links = await tiquo.getWalletCardLinks('member-card');
  appleLink.href = links.appleWalletUrl;
  googleLink.href = links.googleWalletUrl;
  appleLink.hidden = false;
  googleLink.hidden = false;
});

To show a single button that works on any phone, link to walletCardUrl instead.

Errors

See Utilities and Errors for handling TiquoAuthError, and Wallet Links for the Customer API endpoint this method calls.

Booking tickets

Wallet cards identify the customer. Tickets for a single booking are separate: their Apple Wallet and Google Wallet links come on each booking's ticketing object. See Booking tickets.