Advanced Features Guide

Reference Transactions
About Cancelling Agreements and Getting the Billing Address
4
62 April 2012 Express Checkout Advanced Features Guide
Canceling a Billing Agreement
You can use BAUpdate (NVP: METHOD=BillAgreementUpdate) to cancel a billing
agreement.
To cancel an agreement, call BAUpdate and include the following information:
 A reference ID that associates the buyer to a billing agreement. Typically, the ID is the
billing agreement ID; however, you can also use a ID from a reference transaction.
 An action, which must be Canceled, in the BillingAgreementStatus field.
PayPal responds with the billing agreement ID and other information about the buyer whose
agreement was canceled. Although a buyer can log in to PayPal to manage agreements, the
BAUpdate API operation enables the buyer to cancel the agreement from your site without
logging in to PayPal. You can provide your own page for maintaining agreements with the
buyer.
The following diagram shows the message flow to cancel a billing agreement from your page:
Obtaining the Most Recent Billing Address
You can use BAUpdate (NVP: METHOD=BillAgreementUpdate) to obtain the buyer’s most
recent billing address.
NOTE: This feature applies to all new and existing reference transaction-based billing
agreements and preapproved payment-originated agreements.
To obtain the billing address, call BAUpdate without passing a value in the
BillingAgreementStatus field. The billing address is returned in the BAUpdate
response.