Order Management System (OMS) reached end of support in October 2024.
The documentation available here is intended for historical reference only and is not maintained.
For other Commerce-related documentation, see Adobe Commerce Documentation.

Payment

The Magento Order Management System (OMS) can handle payments via Custom payment integrations or the Offline method.

Custom payment integrations (captures and refunds), as well as any other payment notifications, will be requested by the OMS. The sales channel is responsible for taking authorizations at the time of checkout. After successful authorizations a token will be passed down to the OMS to avoid passing sensitive information, such as credit card numbers. All of these actions are completed using that token.

For offline payments, The OMS will not take any payment actions. The payment of orders is fully managed outside of the OMS.

Custom payment integrations

Custom payment integrations allow you to integrate with any payment service provider by adapting standard OMS messages to the format expected by the payment service provider. More details about the integration are available in our Custom Payment Integration page.

Custom integrations support the following features.

  • Capture of the amount

    • After the last shipment it will capture the amount of the shipped items (including the shipping costs), which may be less than the authorized amount (for cancelled items).
    • After X days, or after the last shipment, (the first event occurring):

      After X days the objective is to capture payment before the authorization expires (some cards like Carte Bleue In France expire after six days) even though the order is not yet shipped. A refund will be triggered if any lines are subsequently canceled.

      After the last shipment it will capture the amount of the shipped items, including the shipping costs, which may be less than the authorized amount (for canceled items).

    • Before the first shipment request is sent (a refund will be triggered if any lines are subsequently cancelled).
    • After each shipment (for multi-captures), it captures the amount of the shipped items once a day. For partially shipped orders, it captures the remaining amount right after the last shipment.
  • Refunds due to cancellations, appeasements or returns
  • Manual retries for failed refunds in the OMS Admin
  • Notifications of capture confirmations (may be multiple days depending on the payment method), which can be monitored if they are not received in a timely fashion

Offline method

Offline payments should be used if the payment process is already managed by an external system. Typical examples are marketplaces or B2B channels, which have their own payment processes.

See Offline payments for more info.

Payment event status

Payment events statuses available in your OMS include:

Payment Event Status Payment Events Description
AUTHORIZED Authorizations only Payment was authorized successfully.
DECLINED Authorizations only The OMS was not able to perform the payment operation due to a soft rejection (such as insufficient funds).
FAULT All payment events The OMS was not able to deliver the payment request to its destination, most usually due to a technical error. This status is picked by the systemic retry process.
FAILURE All payment events The OMS was not able to perform the payment operation, such as for a capture. When retry attempts are expired this status is also used.
PENDING All payment events The payment event will retried later through the Retry On Hold job. This is a recovery backdoor.
RECEIVED All payment events The OMS was able to deliver the payment request to its destination successfully.
REJECTED Authorizations only The OMS was not able to perform the payment operation due to a hard rejection (such as suspected fraud).
REVERSED All payment events A previously successful operation has been reversed, such as for chargebacks issued from the bank.
SUCCESS All payment events The OMS received a positive response for the initial payment request.

These different statuses can occur throughout the order flow of your OMS, depending on the used payment integration.

Testing

No matter the method, we recommend extensive testing in staging and production prior to opening to the public. Sufficient time should be allocated for this important activity. With payments, production is always different than staging, even in subtle ways, due to the way real credit cards and banks process transactions.