Recurring Billing Subscriptions
June 4, 2024
Description
How to create, edit and search for a Recurring Billing subscription for new and existing customers
A Recurring Billing subscription combines the customer's payment information (their token) with the Recurring Billing plan. The subscription defines when the payments will start and how long they will last. You can create a subscription with a new customer, which will create the customer token at the same time your create the subscription, or you can create the subscription using a customer token that you created previously. If needed, you can update or cancel a subscription at any time.
- To create a Recurring Billing subscription
- Log in to your Merchant Services account in Business Advantage 360 online banking.
- Select Recurring Billing > Subscriptions.
- Click Create New Subscription.
- Select whether you are creating a subscription for a new customer or whether you will use an existing customer token:
- To enter new customer payment details
- Enter the customer details for the new customer:
- Enter a reference number for the customer. This is a required field and will help you identify the customer later.
- (Optional) Enter an email for the customer.
- (Optional) You may add additional fields. Click Add and then enter the information of your choice.
- Click Continue.
- Enter the payment details for the customer:
- Select Credit/Debit card in Payment Methods.
- Enter the card details, including card type, card number, expiration, and currency.
- Enter the Billing Address details for the cardholder.
- Click Continue.
- Indicate whether the shipping address is required for this subscription. If yes, enter the shipping address details.
- Click Continue.
- To select an existing customer token
- Enter the existing customers First Name and Last Name.
- Select Search.
- In the search results, click Select next to the customer's account.
- Enter the Subscription Details:
- Enter a Subscription Name, which can be the name can be the customer’s last name, a customer number, or whatever is most helpful to the you. This is a required field.
- Enter a Start Date to begin billing.
- (Optional) Enter a Subscription Code if there is a unique code that should be assigned; otherwise, the system will auto-assign a consecutive subscription code number. The Subscription Code can be letters or numbers.
- From the Billing Plans dropdown list, select a plan to associate to the subscription.
- Click Apply.
NOTE:
You many edit the Billing Amount and Setup Fee associated with the plan for this specific customer by clicking the pencil icon. While the Billing Amount and Setup Fee can be updated at the subscription level, this is not recommended. To keep consistency for all subscriptions assigned to a specific plan, we recommend that this information not be changed. If necessary, the merchant should create a new plan and then associate the plan to the subscription.
- Click Create Now.
- Click Yes, create to confirm the new subscription. The Subscription Details screen will appear.
- To edit subscriptions
You can change the subscription code, name, plan option, and billing amount. There are two ways to edit the details of a specific subscription: through Recurring Billing or Token Management.
- Log in to your Merchant Services account in Business Advantage 360 online banking.
- Select Recurring Billing > Subscriptions.
- Locate the subscription and click the Subscription Code hyperlink.
- Click Edit and make desired changes.
- Click Update.
NOTE: You can also access the subscription through Token Management by selecting the customer's token ID, then selecting the Subscriptions tab and clicking the Subscription Code.
- To search for a subscription
View subscriptions from within your Merchant Services account in Business Advantage 360 online banking. There are two ways to view subscription details – in Recurring Billing, and in Token Management.
- Log in to your Merchant Services account in Business Advantage 360 online banking.
- In the left navigation, select Recurring Billing > Subscriptions.
- Use the filters to locate the subscription and click the hyperlink in the Subscription Code column to open the Subscription Details page. If you select to filter on Subscription Status, available statuses include:
Option | Description |
---|
Pending | Created but subscription has not yet started (a future start date) |
Active | Subscription is currently in use |
Delinquent | A payment has been missed (auto-payment declined) |
Suspended | A subscription is automatically suspended after 5 evenly spaced tries and failures, manual suspension is not available |
Cancelled | Subscription has been cancelled by merchant |
Completed | Installment plan that has reached the specified number of payments |
NOTE: You can also access the subscription through Token Management by selecting the customer's token ID, then selecting the Subscriptions tab and clicking the Subscription Code.
- To cancel or reactivate a subscription
- Log in to your Merchant Services account in Business Advantage 360 online banking.
- Select Recurring Billing > Subscriptions.
- Locate the subscription and click the Subscription Code hyperlink.
- From the Change Status dropdown list, select the to cancel or reactivate.
- To troubleshoot Delinquent or Suspended subscriptions
When a subscription is first created, the payment method will be tested. If the payment method fails, the account is immediately suspended. If the payment method fails at the first billing cycle, the account will be suspended. After the first billing cycle, if a payment fails, the Subscription status changes to Delinquent and the system begins retrying the payment method until the the payment works or the system changes the Subscription status to Suspended.
Table of payment failure status and subscription statusPayment failed | Subscription status |
---|
When subscription is created | The subscription will automatically be Suspended. |
Very first payment fails | Without any retries the subscription will automatically be Suspended. |
Payment fails after recurring billing established | Payment will go through a retry process. During the retry process, the status of the subscription will be Delinquent. After retrying 3 times, the subscription will become Suspended. The rate of retry depends on the Subscription billing frequency:
Table of subscription type and retry frequencySubscription billing frequency | Retry frequency |
---|
Yearly | Retried every 15 days x 3 times | Monthly | Retried every 2 days x 5 times | Weekly | Retried every 1 days x 3 times | Daily | No retry |
|
NOTE:
This article is written for merchants who manage Recurring Billing within their Merchant Services account within Business Advantage 360. (Business Advantage 360 is our Small Business Online Banking platform.) This article is not written for advanced e-commerce merchants who integrate to the Bank of America Gateway via our Card Not Present Integration Toolkit and manage this service via API.