---
title: ApplePayRecurringPaymentRequest
framework: applepayontheweb
role: symbol
role_heading: Structure
path: applepayontheweb/applepayrecurringpaymentrequest
---

# ApplePayRecurringPaymentRequest

A dictionary that represents a request to set up a recurring payment, typically a subscription.

## Declaration

```data
dictionary ApplePayRecurringPaymentRequest {
	required DOMString paymentDescription;
	required ApplePayLineItem regularBilling;
	ApplePayLineItem trialBilling;
	DOMString billingAgreement;
	required DOMString managementURL;
	DOMString tokenNotificationURL;
};
```

## Overview

Overview important: You must include the recurringPaymentRequest property in the ApplePayPaymentRequest object to specify a request for a recurring payment. Use an ApplePayRecurringPaymentRequest object to provide the user with payment details and a way to manage payment methods for a recurring payment. You can optionally display a billing agreement and set up merchant token life-cycle notifications for the request. For more information about the merchant token life-cycle notifications, see Apple Pay Merchant Token Management API.

## Topics

### Describing the recurring payment

- [paymentDescription](applepayontheweb/applepayrecurringpaymentrequest/paymentdescription.md)
- [billingAgreement](applepayontheweb/applepayrecurringpaymentrequest/billingagreement.md)

### Setting the payment summary items

- [regularBilling](applepayontheweb/applepayrecurringpaymentrequest/regularbilling.md)
- [trialBilling](applepayontheweb/applepayrecurringpaymentrequest/trialbilling.md)
- [ApplePayLineItem](applepayontheweb/applepaylineitem.md)

### Receiving payment token notifications

- [tokenNotificationURL](applepayontheweb/applepayrecurringpaymentrequest/tokennotificationurl.md)

### Managing the recurring payment

- [managementURL](applepayontheweb/applepayrecurringpaymentrequest/managementurl.md)

## See Also

### Requesting recurring payments

- [recurringPaymentRequest](applepayontheweb/applepaypaymentrequest/recurringpaymentrequest.md)