CreateBillingAgreement API Operation (NVP)

APILegacyLast updated: March 16th 2023, @ 11:23:55 am


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.

CreateBillingAgreement Request Message

CreateBillingAgreement Request Fields

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.

Character length and limitations: 20 single-byte characters

CreateBillingAgreement API Response Message

CreateBillingAgreement Response Fields

FieldDescription
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.

Character length and limitations: 19 single-byte alphanumeric characters

Additional information