Add Apple Pay to a Messaging Channel

Set Up Apple Pay

To get started, set up Apple Pay in your Apple settings.

1. If you haven’t done so yet, enroll in Apple Pay. For help, see the Apple documentation: Setting Up Apple Pay.
2. Add your merchant information to your Messages for Business account.
   1. Go to register.apple.com and sign in with the Apple ID of the administrator or technical contact for the Messages for Business account.
   2. Navigate to your company's Messages for Business accounts and find the business account.
   3. Under Optional Integrations, find the Apple Pay section.
   4. Next to Apple Pay Merchant ID, click Edit.
   5. Enter the Apple Pay Merchant ID, which you created when you set up Apple Pay.
   6. Click Done.

Note An Apple Pay Merchant ID can be used with multiple Messages for Business accounts, but each Messages for Business account can have only one associated Apple Pay Merchant ID.

Import Your Merchant Identity Certificate

Import your merchant identity certificate into Salesforce. This certificate is generated when you set up Apple Pay.

1. Download your certificate in Apple Pay.
   1. Go to developer.apple.com/account.
   2. Select Certificates under Certificates, Identifiers & Profiles.
   3. Click on the relevant merchant certificate, or click the + to create a new certificate.
   4. Click Download.
2. Convert the certificate from .cer to Java Keystore (.jks) format.
   1. Convert the .cer file to a .p12 file. Mac users can do this by importing the file into Keychain and exporting it as a .p12 file.
   2. Convert the .p12 file to a .jks file.
3. In Setup, go to the Certificate and Key Management page.
4. Click Import from a Keystore.
5. Select your .jks certificate file and enter the keystore password.
6. Click Save.

Update Your Messaging Channel Settings

After you import your certificate, add Apple Pay to your enhanced Apple Messages for Business channel.

1. In Setup, go to the Messaging Settings page.
2. Click the name of your enhanced Apple Messages for Business channel.
3. In the Apple Pay section, click Add.
4. Select the Merchant Identity Certificate that you imported in Setup.
5. Enter your Apple Merchant ID. Find this ID on the Certificates, Identifiers & Profiles page in your Apple (not Salesforce) settings.
6. Enter your merchant name, which appears on your payment requests.
7. Click Save.
   A new entry is now visible in the Apple Pay section of your channel settings.
8. Verify your merchant domain with Apple.
   1. In the Apple Pay section of your channel settings, click the down arrow to show the action menu and click Verify Domain.
   2. In the window that appears, copy the domain provided and save it to your notes. You will need this domain later in the setup process, when you create a payment messaging component.
   3. In a new browser tab, go to developer.apple.com.
   4. Click Identifiers.
   5. Click App IDs in the top right, and select Merchant IDs.
   6. Click your merchant ID.
   7. Under Merchant Domains, click Add Domain.
   8. Paste the domain name that you copied earlier from Salesforce.
   9. Click Save, and then click Download to download the .txt verification file. Leave your browser tab open.
   10. Back in your Salesforce browser tab, click Upload Files and upload the file from Apple. Then, click Done.
   11. Return to your Apple browser tab, and click Verify.
   12. Click View Identifier at the top of the page to return to your merchant ID page. Under Merchant Domains, you can now see the newly added domain, as well as its expiration date.

Important Merchant domains in Apple expire about every six months. Apple notifies you when a domain is about to expire. For Apple Pay to continue working in your Apple Messages for Business channel, you must repeat this domain verification process periodically, before your domain expires.

Create an Apex Class to Process Payments

On the Apex Classes page in Setup, create an Apex class to facilitate payment processing.

Create a Payment Messaging Component, Apex Classes, and Flow

Now that the preparation is complete, create a payment messaging component and accompanying flow.

1. Create a payment messaging component that service reps can send in messaging sessions. See Create and Send Payment Requests in Messaging Sessions.
2. Add a series of payment-related Apex classes, create a flow, and use it to request payments from customers. See Set Up a Flow to Send Payment Requests in Messaging Sessions.