Table of Contents

How to Configure Magento Payment Methods

Payment methods are a critical part of every Magento store. A properly configured payment system allows customers to choose how they want to pay while giving store owners a secure and reliable way to collect payments.

Magento supports several payment options, including offline payment methods and integrations with online payment gateways. The exact payment methods available depend on your Magento version, installed extensions, country, currency, and payment provider.

In this guide, you will learn how to configure payment methods in Magento and prepare them for your online store.

Why Configure Payment Methods in Magento?

A well-configured payment system helps you:

Accept payments from customers.
Provide multiple payment options.
Reduce checkout friction.
Support different currencies and countries.
Process payments securely.
Control payment availability based on store requirements.
Configure payment instructions for offline methods.

Before enabling a payment method, always verify that it is supported by your payment provider and available in your target market.

Before You Configure Payments

Before configuring payment methods, prepare the following:

Magento Admin access.
A working Magento store.
Correct store currency settings.
A payment gateway account if using an online provider.
API credentials or merchant credentials when required.
HTTPS/SSL configured for your storefront.
A test environment for testing payment transactions.

For third-party payment gateways, follow the provider’s current Magento integration instructions because credentials and configuration requirements can vary.

Step 1: Open Payment Configuration

Navigate to:

Stores → Configuration

In the left-hand menu, expand:

Sales

Then select:

Payment Methods

Magento will display the available payment configuration sections.

If your installation uses multiple websites or stores, select the appropriate configuration scope before making changes.

Step 2: Select the Configuration Scope

At the top of the configuration page, Magento provides a scope selector.

Depending on your installation, you may have:

Global
Website
Store
Store View

Choose the website or store where you want the payment configuration to apply.

This is particularly important when operating multiple Magento websites with different payment requirements.

Step 3: Configure the General Payment Settings

Before configuring individual payment methods, review the general payment-related settings available in your Magento installation.

Important settings can include:

Merchant location
Applicable countries
Allowed currencies
Payment action
Checkout behavior

The exact options depend on your Magento version and installed payment modules.

Make sure your merchant location and currency configuration match your business requirements.

Step 4: Configure Cash on Delivery

Cash on Delivery (COD) allows customers to pay when their order is delivered.

To configure it, locate:

Cash On Delivery Payment

Expand the section.

Set:

Enabled → Yes

You may also configure settings such as:

Title
New Order Status
Payment from Applicable Countries
Instructions
Minimum Order Total
Maximum Order Total
Sort Order

Example

You could configure the method as:

Title: Cash on Delivery
Applicable Countries: Specific Countries
Instructions: Pay cash when your order is delivered.

Click Save Config after making the changes.

Step 5: Configure Bank Transfer Payment

Magento can also support Bank Transfer Payment for customers who prefer direct bank payments.

Locate:

Bank Transfer Payment

Enable the method and configure the available options.

You can provide payment instructions such as:

Bank Name: Example Bank
Account Name: Example Store
Account Number: XXXXXXXX
IFSC/SWIFT: XXXXX

Use your actual business banking information when configuring the method.

Security Consideration

Only display banking information that you are comfortable providing to customers. Avoid placing sensitive account credentials or confidential information in checkout instructions.

Step 6: Configure Check or Money Order

Magento can also provide a Check / Money Order payment method.

This option can be useful for businesses that accept traditional offline payments.

Open:

Check / Money Order

Then configure:

Enabled
Title
New Order Status
Payment from Applicable Countries
Make Check Payable To
Send Check To
Minimum Order Total
Maximum Order Total
Sort Order

After entering the required information, save the configuration.

Step 7: Configure Purchase Order

The Purchase Order payment method can be useful for business-to-business stores where customers are allowed to pay using an approved purchase order.

Enable the method if it matches your business model.

You may need additional customer permissions, company functionality, or custom workflows depending on your Magento setup.

Step 8: Configure a Third-Party Payment Gateway

For online card and digital payments, Magento stores commonly use third-party payment gateways.

Examples include payment services that support:

Credit and debit cards
Digital wallets
Bank payments
Local payment methods
Recurring payments

The exact gateway available to you depends on your country and business requirements.

A typical third-party gateway setup involves:

Creating a merchant account.
Installing the provider’s Magento module if necessary.
Obtaining API keys or merchant credentials.
Opening Stores → Configuration → Sales → Payment Methods.
Enabling the payment method.
Entering the required credentials.
Selecting the payment environment.
Configuring payment actions.
Saving the configuration.
Testing a transaction.

Step 9: Use Test or Sandbox Mode

If your payment provider supports a sandbox or test environment, use it before accepting real customer payments.

A typical testing workflow is:

Magento Store
      ↓
Payment Gateway
      ↓
Sandbox/Test Environment
      ↓
Test Transaction
      ↓
Verify Magento Order

Test the complete checkout process rather than simply checking whether the payment method appears.

Verify:

Order creation
Payment status
Invoice creation
Transaction ID
Customer confirmation email
Order status
Refund workflow

Step 10: Configure Payment Actions

Some payment gateways provide payment action settings such as:

Authorize

The payment is authorized but not necessarily captured immediately.

Authorize and Capture

The payment is authorized and captured as part of the transaction.

The appropriate option depends on your payment provider and business workflow.

Do not select a payment action without understanding how your gateway handles authorization, capture, cancellation, and refunds.

Step 11: Configure Applicable Countries

Many payment methods allow you to determine where they are available.

You may see options such as:

All Allowed Countries

or:

Specific Countries

Choose the option that matches your business requirements.

For example, if your payment provider only supports customers from selected countries, choose the specific-country option and select the supported locations.

Step 12: Configure Minimum and Maximum Order Amounts

Some Magento payment methods allow you to define order-value limits.

For example:

Minimum Order Total: 500
Maximum Order Total: 50,000

This can be useful for methods such as Cash on Delivery.

Orders outside the specified range will not be able to use that payment method.

Step 13: Set the Payment Method Sort Order

Magento allows you to control the order in which payment methods appear during checkout.

For example:

1. Credit/Debit Card
2. UPI or Local Payment Gateway
3. Cash on Delivery
4. Bank Transfer

The exact order depends on your enabled payment methods.

Put your preferred or most commonly used payment methods near the top.

Step 14: Save the Configuration

After making your changes, click:

Save Config

Magento may require cache refreshes after configuration changes.

If the new payment method does not immediately appear at checkout, review the configuration scope and cache settings.

Step 15: Test the Checkout

Testing is one of the most important steps.

Open your storefront and add a product to the cart.

Proceed to checkout and verify that the expected payment methods appear.

Test the complete process in a safe environment before accepting live payments.

Check:

Payment method visibility.
Required fields.
Successful payment.
Failed payment.
Order creation.
Invoice status.
Customer email.
Admin order status.
Refund behavior.

Common Magento Payment Problems

Payment Method Does Not Appear

If a payment option does not appear during checkout, check:

Whether it is enabled.
Configuration scope.
Allowed countries.
Allowed currencies.
Minimum and maximum order totals.
Store or website assignment.
Payment gateway credentials.
Extension configuration.

Payment Is Declined

A payment can be declined by the gateway for many reasons.

Check:

Gateway account status.
API credentials.
Transaction logs.
Currency support.
Card or payment method restrictions.
Sandbox/live configuration.

Contact the payment provider if Magento configuration appears correct but transactions are still being declined.

Payment Method Appears but Checkout Fails

Check browser errors, Magento logs, payment gateway logs, and extension configuration.

If you recently installed or updated a payment extension, verify that it is compatible with your Magento version.

Customers Cannot Use a Specific Currency

Payment providers may support only certain currencies.

Check your Magento currency configuration and confirm that the payment gateway supports the selected currency.

Payment Works in Test Mode but Not Live Mode

Verify that:

Live API credentials are correct.
Sandbox credentials have been replaced.
The gateway account is activated for live transactions.
The correct endpoint or environment is selected.
Required merchant verification has been completed.

Payment Security Best Practices

Payment configuration should always be treated as a security-sensitive task.

Follow these practices:

Use HTTPS throughout the storefront and checkout.
Keep Magento and payment extensions updated.
Use strong administrator passwords.
Restrict administrator access.
Never expose API credentials publicly.
Use sandbox mode for testing.
Follow your payment provider’s security requirements.
Monitor payment and Magento logs.
Avoid storing sensitive card information unless your payment architecture explicitly supports it and meets applicable requirements.

Whenever possible, use established payment providers that securely handle sensitive payment information.

How to Disable a Payment Method

If you no longer want to offer a payment option:

Go to Stores → Configuration.
Open Sales → Payment Methods.
Select the payment method.
Set Enabled to No.
Click Save Config.
Clear or refresh the relevant cache if required.
Test checkout to confirm that the method is no longer available.

Best Practices for Magento Payment Configuration

For a reliable checkout experience:

Offer payment methods your customers actually use.
Use a trusted payment gateway.
Test every payment method before going live.
Keep payment modules updated.
Use the correct configuration scope.
Verify supported currencies and countries.
Keep API credentials secure.
Test successful and failed transactions.
Monitor payment gateway logs.
Test refunds and cancellations.
Avoid enabling unnecessary payment methods.
Keep your Magento installation and extensions updated.

Frequently Asked Questions

Where are Magento payment methods configured?

Go to:

Stores → Configuration → Sales → Payment Methods

from the Magento Admin Panel.

Can Magento support multiple payment methods?

Yes. You can enable multiple payment methods and display them during checkout according to your store’s configuration.

Can I restrict a payment method to specific countries?

Yes. Many payment methods provide an Applicable Countries setting.

Can I set a minimum order amount for Cash on Delivery?

Yes, when the payment method provides minimum and maximum order total settings.

Should I test a payment gateway before going live?

Yes. If the provider offers a sandbox or test environment, test the complete checkout and payment workflow before processing real customer payments.

Why is my payment method not showing at checkout?

Common causes include disabled configuration, incorrect website scope, unsupported country or currency, order-total restrictions, missing gateway credentials, or an extension configuration problem.

Conclusion

Configuring payment methods correctly is essential for a successful Magento store. Magento provides several built-in offline payment options, while third-party payment gateways can extend the platform with online payment capabilities.

After configuring a payment method, always test the complete checkout workflow. Verify successful and failed transactions, order creation, invoices, notifications, and refunds before enabling the method for real customers.

A secure, well-tested payment configuration gives customers more convenient ways to pay while helping your store process orders reliably.

How to Configure Magento Payment Methods?