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.

Billing agreements

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.

Billing Agreement View

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

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

On this page