Use Recurring Charge Items

This integration provides you with the ability to configure items with a recurring charge that can be passed on in purchase.

This integration enables you to provide items that come with a recurring charge available for shoppers to purchase. Examples of items that include a recurring charge include a service such as a data/call minutes/ text message bundle for a cellphone, or a subscription charge for a cable television package.

Items that include a recurring charge may have just a recurring charge or may have a recurring charge and a price. If an item has a price and a recurring charge, it is assumed that the item is not a service or subscription item. In this case the price represents an upfront payment and the recurring charge is the means by which the outstanding balance is paid.

Identification of items that include a recurring charge must be carried out through your Oracle Configure, Price, Quote Admin account. Please refer to the Synchronize Oracle Configure, Price, Quote Cloud Parts with Commerce SKUs section of the Implementation Guide contained in the Integrating Oracle CX Commerce with Oracle Configure, Price, Quote article on My Oracle Support.

If a shopper adds a recurring charge item to their cart, Commerce works with Oracle Configure, Price, Quote to display full information about the recurring charges associated with the order. This includes how much the recurring charge is for, the frequency of the recurring charge, and the duration for which the recurring charge will be made.

Note: The default value for frequency is monthly and the default value for duration is open-ended. If either of these is not the right value for the item they must be corrected in the Oracle Configure, Price, Quote Part for the item.

Items with a recurring charge are not included in order sub-total passed to the shipping calculator. If a cart contains only recurring charge items the order sub-total passed to the shipping calculator is zero, which means that no shipping charge is applied to the order.

Configure payment for recurring charge items

Commerce includes several built-in integrations with payment gateways that let your store accept credit cards, debit cards, gift cards, and PayPal payments. However, these integrations do not currently support recurring charges. If you wish to sell items with recurring charges you must use one of the methods set out below to configure Commerce payment processing to support recurring charges.

Configure credit card payments

Follow these instructions to configure your credit card payment processing to handle recurring charges:

1. Create a custom credit card payment extension.

   For detailed instructions about performing this step, refer to Create a credit card extension.

2. Install the custom credit card payment extension.

   For detailed instructions about performing this step, refer to Install the extension and configure the gateway.

3. Enable the payment gateway.

   For detailed instructions about performing this task, refer to Create a Credit Card Payment Gateway Integration and Create a Generic Payment Gateway Integration, .

4. Add custom properties to the Credit Card Payment webhook.

   For detailed instructions about performing this task, refer to Install the extension and configure the gateway .

   Note: This webhook is not site-specific. If you are running multiple sites on your Commerce instance, the configuration you supply applies to all sites that use this webhook.

Configure non-credit card payments

Follow these instructions to configure your generic gateway payment processing to handle recurring charges:

1. Create a custom generic payment extension.

   For detailed instructions on performing this task refer to the Supported payment methods and transaction types section of Create a Generic Payment Gateway Integration.

2. Install the generic payment extension.

   For detailed instructions about performing this step, refer to the Install the extension section of Create a Generic Payment Gateway Integration.

3. Enable the payment gateway.

   For detailed instructions about performing this task, refer to Create a Credit Card Payment Gateway Integration and Create a Generic Payment Gateway Integration.

4. Customize the payment details widget to capture payment information other than card details.
5. Add custom properties to the Generic Payment webhook.

   For detailed instructions about performing this task, refer to Send custom properties to a payment gateway.

   Note: This webhook is not site-specific. If you are running multiple sites on your Commerce instance, the configuration you supply applies to all sites that use this webhook.