CreateBillingAgreement API Operation (NVP)
Last updated: Sept 18th, 5:23pm
    
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 | 
|---|---|
| 
                 
  | 
            
                 (Required) Must be   | 
        
| 
                 
  | 
            
                 (Required) The time-stamped token returned in the  Note: The token expires after three hours. Character length and limitations: 20 single-byte characters  | 
        
CreateBillingAgreement API Response Message
CreateBillingAgreement Response Fields
| 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.
                    Character length and limitations: 19 single-byte alphanumeric characters  |