On this page
No Headings
Last updated: June 12, 2026
Important: NVP/SOAP is a legacy integration method. We accept new integrations and support existing integrations, but there are newer solutions. If you're starting an integration, we recommend our latest solutions.
Creates a billing agreement with a PayPal account holder. Valid for reference transactions only.
| Field | Description |
|---|---|
METHOD | (Required) Must be CreateBillingAgreement. |
TOKEN | (Required) The time-stamped token returned in the SetExpressCheckout response. Note: The token expires after three hours. |
| Field | Description |
|---|---|
BILLINGAGREEMENTID | Identification number of the billing agreement. When the buyer approves the billing agreement, it becomes valid and remains valid until it is canceled by the buyer. Note: For reference transactions, you can pass a billing agreement ID in the ReferenceID request field; also, a billing agreement ID is returned in the transaction response when the transaction referenced is a billing agreement. |