NVP/SOAP API / SOAP Operations / CreateBillingAgreement

CreateBillingAgreement API Operation (SOAP)

APILegacy


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

CreateBillingAgreementRequestType WSDL

Note: Only the fields described in this documentation are available for use.

CreateBillingAgreement Request Fields

Field Description

Token

xs:string

(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

CreateBillingAgreementResponseType1 WSDL

Note: Only the fields described in this documentation are available for use.

CreateBillingAgreement Response Fields

Field Description

BillingAgreementID

xs:string

Identification number of the billing agreement. When the buyer approves the billing agreement, it remains valid until 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 references a billing agreement.


Character length and limitations: 19 single-byte alphanumeric characters

Additional information

ReferencePayPal.comPrivacyCookiesSupportLegalContact