<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "ApplePayontheWeb",
  "identifier" : "/documentation/ApplePayontheWeb/ApplePayRecurringPaymentRequest/billingAgreement",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "Apple Pay on the Web"
    ],
    "preciseIdentifier" : "instp/ApplePayRecurringPaymentRequest/billingAgreement"
  },
  "title" : "billingAgreement"
}
-->

# billingAgreement

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

```
DOMString billingAgreement;
```

## Discussion

The merchant may provide an optional, localized [`billingAgreement`](/documentation/ApplePayontheWeb/ApplePayRecurringPaymentRequest/billingAgreement) string. The maximum length of the [`billingAgreement`](/documentation/ApplePayontheWeb/ApplePayRecurringPaymentRequest/billingAgreement) string is 500 characters.

You may use this string to include information about the recurring payment amount, interval, or other payment conditions, for example, or information on how the user can cancel payments. This string isn’t intended to replace any payment terms that you provide outside of the Apple Pay payment sheet.

> Important:
> You’re responsible to ensure that your use of this framework, including your billing agreement, is compliant with applicable legal requirements.

The Apple Pay payment sheet displays the text of the [`billingAgreement`](/documentation/ApplePayontheWeb/ApplePayRecurringPaymentRequest/billingAgreement) string; however, long [`billingAgreement`](/documentation/ApplePayontheWeb/ApplePayRecurringPaymentRequest/billingAgreement) strings that don’t fit on the payment sheet screen appear truncated with an ellipsis. Users can select the Billing Details on the payment sheet to read the full text of the [`billingAgreement`](/documentation/ApplePayontheWeb/ApplePayRecurringPaymentRequest/billingAgreement) string, up to the maximum 500 characters.

---

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)