Multipass

• Your store must be on a Shopify Plus plan.

You can enable Multipass functionality on a store from the Shopify admin.

1. From your Shopify admin, go to Settings > Customer accounts.

2. In the Multipass section, select Turn on to enable Multipass.

   After you enable Multipass, a secret is shared with you. You need the secret to generate tokens to log your customers into your Shopify store.

The customer information is represented as a hash which must contain at least the email address of the customer and a current timestamp (in ISO8601 encoding). You can also include the customer's first name, last name or several shipping addresses.

A minimal example, containing all required fields, might look like this:

An example containing some optional fields might look like this:

You can attribute tags to your customer by setting "tag_string" to a list of comma separated one-word values. These tags will override any tags that you may have already attributed to this customer.

If you want your users to see a specific page of your Shopify store, you can use the return_to field for that.

To generate a valid multipass login token, you need the secret given to you in your Shopify admin. The secret is used to derive two cryptographic keys — one for encryption and one for signing. This key derivation is done through the use of the SHA-256 hash function (the first 128 bit are used as encryption key and the last 128 bit are used as signature key).

The encryption provides confidentiality. It makes sure that no one can read the customer data. As encryption cipher, we use the AES algorithm (128 bit key length, CBC mode of operation, random initialization vector).

The signature (also called message authentication code) provides authenticity. It makes sure that the multipass token is authentic and hasn't been tampered with. We use the HMAC algorithm with a SHA-256 hash function and we sign the encrypted JSON data from step 3 (not the plaintext JSON data from step 2).

The multipass login token now consists of the 128 bit initialization vector, a variable length ciphertext, and a 256 bit signature (in this order). This data is encoded using base64 (URL-safe variant, RFC 4648).

Once you have the token, you should trigger a redirect to your Shopify store.

When the redirect is successful (for example, the token is valid and not expired), the customer will be logged in to your Shopify store.

The multipass token is only valid for 15 minutes and each token can only be used once. For those reasons, you shouldn't generate tokens in advance for rendering them into your HTML sites. You should create a redirect URL which generates tokens on-the-fly when needed and then automatically redirects the browser.

The following shows a basic example implementation of the token generation in the Ruby and PHP languages. You can also view a Node.js module for Shopify Multipass, called Multipassify.

It is critical to maintain secure communication when sending tokens to the browser. Always use HTTPS connections to transmit tokens. The HTTPS method prevents potential interception and keeps the transaction secure.

You should make sure that registering new accounts at your main website requires validation of the email address which is used. Otherwise, someone could sign up to your main site using somebody else's email address, thus getting access to his customer account in your Shopify store.

I have a huge customer database. How do I synchronize this with Shopify so that I can use multipass login?

You don't need to synchronize anything. As soon as you redirect a customer using multipass, we will automatically create a customer account for them in your Shopify store (if one doesn't exist yet).

Some of my customers have already placed orders on Shopify. How do I update those customers so they can login through multipass?

You can use the Customer API to set the multipass_identifier for the customer. You will need to use the identifier with all your multipass requests for those customer accounts

My secret was leaked. What do I do now?

If your secret ever leaks, it can be revoked in your shop admin and a new one can be generated. This will make all of the old URLs invalid. You should do this as quickly as possible since everybody who knows the secret can potentially access every customer account!

Can I use Multipass login between multiple Shopify stores?

No, Multipass cannot be used to log in between multiple Shopify stores without redirection to an external site.

Does Multipass login work with the wholesale channel?

No, Multipass cannot be used with the wholesale channel.

Can I restrict Multipass token usage to a customer's IP address?

No. As part of improving our infrastructure and support for IPv6, Shopify no longer supports the use of the remote_ip field in the customer data hash. This field is now deprecated as it primarily focused on IPv4 addresses and isn't compatible in IPv6 environments. Make sure you continue to use secure methods for managing sessions and authenticating user data.