Hi,
I am currently implementing a recurring payment feature using the Apple Pay JS API.
Based on the official demo (https://applepaydemo.apple.com/apple-pay-js-api), it appears that the recurringPaymentRequest object only supports a maximum of two stages: trialBilling and regularBilling.
However, our service requires a multi-stage billing model with three or more different cycles/amounts as shown below:
Example Schedule:
- Stage 1: 2,000 JPY (2026-03-01 to 2026-04-01)
- Stage 2: 1,500 JPY (2026-04-01 to 2026-10-01)
- Stage 3: 1,000 JPY (2026-10-01 to 2027-10-01)
- Stage 4: 500 JPY (Thereafter)
Questions: Is there any way to directly define and display three or more different billing cycles/amounts on the Apple Pay payment sheet?
If the API is strictly limited to two stages, what is the Apple-recommended way to provide transparency for such complex schedules while remaining compliant with the guidelines? For instance, is it acceptable to set the final amount in regularBilling and explain the preceding stages in the billingAgreement or paymentDescription fields?
I would appreciate any insights or official guidance on this.
Best regards,