How do I set up credit card payments for subscriptions?

When a credit card is used on a subscription, Oracle Receivables creates the invoices using the card as the payment method. Oracle Receivables performs the authorization of the invoice amount and manages the fund capturing process.

You can use credit cards as the payment method in Subscription Management by integrating with Oracle Receivables. To use credit cards, you:

Add a new credit card to the billing site and select that card in the Subscription Management UI.

For more information, see the Customer Account Information topic in the Implementing Receivables Credit to Cash guide.

Note in the Subscription Management UI, you can't:

Add a new credit card payment method.
Enter credit card token numbers.

Here are a couple of other ways use credit cards as the payment method in Subscription Management:

Enable tokenization and use Subscription REST APIs to pass the token number of a new credit card. Once the token number is passed, the application automatically adds this card as a payment method for the billing site. For more information about enabling tokenization, see the How You Enable Credit Card Tokenization topic in the Implementing Receivables Credit to Cash guide.
Perform credit card authorization during subscription activation by configuring the event model and using an authorization API provided by Subscription Management.

Refer to the REST documentation for sample payloads that pass token numbers to use credit cards as payment methods.

Set Up Credit Card Authorization

Before activating a subscription, you can authorize a credit card used as the payment method. The authorization helps you ensure that a valid credit card is used as the payment method. To use credit card authorization, you configure the event model.

Here are the steps to enable credit card authorization:

Sign in to the application as a setup user.
Ensure you're working in an active sandbox with the Configure Business Objects tool enabled.
Navigate to Subscription Configuration > Subscription State Management > Event Models.
Use the Event Models task to configure events and actions for the oracle.apps.subscriptionManagementsubscriptionService.view.SubscriptionsVO business object.
In the States section on the Edit Event Model page, select General.
In the General: Details section, configure the VALIDATE event and add an action to perform a credit card authorization using the API call in Groovy script as follows:
```
eventModel.execute('StatusManagementAM').authorizeCreditCards(SubscriptionId,1.0,eventModel.eventData.SequenceId, 'E');
```
Note: The parameter 1.0 is the authorization amount, and you can change it based on your business need.Use the parameter E if you want this validation to be an error. Use the parameter W instead if you want this validation to be a warning.
The API returns an Array List whose first element is Success or Failure. In case of failure, the second element of the Array List returned is a list of error messages for each credit card authorization that failed. If required, you can use these return values to write any custom business logic.
Test your changes and publish the sandbox.

Refer to the Oracle Financials documentation to understand more how credit card authorization, funds capture, and settlement flows work in the application.