Why Is Apple Pay Displaying the Wrong Billing Cycle?

This article covers how to resolve an Apple Pay display issue where the payment sheet incorrectly shows a “monthly” billing label for an annual subscription plan. This is a presentation-only behavior in Apple Pay and does not affect the actual billing schedule configured in Recurly.

Step 1: Confirm Billing Cadence in Recurly

First, check the plan configuration in the Recurly Admin Console to confirm the interval unit and count (e.g., annual, every 1 year). Ensure the plan is correctly set to “Annual” and that there are no overrides or trial periods affecting the cadence.

Step 2: Update Your Apple Pay Integration

Apple Pay’s display is controlled by the paymentRequest configuration in the integration code. To ensure the correct label appears, explicitly define the interval in recurringPaymentRequest.

Below is an example from our Advanced Apple Pay Integration Example:

recurringPaymentRequest: {
  paymentDescription: 'Apple Pay via Recurly',
  regularBilling: { 
    label: 'Apple Pay via Recurly', 
    amount: '84.00', 
    paymentTiming: 'recurring',
    recurringPaymentIntervalUnit: 'year',
    recurringPaymentIntervalCount: 1
  }
}

• paymentTiming: Set to 'recurring' for subscription billing.
• recurringPaymentIntervalUnit: Set to 'year' for annual plans.
• recurringPaymentIntervalCount: Set to 1 for once per year.

Ensure the amount in the code matches the total annual price in Recurly.

Step 3: Test the Fix

During Apple Pay checkout, confirm that the billing interval is now correct.