You are browsing the documentation for version 1.6 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Available in OroCommerce

Payment Configuration

To facilitate global B2B sales, OroCommerce administrator enables valid payment methods for particular locations and integrates local payment providers or the best payment options whenever it is possible.

When submitting an order, the customer may have several payment options to choose from. They depend on the payment address that is collected at the checkout. Once an address is provided, OroCommerce evaluates payment methods against the special payment rules and exposes only the options recommended for the particular location and/or based on other order details. After the customer user has selected the payment method, they are prompted to enter payment details and proceed to the checkout.

Depending on the payment method, payment may be processed immediately or may be delayed for the pre-configured period of time, or until a particular event (e.g. until the order is ready for delivery).

After the payment details were provided, the sales person can view the payment history, and capture the delayed payment.

When the payment term is selected, the payment is considered to be captured in full and the payment information is not available.


See a short demo on how to create payment method integrations or keep reading the step-by-step guidance below.

Before You Start

  1. Create a Payment Integration

    To bind any payment method to the checkout process, you first need to create an integration with a payment service that you select. For instance, to be able to provide net terms for customers, you need to create a payment terms integration first. The same goes for check/money orders, or any external payment services.

  2. Set a Merchant Location

    Before proceeding to create a payment integration, make sure that you have selected your merchant location. A merchant location is a system-wide setting that applies to all websites.

  3. Create a Payment Rule

    Once the integration is created and a payment method is added, you need to add a payment rule to make this payment option visible to the buyer in the storefront. When this is done, the buyer in the storefront can proceed through the checkout.

Payment Methods and Providers

In OroCommerce, payment methods are conditions required for a sale to be completed. These can include cash in advance, money orders, authorized payment apps like PayPal, and more.


For common payment method integration details, please have a look at the following article:

The list of payment methods that OroCommerce supports is listed below. Click on the links below to open the overview page of each supported payment service.

Related Topics