PayPal billing agreements

To simplify the checkout process, customers can enter into a billing agreement with PayPal as the payment service provider. During checkout, the customer chooses the billing agreement as the payment method. The payment system verifies the billing agreement by its unique number and charges the customer account. With a billing agreement in place, it is no longer necessary for the customer to enter payment information for each purchase. Customers can manage their billing agreements from the dashboard of their customer account, where the status of each is shown as Active or Canceled. When a billing agreement is canceled, it cannot be reactivated.

Billing agreement workflow

  1. Customer signs up for a billing agreement. After a billing agreement is in place, additional billing agreements can be added only from the customer account. There is no limit to the number of billing agreements that a customer can create. Customers can use any of the following methods to sign up for billing agreements:

    • Sign up in customer account - Customers can sign up for a billing agreement from their customer accounts.
    • Sign up at checkout - Customers who pay for a purchase with PayPal Express Checkout can mark a checkbox to create a billing agreement. Although the billing agreement is not used for the current order, it becomes available as a payment method option the next time the customer places an order.
    • Sign up by store administrator - Upon customer request, the store administrator can create a sales order using the customer billing agreement.
  2. PayPal verifies and records agreement. When the customer places the order with payment by billing agreement, the billing agreement reference ID and sales order payment details are transferred to PayPal and recorded in the customer account, along with reference information. If the payment is authorized, an order is created in Commerce. The billing agreement reference ID is sent to the customer and to the store.

Manage billing agreements

The Billing Agreements page lists all billing agreements between your store and its customers. Merchants can filter the records by the customer or billing agreement information including billing agreement reference ID, status, and creation date. Each record includes general information about the billing agreement, and all sales orders that have used it as a payment method. You can view, cancel, or delete customer billing agreements. A canceled billing agreement can be deleted only by the store administrator.

View a billing agreement

  1. On the Admin sidebar, go to Sales > Operations > Billing Agreements.

  2. Find the billing agreement in the list and click to open it.

Each billing agreement page consists of two tabs: General Information and Related Orders.

General Information

This tab includes the general information about the billing agreement:

  • Reference ID: A unique numeric identifier that is assigned to current billing agreement.
  • Customer: Customer’s account assigned to current billing agreement.
  • Status: Payment agreement status.
  • Created At: Creation date.
  • Updated At: Update date.
w-600 modal-image
Billing Agreement View

This tab displays the list of the orders placed using the current billing agreement.

w-600 modal-image
Billing Agreement View

Cancel a billing agreement

  1. On the Admin sidebar, go to Sales > Operations > Billing Agreements.

  2. Find the billing agreement in the list and click to open it.

  3. In the top-right corner, click Cancel.

  4. To confirm the action, click OK.

Delete a billing agreement

  1. On the Admin sidebar, go to Sales > Operations > Billing Agreements.

  2. Find the billing agreement in the list and click to open it.

  3. In the top-right corner, click Delete.

  4. To confirm the action, click OK.

Column descriptions

Column
Description
ID
A unique numeric identifier that is assigned to each billing agreement
Email
A customer’s contact email
First Name
A customer’s first name
Last Name
A customer’s last name
Reference ID
A unique, numeric reference identifier that is assigned to each billing agreement
Status
Payment agreement status. Options: Active or Canceled
Created
Creation date
Updated
Update date

Storefront experience

Customers who enter into a billing agreement with a payment provider can make purchases now and pay for them later, according to the agreement. The

w-700 modal-image
Billing agreements list in the customer's dashboard
Column
Description
Reference ID
A unique, numeric reference identifier that is assigned to each billing agreement
Status
Payment agreement status. Options: Active or Canceled
Created At
Creation date
Updated At
Update date
Payment Method
A payment provider of a billing agreement
View
Button used for viewing billing agreements

Create a billing agreement

  1. From their account dashboard, the customer selects Billing Agreements.

  2. Under New Billing Agreement, selects a payment provider.

  3. Click Create.

This action redirects the customer to the payment system website.

w-700 modal-image
New billing agreement in the customer account dashboard

View a billing agreement

  1. From their account dashboard, the customer selects Billing Agreements.

  2. Selects the billing agreement and clicks View.

w-700 modal-image
View billing agreement in customer's dashboard

Cancel a billing agreement

  1. From their account dashboard, the customer selects Billing Agreements.

  2. Selects the billing agreement and clicks View.

  3. In the top-right corner, clicks Cancel and then OK to confirm.

NOTE
If an Admin user (merchant) cancels the billing agreement, it cannot be canceled on the storefront. The Canceled status is displayed for this agreement.
recommendation-more-help
dacea746-44a9-4368-b3fb-3bcff64c6be1