BAUpdate API Operation (NVP)

METHOD

(Required) Must be BillAgreementUpdate.

REFERENCEID

(Required) An ID, such as a billing agreement ID or a reference transaction ID that is associated with a billing agreement.

BILLINGAGREEMENTSTATUS

(Optional) Use to cancel a billing agreement. To cancel a billing agreement, pass the value Canceled.

Note: If you do not pass the value Canceled, BAUpdate returns the buyer's latest billing address.

BILLINGAGREEMENTDESCRIPTION

(Optional) Description of goods or services associated with the billing agreement. This field is required for each recurring payment billing agreement. PayPal recommends that the description contain a brief summary of the billing agreement terms and conditions. For example, buyer will be billed at “9.99 per month for 2 years.”

Character length and limitations: 127 single-byte alphanumeric characters

BILLINGAGREEMENTCUSTOM

(Optional) Custom annotation field for your own use.

Note: For recurring payments, this field is ignored.

Character length and limitations: 256 single-byte alphanumeric characters

BILLINGAGREEMENTID

BILLINGAGREEMENTDESCRIPTION

Description of goods or services associated with the billing agreement. This field is required for each recurring payment billing agreement.

Character length and limitations: 127 single-byte alphanumeric characters

BILLINGAGREEMENTCUSTOM

Custom annotation field for your own use.

Character length and limitations: 256 single-byte alphanumeric characters

BILLINGAGREEMENTSTATUS

(Optional) Use to cancel a billing agreement. To cancel a billing agreement, pass the value Canceled.

Note: If you do not pass the value Canceled, BAUpdate returns the buyer's latest billing address.

BILLINGAGREEMENTMAX

Maximum amount for this billing agreement.

Note: This field only has a value if the buyer signed up for PayPal using Preapproved Payments; it is included for backwards compatibility with deprecated systems.

Character length and limitations: `partial:partials/docs/shared/cl_currencylimit.en-XC`

BILLINGADDRESS

Customer's billing address. If the customer has stored a credit card in his/her account then the billing address of the credit card is returned; otherwise the customer's primary address is returned.

EMAIL

Email address of buyer.

Character length and limitations: 127 single-byte characters

PAYERID

Unique PayPal Customer Account identification number.

Character length and limitations: 17 single-byte alphanumeric characters

PAYERSTATUS

Status of buyer. It is one of the following values:

• verified
• unverified

Character length and limitations: 10 single-byte alphabetic characters

COUNTRYCODE

Buyer's country of residence in the form of ISO standard 3166 2-character country codes.

Character length and limitations: 2 single-byte characters

PAYERBUSINESS

Buyer's business name.

Character length and limitations: 127 single-byte characters

SALUTATION

Buyer's salutation.

Character length and limitations: 20 single-byte characters

FIRSTNAME

Buyer's first name.

Character length and limitations: 64 single-byte characters

MIDDLENAME

Buyer's middle name.

Character length and limitations: 64 single-byte characters

LASTNAME

Buyer's last name.

Character length and limitations: 64 single-byte characters

SUFFIX

Buyer's suffix.

Character length and limitations: 12 single-byte characters

PAYEEEMAIL

Email address of the merchant or owner of the billing agreement.

Character length and limitations: 127 single-byte characters

PAYEEID

Unique merchant account identification number.

Character length and limitations: 17 single-byte alphanumeric characters