---
schema_version: "1"
id: e0390c7e9cef855faf51ce8ceab2cdf0768c6d42d27ce35c927357e1c3d3454b
title: Add Apple Pay to a Messaging Channel
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/service/264-0-0/messaging_apple_pay_setup.md
canonical_url: https://help.salesforce.com/s/articleView?id=service.messaging_apple_pay_setup.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 155df5460a0b1f42ba1779833038732cb2f677397d99fcc911b8806c0e25d32c
description: To allow service reps to request payments during messaging sessions, add Apple Pay to your enhanced Apple Messages for Business channel.
products:
  - Service Cloud
  - Digital Engagement
release: "264"
---
# Add Apple Pay to a Messaging Channel

To allow service reps to request payments during messaging sessions, add Apple Pay to your enhanced Apple Messages for Business channel.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition">
          <colgroup>
            <col style="width:50%">
            <col style="width:50%">
          </colgroup>
          <tbody>
            <tr class="">
              <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=service.messaging_editions.htm&amp;type=5&amp;language=en_US" target="_blank">View supported editions.</a></td>

            </tr>
            <tr class="">
              <td class="slds-cell-wrap" style="vertical-align:top;">
                <a name="messaging_apple_pay_setup__d409e1177"><!-- --></a><span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" id="messaging_apple_pay_setup__d409e1177" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/resources-global/_corporate/images/checkmark.png" alt="Checkmark"></span>
                <strong>This article applies to:</strong>
              </td>

              <td class="slds-cell-wrap" style="vertical-align:top;">Enhanced Apple Messages for Business channels</td>

            </tr>
            <tr class="">
              <td class="slds-cell-wrap" style="vertical-align:top;">
                <span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/resources-global/_corporate/images/crossmark.png" alt="X icon"></span>
                <strong>This article doesn’t apply to:</strong>
              </td>

              <td class="slds-cell-wrap" style="vertical-align:top;">Enhanced In-App Chat, Enhanced Web Chat v1, Enhanced Web Chat v2, Enhanced
                WhatsApp, Enhanced Facebook Messenger, Standard and Enhanced SMS, Enhanced LINE, and
                Bring Your Own Channel</td>

            </tr>
          </tbody>
        </table> <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
          <colgroup>
            <col style="width:50%">
            <col style="width:50%">
          </colgroup>
          <thead class="slds-text-title_caps ">
            <tr class="">
              <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d105038e102">User Permissions
                Needed</th>
            </tr>
          </thead>
          <tbody>
            <tr class="">
              <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d105038e102 ">To set up and edit Messaging channels:</td>

              <td class="slds-cell-wrap" style="vertical-align:top;" headers="d105038e102 ">Configure Messaging</td>

            </tr>
            <tr class="">
              <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d105038e102 ">To view channels:</td>

              <td class="slds-cell-wrap" style="vertical-align:top;" headers="d105038e102 ">View Setup and Configuration</td>

            </tr>
          </tbody>
        </table>

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/images/icon_note.png)

Note An Apex class is required for Apple Pay.

1. **[Set Up Apple Pay](https://help.salesforce.com/s/articleView?id=service.messaging_apple_pay_setup.htm&release=264.0.0&type=5)**  
    To get started, set up Apple Pay in your Apple settings.
2. **[Import Your Merchant Identity Certificate](https://help.salesforce.com/s/articleView?id=service.messaging_apple_pay_setup.htm&release=264.0.0&type=5)**  
    Import your merchant identity certificate into Salesforce. This certificate is generated when you set up Apple Pay.
3. **[Update Your Messaging Channel Settings](https://help.salesforce.com/s/articleView?id=service.messaging_apple_pay_setup.htm&release=264.0.0&type=5)**  
    After you import your certificate, add Apple Pay to your enhanced Apple Messages for Business channel.
4. **[Create an Apex Class to Process Payments](https://help.salesforce.com/s/articleView?id=service.messaging_apple_pay_setup.htm&release=264.0.0&type=5)**  
    On the Apex Classes page in Setup, create an Apex class to facilitate payment processing.
5. **[Create a Payment Messaging Component, Apex Classes, and Flow](https://help.salesforce.com/s/articleView?id=service.messaging_apple_pay_setup.htm&release=264.0.0&type=5)**  
    Now that the preparation is complete, create a payment messaging component and accompanying flow.

## 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](https://developer.apple.com/documentation/passkit/apple_pay/setting_up_apple_pay).
2. Add your merchant information to your Messages for Business account.
    1. Go to [register.apple.com](http://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](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/images/icon_note.png)

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](http://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](https://help.salesforce.com/s/articleView?id=000381987&type=1&language=en_US).
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.

If you’re using one Apple Messages for Business channel to handle transactions for multiple brands, keep in mind that you can add only one Apple Pay configuration per channel. This means that all payment requests that occur in the channel will show the merchant name listed in your Apple Pay account.

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](http://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](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/images/icon_important.png)

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.

When a customer makes a requested payment, this Apex class sends a payment token to the payment provider (Apple Pay) so the payment can be processed.

For details and an example, see [ProcessPaymentHandler Interface](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_interface_RichMessaging_ProcessPaymentHandler.htm).

## Create a Payment Messaging Component, Apex Classes, and Flow

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

Service reps run the flow in the Service Console to send the component to customers. Customers click the component to view the request details and make their payment. Add a series of Apex classes to control the information that appears in the component.

1. Create a payment messaging component that service reps can send in messaging sessions. See [Create and Send Payment Requests in Messaging Sessions](https://help.salesforce.com/s/articleView?id=service.messaging_components_payment.htm&release=264.0.0&type=5 "Request payments from customers during messaging sessions with a payment messaging component. Service reps can send the component to prompt the customer to make a payment with Apple Pay. ").
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](https://help.salesforce.com/s/articleView?id=service.messaging_components_payment_flow.htm&release=264.0.0&type=5 "Create Apex classes and a screen flow that service reps can run to send payment messaging components to customers in messaging sessions. The flow executes the Apex classes and passes the transaction details into the payment messaging component. ").