Skip to content

Go further with Magento 2

Last updated: 20th May 2022

There are a number of ways you can extend your Magento 2 integration so that it suits all your business needs.

In this guide, you'll find how to:


Add more payment methods

In order to start accepting an alternative payment method, we first need to enable it on your account. Please contact your Customer Success Manager or our Sales team to get started.

We currently support the following payment methods on Magento 2:

Check the individual payment method pages to see which ones you can support. It will depend on your location, as well as the currency and billing address of your customer.

Enable alternative payments

  1. Sign in to your Magento Admin Panel and go to Stores > Configuration > Sales > Payment Methods.
  2. Find the Checkout.com plugin, select Configure and expand Alternative Payments.
  3. Specify the Title customers will see when they select an alternative payment method.
  4. Set Enable Alternative Payments to Yes.
  5. Select the payment methods you want to support.
  6. Select Save Config.

Apple Pay

See our Apple Pay documentation for more information.

  1. Sign in to your Magento Admin Panel and go to Stores > Configuration > Sales > Payment Methods.
  2. Find the Checkout.com plugin, select Configure and expand Apple Pay Payments.
  3. Specify the Title customers see when they select this payment method.
  4. Set Enable Apple Pay to Yes.
  5. If you want to add an Apple Pay button to your shopping basket page, so your customers can choose to check out via Apple Pay from their cart, set Enable Apple Pay On Cart Page to Yes.
  6. Enter your Merchant ID. You can find this in your Apple Developer account.
  7. Enter the absolute path of your payment processing certificate (for example, mywebsite/app/checkout/certificate.pem). To get this, find your certificate (a .pem file) in your Apple Developer account and then upload it to your server.
  8. Enter the absolute path of your merchant identity certificate key (for example, mywebsite/app/checkout/certificate_key.key). To get this, find your key (a .key file) in your Apple Developer account and then upload it to your server.
  9. Enter your processing certificate password, if you have one.
  10. Choose the appearance of the Apple Pay button. See the Apple Developer docs for more detail.
  11. Under Supported Networks, select the card networks you want to allow through Apple Pay.
  12. Under Merchant Capabilities, select the type of cards you want to allow.
  13. Select Save Config.

Google Pay

See our Google Pay documentation for more information.

  1. Sign in to your Magento Admin Panel and go to Stores > Configuration > Sales > Payment Methods.
  2. Find the Checkout.com plugin, select Configure and expand Google Pay Payments.
  3. Specify the Title customers see when they select this payment method.
  4. Set Enable Google Pay to Yes.
  5. If you want to enable 3DS for Google Pay, set Use 3D Secure to Yes.
  6. Select your Google Pay environment – either Test or Production. Note: This is not the same as the Checkout.com environment setting.
  7. Enter your Merchant ID. You can find this in your Google payments profile. If testing, use 01234567890123456789. Note: Make sure you use the right merchant ID for your chosen Google Pay environment.
  8. Choose the appearance of the Google Pay button. See the Google Pay docs for more detail.
  9. Under Supported Networks, select the card networks you want to allow through Google Pay.
  10. Select Save Config.

Enable 3D Secure payments

If you enable this feature, every transaction will trigger a 3D Secure (3DS) check. If you only want to trigger 3DS authentication for certain transactions, contact your Customer Success Manager.

  1. Sign in to your Magento Admin Panel and go to Stores > Configuration > Sales > Payment Methods.
  2. Find the Checkout.com plugin, select Configure and expand Card Payments.
  3. Make sure Enable Card Payments is set to Yes.
  4. Set Use 3D Secure to Yes.
  5. Select whether you want to attempt non-3D Secure transactions. If you select Yes, any cards that do not support 3DS will go through without a 3DS check. If you select No, cards that do not support 3DS will be blocked.
  6. Select Save Config.

Enable payments with saved cards

  1. Sign in to your Magento Admin Panel and go to Stores > Configuration > Sales > Payment Methods.
  2. Find the Checkout.com plugin, select Configure and expand Card Payments.
  3. Set Save Card Option to Yes if you want to allow your customers to save their cards for future payments. They can then use the same card on your website without re-entering the details.
  4. Next, expand Saved Card Payments.
  5. Set Vault Enabled to Yes.
  6. Specify the Title customers see when they choose to pay with a saved card.
  7. Set Use 3D Secure to Yes if you want saved cards to go through 3D Secure authentication.
  8. Select whether or not you want to attempt non-3D Secure transactions for saved cards. If you select Yes, any saved cards that do not support 3DS will go through without a 3DS check. If you select No, saved cards that do not support 3DS will be blocked.
  9. Set Require CVV for saved cards to Yes if you want the customer to enter the three (or four) digit CVV when they pay with a saved card. This provides additional security against fraud. Select No if you're happy for the customer to pay with a saved card without entering the card's CVV.
  10. Select Save Config.

Enable MOTO payments

These settings allow the administrator of your account to carry out mail order / telephone order (MOTO) payments on your customers' behalf.

  1. Sign in to your Magento Admin Panel and go to Stores > Configuration > Sales > Payment Methods.
  2. Find the Checkout.com plugin, select Configure and expand MOTO Payments.
  3. Set MOTO Enabled to Yes if you want to allow your administrator to carry out MOTO payments.
  4. Specify what Title you want your customers to see when they select the MOTO payment option.
  5. Set Saved Cards Enabled to Yes if you want to allow your administrator to make MOTO payments using customers' saved cards.
  6. Select Save Config.

Card payment options

To find these settings, sign in to your Magento Admin Panel and go to Stores > Configuration > Sales > Payment Methods. Find the Checkout.com plugin, select Configure and expand Card Payments.

Payment option title

Allows you to specify what title the customer will see when they choose to pay by card.

Display card icons

Set to Yes if you want to display card scheme logos to customers, and then select the particular scheme logos you want to display.

Payment form layout

Select your preferred layout for the payment form. Single iframe displays a one-line payment form. Multiple iframes displays a payment form of three fields. See our Frames customization guide for more information.

Payment form styles

Allows you to customize the payment form's look and feel. You can add CSS styles in JSON format to alter the form's appearance. For example: {"base":{"color":"blue","fontSize":"18px"}}. See our Frames customization guide for more information.


General payment options

To find these settings, sign in to your Magento Admin Panel and go to Stores > Configuration > Sales > Payment Methods. Find the Checkout.com plugin, select Configure and expand Configuration > Global Settings.

Payment action

If you want to manually capture payments, rather than have payments automatically captured (the Authorize and Capture option), set Payment Action to Authorize. Payments will now be authorized, but you will need to manually capture the payment afterward.

Capture time

If you set the Authorize and Capture as the Payment Action, you can use the Capture Time setting to specify the delay (in hours) before the payment is captured. For example, 1.500 for capture after 1 hour and 30 minutes; 0.02 for capture after 72 seconds. We do not recommend setting a value lower than 0.02 (72 seconds).

Dynamic descriptor

This is an extra field that you can send to the issuer, appearing on the customer's bank statement as an additional description of the payment.

  1. Set Enable Dynamic Descriptor to Yes if you want to send this extra information. If not enabled, the shopper will just see your merchant name as it appears in your Dashboard account.
  2. Specify the Descriptor Name. This is the first line of the descriptor, usually your merchant name. You can use up to 25 characters.
  3. Specify the Descriptor City. This is the second line of the descriptor, usually the city of your merchant address. You can use up to 13 characters.

Manually capture, void and refund payments

As well as doing so through the Dashboard, you can also manually capture, void, and refund payments from the Magento Admin Panel. These actions will show in both Magento and the Dashboard.

Manually capture payment

  1. Sign in to your Magento Admin Panel and go to Stores > Configuration > Sales > Payment Methods.
  2. Find the Checkout.com plugin, select Configure and expand Configuration > Global Settings.
  3. Make sure Payment Action is set to Authorize.
  4. Once you've created an order, find it in Sales > Orders in your Magento Admin Panel. It should have a Pending Payment status. Select View.
  5. Select Invoice.
  6. Select Submit Invoice at the bottom of the page to complete and capture the payment.

Void payment

You can only void payments that have been authorized but not yet captured.

  1. Sign in to your Magento Admin Panel and go to Stores > Configuration > Sales > Payment Methods.
  2. Find the Checkout.com plugin, select Configure and expand Configuration > Global Settings.
  3. Make sure Payment Action is set to Authorize.
  4. Once you've created an order, find it in Sales > Orders in your Magento Admin Panel. It should have a Pending Payment status. Select View to open the order.
  5. Select Void to void the payment.

Refund a payment

If refunding through Magento, we recommend you do so through the invoice for the order, rather than selecting Credit Memo from the order view. The latter only gives you a Refund offline option, which will not record the refund in your Dashboard account.

  1. Once you've created an order, sign in to your Magento Admin Panel and find the order in Sales > Orders.
  2. If the payment was not captured automatically on authorization, capture the payment now. A captured payment will have a Processing status.
  3. Select View to open the order.
  4. Select Invoices, then select View to open the invoice.
  5. Select Credit Memo.
  6. Select the products you want to refund and select Refund (not Refund Offline).

Order settings

To find these settings, sign in to your Magento Admin Panel and go to Stores > Configuration > Sales > Payment Methods. Find the Checkout.com plugin, select Configure and expand Configuration > Order Settings.

Action on failed payment

Select the action you want to be taken on orders with failed payments. We recommend you choose Cancel the order. This will cancel the order where the payment fails, but still record it so you have a trace of all failed orders. If you choose Delete the order, it will delete any trace of the failed order, leaving no record of it.

Order confirmation email

Select at what point you want to send the customer an order confirmation email. Authorize will send an order confirmation email to the customer as soon as the payment is authorized. Authorize and Capture will send it only after the payment has been both authorized and captured.

Order statuses

These settings allow you to edit the order statuses in line with the status of the payment. They are automatically set to Magento's default values, so be aware that editing them may cause problems with the order flow.