Salesforce B2C Commerce 19.4 > B2C Commerce Development > Integrating applications > Apple Pay on the Web

Configuring Apple Pay on the Web in Business Manager

To be able to configure Apple Pay on the Web in Business Manager, the feature must have been enabled for the merchant in Business Manager.

You can delete the configuration. Configuration information is deleted only for the instance type currently selected in the dropdown only and not others.

Note: To be able to use Apple Pay on the Web with Cybersource:
  • A merchant must Sign Up for Apple Pay with CyberSource through the Business Center (see page 14 of the Apple Pay document)
  • A merchant should follow Salesforce B2C Commerce’s Apple Pay Getting Started Guide and then configure their account with the settings in Business Manager as described in the steps, except for the following:
  • For Merchant Capabilities check the box for 3DS and leave other fields unchecked.
  • For Shipping Fields, CyberSource recommends Email, Name, Phone, and Postal Address.
  • For the Payment Provider URL:
    • TEST: https://apitest.cybersource.com/partner/demandware/payments/v1/authorizations
    • PROD: https://api.cybersource.com/partner/demandware/payments/v1/authorizations
  • For Payment Provider Merchant ID enter your CyberSource Merchant ID.
  • Leave Use Basic Authorization? unchecked
  • The JWS Private Key Alias can be obtained by going to Cybersource Business Center -> Account Management -> Transaction Security Keys -> Security Keys for Simple Order API.

If a merchant would like to run Decision Manager on Apple Pay Transactions, the “dw.extensions.applepay.paymentAuthorized.placeOrder” hook can be used to call for Token Create referencing Cybersource's Request ID from the authorization (which is called Transaction ID on the payment transaction). When the token is created, Decision Manager can be called referencing the token generated for the cardholder’s profile. These calls are implemented in Cybersource's LINK cartridge.

Ensure that host name aliases are configured properly, as detailed in Hostname Aliases.

  1. Select Merchant Tools > Site Preferences > Apple Pay.
  2. Select the Commerce Cloud environment that you want to configure (Production, Staging, Development).
  3. Check Apple enabled?.
  4. Enter your Apple Pay Merchant ID that you created or that you already use for Apple Pay.
  5. Enter your Apple Merchant Name, which will appear on the payment sheet.
    This is the brand name you would like to appear on the payment sheet.
  6. Enter the Country Code for the locale of your site.
    The country code is a two letter ISO 3166 country code.
  7. For Merchant Capabilities check 3DS and leave other fields unchecked.
  8. Select the types of payment you support.
    These represent the payment types that are sent to Apple Pay on button click and accepted by the sheet as valid payment types. Shoppers will only be able to submit a payment with a card in one of the accepted payment types. It's up to the PSP what types are supported.
  9. Select the Supported Networks.
    These represent the payment networks that will be sent to Apple Pay on button click and accepted by the sheet as valid payment networks. Shoppers will only be able to submit a payment with a card in one of the accepted payment networks (Discover, Visa, or other network). It is up to the PSP what networks are supported.
  10. Select the Required Shipping Address Fields that are required on the shipping forms.
  11. For the Required Billing Address Fields select Name and Postal Address.
  12. For Use Commerce Cloud Apple Pay Payment API? check Yes.
  13. Check whether to place the Apple Pay button on the cart and mini-cart pages.
  14. Select whether to enable automatic redirect of product detail pages to HTTPS.
    Because pages where the Apple Pay button appears must be served via HTTPS, it might be necessary to redirect certain pages on your site. Only pages that don't contain "sc.html" in the URL can be redirected using HTTPS redirection. Because of this, enabling HTTPS redirection might not result in the Apple Pay button appearing on all the pages you expect it should.
  15. Specify Payment Provider URL.
  16. Specify Payment Provider Merchant ID.
  17. The API Version is v1.
    This is the version of the B2C Commerce Apple Pay PSP API that is specified by Salesforce and implemented by PSPs. In addition, there is the Apple Pay JS API that is provided by Apple in Safari; currently, Commerce Cloud only supports using the original version 1, not the later versions that Apple has made available.
  18. If you are using Cybersource, leave Use Basic Authorization? unchecked. However, if you are using World Pay or Adyen, check Use Basic Authorization?.
  19. If you checked Use Basic Authorization, enter the username and password for the merchant issued by the payment provider.
  20. Enter the identifier for the merchant issued by the payment provider.
  21. If you are using Cybersource, for Use JWS? Check Yes. If you are using World Pay or Adyen don't check Yes.
  22. If you checked Yes for Use JWS? ,for JWS Private Key Alias enter the merchant’s .p12 Key Alias. The private key alias is created when a merchant uploads their .p12 key file to Business Manager Module, Private Keys and Certificates. This private key can be obtained by going to Cybersource Business Center -> Account Management -> Transaction Security Keys -> Security Keys for Simple Order API.
  23. Click Submit.
    After you click Submit, a domain name appears in the Registration section. If you don't have an alias registered, a domain similar to one of the following appears:
    • staging-merchant.demandware.net
    • production-merchant.demandware.net

    If you do have an alias registered, the domain will be something like mystore.com.

  24. Register with the Apple sandbox or the Apple production server.
    You need just one merchant ID to register with both servers. If your domain is registered with the Apple sandbox, the only device that can make payments on that domain is a device that is signed in to an iCloud Sandbox Tester Account; if your domain is registered with the Apple production server, any regular iCloud account can pay on that site. If you configure HTTPS, the HTTPS host name is used instead of the instance domain name. If you have multiple domain names for your site, you can register them; contact Commerce Cloud Support for details.

    Apple lets multiple domains be registered for the same Apple merchant ID. To register multiple domains, set the HTTPS URL, register it with Apple Pay, and repeat for any number of domains. When registration is complete you can remove the HTTPS URL from the Aliases screen

    Note: You don't need to manually register your merchant domain on Apple's developer account portal. This is handled by the Commerce Cloud. You can start testing on your sandbox instance (no need to use staging or development instance) using iOS 10 and macOS Sierra. Also ensure you use the Register Apple Sandbox button on your Apple Pay Business Manager screen.