<!--
{
  "availability" : [
    "iOS: 16.0.0 -",
    "iPadOS: 16.0.0 -",
    "macCatalyst: 16.0.0 -",
    "macOS: 13.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "PassKit",
  "identifier" : "/documentation/PassKit/PKRecurringPaymentRequest",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "PassKit (Apple Pay and Wallet)"
    ],
    "preciseIdentifier" : "c:objc(cs)PKRecurringPaymentRequest"
  },
  "title" : "PKRecurringPaymentRequest"
}
-->

# PKRecurringPaymentRequest

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

```
class PKRecurringPaymentRequest
```

## Overview> Important:
> You must set the ``doc://com.apple.passkit/documentation/PassKit/PKPaymentRequest/recurringPaymentRequest`` property on a ``doc://com.apple.passkit/documentation/PassKit/PKPaymentRequest`` object to use this class to request a recurring payment.

Use a [`PKRecurringPaymentRequest`](/documentation/PassKit/PKRecurringPaymentRequest) 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

### Creating a recurring payment request

[`init(paymentDescription:regularBilling:managementURL:)`](/documentation/PassKit/PKRecurringPaymentRequest/init(paymentDescription:regularBilling:managementURL:))

Create a recurring payment object with a description, regular billing information, and a management URL.

### Describing a recurring payment

[`paymentDescription`](/documentation/PassKit/PKRecurringPaymentRequest/paymentDescription)

A description that you provide of the recurring payment and that Apple Pay displays to the user in the payment sheet.

[`billingAgreement`](/documentation/PassKit/PKRecurringPaymentRequest/billingAgreement)

A localized billing agreement that the payment sheet displays to the user before the user authorizes the payment.

### Setting payment summary items

[`regularBilling`](/documentation/PassKit/PKRecurringPaymentRequest/regularBilling)

The regular billing cycle for the recurring payment, including start and end dates, an interval, and an interval count.

[`trialBilling`](/documentation/PassKit/PKRecurringPaymentRequest/trialBilling)

The trial billing cycle for the recurring payment.

[`PKRecurringPaymentSummaryItem`](/documentation/PassKit/PKRecurringPaymentSummaryItem)

An object that defines a summary item for a payment that occurs repeatedly at a specified interval, such as a subscription.

### Managing payment tokens

[`tokenNotificationURL`](/documentation/PassKit/PKRecurringPaymentRequest/tokenNotificationURL)

A URL you provide to receive life-cycle notifications from the Apple Pay servers about the Apple Pay merchant token for the recurring payment.

[`managementURL`](/documentation/PassKit/PKRecurringPaymentRequest/managementURL)

A URL to a web page where the user can update or delete the payment method for the recurring payment.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)