Overview

Apple Pay enables customers to complete purchases quickly and securely using payment methods stored in their Apple Wallet. In Znode, Apple Pay is supported through integration with Spreedly as the payment orchestration layer and a configured payment gateway such as Authorize.Net or CyberSource.

This feature allows administrators to offer a streamlined checkout experience that reduces manual data entry, improves conversion rates, and enhances payment security.

Prerequisites

• Access to the Admin Console with appropriate administrative permissions
• A payment gateway account (Authorize.Net or CyberSource)
• Apple Pay certificates and keys configured in the Apple Developer portal
• Domain certificate files (.pem) available for upload
• Basic configuration of Spreedly completed

Key Use Cases

• Enable Apple Pay as a payment method on the Storefront
• Configure gateway integration using Spreedly
• Associate payment configurations with a Store
• Upload domain certificates for secure Apple Pay transactions

How Apple Pay Works in Znode

1. The customer selects Apple Pay during checkout.
2. The customer authenticates using Face ID, Touch ID, or device passcode.
3. Apple Pay generates a secure payment token.
4. The token is processed through Spreedly.
5. The configured payment gateway authorizes the transaction.
6. Znode creates the order and updates the payment status.

Use Case 1: Create a Payment Configuration for Apple Pay

1. Navigate to Admin Console > System Settings > Plugins > Installed Plugins.
2. Open the Spreedly plugin.
    
3. Select the Configuration Sets tab.
    
4. Click Add New.
   
    
5. Enter the required fields in General Settings:
   • Configuration Code
   • Display Name
   • Display Order
   • Display Settings
6. Select the gateway type: Authorize.Net or CyberSource.

Configure Authorize.Net Gateway

1. Select Gateway Mode: Test or Live.
2. Enter the Login ID.
3. Enter the Transaction Key.
4. Select Apple Pay in Payment Type.
   
   
   
   
5. Select payment behavior:
   • Authorize Only
   • Authorize and Capture
     
     
     
6. (Optional) Enable Display Capture in OMS.
7. Click Save or Save & Close.

Configure CyberSource Gateway

1. Enter Merchant ID.
2. Enter Private Key and Public Key.
3. Select Apple Pay in Payment Type.
4. (Optional) Enable Fraud Management.
5. Select:
   • Authorize Only
   • Authorize and Capture
6. (Optional) Enable Display Capture in OMS.
7. Click Save or Save & Close.

Important

Apple Pay requires additional configuration. You must upload domain certificates in the Store Payment Settings for the payment method to work correctly.

Use Case 2: Associate Apple Pay Configuration with a Store

1. Navigate to Admin Console > Stores.
2. Select the Store.
3. Click Webstore Payment Method.
4. Click Associate Payment Method.
5. Select the Apple Pay configuration.
6. Click Save.

Validation

• The configuration appears in the associated payment methods list.
• A confirmation message indicates success.

Use Case 3: Configure Domain Certificates for Apple Pay

1. Navigate to Admin Console > Stores.
2. Open the Store.
3. Click the Payment Settings tab.
   
4. Click Add Domain Certificate.
5. Enter the required details:
   • Store URL
   • Merchant Certificate (.pem)
   • Private Key (.pem)
      
6. Click Save.

Validation

• A success message is displayed.
• The certificate record appears in the list.

Use Case 4: Verify Apple Pay on the Storefront

1. Go to the Storefront.
2. Add a product to the cart.
3. Proceed to checkout.
4. Verify Apple Pay is listed under Payment Type.
5. Select Apple Pay and place the order.

Validation

• Apple Pay is visible and selectable.
• The order is successfully placed.

Managing Existing Configurations

Edit Configuration

1. Navigate to Spreedly > Configuration Sets.
2. Select a configuration.
3. Click Edit.
4. Update fields.
5. Click Save.

Delete Configuration

1. Navigate to Configuration Sets.
2. Select a configuration.
3. Click Delete.
4. Confirm the action.

Remove Configuration from a Store

1. Navigate to Admin Console > Stores.
2. Open the Store.
3. Click Webstore Payment Method.
4. Select the configuration.
5. Click Remove.
6. Confirm the action.

Expected Outcomes

• Apple Pay is available during checkout.
• Payments are processed securely.
• Orders are created successfully after authorization.

Best Practices

• Test in Test Mode before enabling Live Mode.
• Ensure certificates are valid and mapped to correct domains.
• Verify on supported Apple devices and browsers.
• Use Authorize and Capture unless delayed capture is required.

Common Issues

• Apple Pay does not appear if domain certificates are missing.
• Invalid certificates can cause payment failures.
• Storefront domain must match the configured certificate.
• Incorrect gateway credentials will result in transaction errors.