When you integrate with a payment provider, the checkout process is typically managed by the Oracle Commerce Cloud storefront. For example, if you use the Credit Card Payment webhook, the gateway can transmit payment authorization, void, and refund requests to the payment provider. The provider processes these transactions, but does not handle the shopping cart.

Integrations based on the Generic Payment webhook can use the Commerce Cloud checkout process as well. For example, in the scenario described in Integrate with a Gift Card Payment Gateway, the Generic Payment webhook functions in a similar way to the Credit Card Payment webhook, and the checkout process is handled by the Commerce Cloud storefront.

The Generic Payment webhook, however, also supports integrations with external web checkout systems such as Amazon Payments or Stripe Checkout. When using one of these providers, some or all of the checkout experience, including the user interface, is delegated to it. Commerce Cloud passes the entire shopping cart to the external system, which is responsible for managing the checkout process and then sending the results back to Commerce Cloud.

To develop an integration with an external web checkout system, you need to do several things:

  • Create a gateway extension. In the gateway.json file, set paymentMethodTypes to generic.

  • Customize the Commerce Cloud storefront widgets to be able to hand off the cart data and then handle the data that the external system returns.

  • Customize the system to be able to transform the Commerce Cloud data into the form required by the payment provider.

This chapter describes how to integrate with a web checkout system. This process requires using the initiate and retrieve gateway transaction types to process the cart, and authorization to complete the order. See Supported payment methods and transaction types for information about these transaction types.


Copyright © 1997, 2017 Oracle and/or its affiliates. All rights reserved. Legal Notices