How to Integrate Payment Gateway in Shopify & Ensure Secure Transactions

To integrate a payment gateway in Shopify, open Settings, select Payments, then activate Shopify Payments or connect a third-party provider with its account credentials. Shopify Payments requires a US checking account, an EIN or SSN, and two-step authentication, and adds no extra Shopify fee. Third-party gateways add a 0.2% to 2% Shopify fee on top of their own rates. Only one third-party card provider can be active at a time. Test with a test order, then go live.

What Is a Payment Gateway in Shopify?

A payment gateway is a technology that securely transmits payment information from checkout to the payment provider for authorization. The payment provider then processes the transaction and returns an approval or decline response to Shopify.

Shopify Payments is Shopify’s built-in payment provider, while Shopify also supports more than 100 third-party credit card payment providers. Available providers and payment methods vary by your store’s country or region. Without one, a customer can fill a cart but cannot pay.

How a Shopify Payment Gateway Works

A Shopify payment gateway processes a transaction through these steps:

1. Customer enters payment details at checkout.
2. The gateway encrypts the information and sends the payment request.
3. The payment processor routes the request to the card network and the customer’s bank.
4. The bank approves or declines the transaction.
5. Shopify updates the order status based on the payment response.

Once the payment is approved and captured, the provider settles the funds according to its payout schedule.

For US stores using Shopify Payments, the minimum settlement time is 3 business days. After Shopify sends the payout, banks typically require an additional 24–72 hours to process and deposit the funds. Payout timing and settlement requirements vary by location and account circumstances.

Payment Gateway vs. Payment Processor

The gateway captures and secures the card data. The processor carries the request between card networks and banks so the payment can be authorized and settled. A merchant account receives the settled funds before they move to your business bank account.

Term	What it does
Payment gateway	Collects payment details, encrypts transaction data, and sends payment requests for approval
Payment processor	Routes transaction requests between card networks and banks for authorization
Merchant account	Receives processed funds before they are transferred to your bank account

Shopify Payments manages these functions together, so merchants do not need to configure them separately.

Shopify Payments vs. Third-Party Payment Providers

Shopify Payments fits most US stores. Third-party payment providers fit stores that can’t qualify for Shopify Payments or already hold a provider contract.

Payment Factor	Shopify Payments	Third-party provider
Setup	Verify identity and bank account in Shopify admin	Open an account with the provider, then enter its credentials in Shopify
Merchant account	Not needed	Depends on the provider
Extra Shopify fee	None	2% (Basic), 1% (Grow), 0.6% (Advanced), lower on Plus
Card processing rate	2.5% to 2.9% + 30¢ online, by plan (Plus: from 2.25% + 30¢)	Set by the provider
Payout timing	3 business day minimum settlement in the US, on a daily, weekly, or monthly schedule	Set by the provider
Checkout	On your store	On your store (direct) or a hosted page (external)
Shop Pay	Built in	Only through Shopify Payments running alongside
US availability	50 states and Puerto Rico, US checking account required, prohibited business types excluded	Varies by provider. Stripe is not offered as a standalone provider in the US

Third-party providers come in two types. A direct provider takes payment on your own checkout page. An external provider sends the customer to a checkout hosted outside your store.

You can also run Shopify Payments alongside one direct third-party provider. The third-party provider handles cards. Shopify Payments handles Shop Pay, local payment methods, and retries failed card payments. Shopify charges its third-party transaction fee on the provider’s sales, and Shopify Payments rates plus a 1.25% premium on what Shopify Payments handles.

What to Consider Before Setting Up a Shopify Payment Gateway

Six factors decide which gateway fits your store: where it works, which payment methods it supports, what it costs, how fast you get paid, how it handles security, and what it takes to connect. Check each one before you enter any credentials.

Availability in Your Country or Region

Your store address decides which gateways you can use. Shopify filters the provider list by the address in Settings > General, so a missing provider usually means an address mismatch.

For US stores:

• Shopify Payments supports business addresses in the 50 states and Puerto Rico. Guam, the US Virgin Islands, and other territories are not supported.
• You need a US checking account in USD that accepts ACH. Savings and wire-only accounts are rejected.
• Some business types are prohibited. Check the list in the Shopify Payments Terms of Service.
• Stripe is not offered as a standalone provider because it is Shopify Payments’ banking partner. If you can’t qualify for Shopify Payments, choose another provider that supports your business type.

Is Shopify Payments Available in Your Country?

Shopify Payments is available only in a limited list of countries, and that list changes over time. Check the supported countries list in the Shopify Help Center before you plan your setup. The requirements above (US bank account, EIN or SSN) apply to US stores only. Other countries have their own identity and bank account requirements.

Your situation	What to do
Store is in a Shopify Payments country	Activate Shopify Payments, then verify your identity and bank account for payouts
Store is in a country where Shopify Payments is not offered	Choose a third-party provider that supports your country, currency, and business type
You sell to customers in the UK or EU	Make sure your setup supports 3D Secure and Strong Customer Authentication (SCA), which many banks require
You sell in multiple currencies	Check currency conversion fees and which payment methods appear for each market

Supported Payment Methods

Shopify Payments in the US accepts Visa, Mastercard, American Express, Discover, and Diners Club cards. Apple Pay, Google Pay and Shop Pay switch on automatically.

Local payment methods need manual activation and appear based on the customer’s location, not yours. The US options are Bancontact (Belgium), iDEAL | Wero (Netherlands), MB WAY (Portugal), and Satispay (Italy). USDC is supported unless your business is based in Arkansas, New York, Pennsylvania, or Texas.

PayPal depends on your setup. With Shopify Payments active in the US, PayPal Wallet runs through it, with rates starting at 3.49% + 49¢. Without it, PayPal Express Checkout is set up under Additional payment methods.

Manual methods such as cash on delivery and bank transfer carry no transaction fees when you use Shopify Payments. With a third-party provider, Shop Pay is available only if Shopify Payments runs alongside it.

Transaction Fees and Other Costs

Two fees can apply: the card processing rate and Shopify’s third-party transaction fee, which applies only when you use a third-party provider.

Plan	Standard card rate (online)	Premium card rate (online)	Third-party transaction fee
Basic	2.9% + 30¢	3.5% + 30¢	2%
Grow	2.7% + 30¢	3.3% + 30¢	1%
Advanced	2.5% + 30¢	3.1% + 30¢	0.6%
Plus	2.25% + 30¢	2.95% + 30¢	0.2%

International cards add 1%. Shopify calculates its third-party fee on the order total: products minus discounts, plus tax and shipping. On the Basic plan, a $100 order costs $3.20 with Shopify Payments. With a third-party provider charging the same 2.9% + 30¢ (a hypothetical rate), it costs $5.20, because Shopify adds $2.00.

Other costs to know:

• Shopify charges nothing to integrate a gateway. Each provider sets its own fees.
• Third-party transaction fees are not returned when you refund an order.
• Stores created on or after May 12, 2025 pay third-party fees on the store credit or gift card portion of an order, even on Shopify Payments.
• Running Shopify Payments alongside a third-party provider adds a 1.25% premium on what Shopify Payments processes.
• Selling in a non-domestic currency adds a 1.5% conversion fee on Shopify Payments in the US, and 3% on PayPal Wallet.
• On any plan, stores that use Shopify Payments as their only provider pay no third-party transaction fee.

Payout Schedule and Settlement

US Shopify Payments has a 3-business-day minimum settlement and no minimum payout amount. The bank can take 1 to 3 more days to show the deposit. You choose a daily, weekly, or monthly schedule. Payments captured Friday through Sunday are grouped into one payout.

Shopify routes payouts through several processing partners, so some arrive earlier than scheduled, and more than one can arrive in a day. A Shopify Balance account can receive payouts within 1 business day (up to 5 for new merchants).

Four things delay payouts:

• Adding a new bank account more than 24 hours after setup pauses payouts for 3 to 5 business days.
• Reserves can hold part of your funds against disputes and refunds.
• Higher-risk accounts can be placed on 5 to 20 business day schedules.
• ACH direct debit payments can take up to 4 business days to settle.

With a third-party provider, the provider sets payout timing. Ask about reserves and holds before you sign up.

Security and Compliance Capabilities

Shopify Payments applies fraud detection and encryption, including 3D Secure, and requires two-step authentication on your account. Built-in fraud analysis requires Shopify Payments. Shopify states that it is certified Level 1 PCI DSS compliant and that stores on Shopify are PCI compliant by default. Its compliance reports are public in the Help Center.

Shopify Protect is free chargeback protection for fraud-based chargebacks on eligible Shop Pay orders. It needs a US store with a US Shopify Payments account, and the order must be fulfilled with tracking within 7 days. For a third-party provider, check its own PCI documentation, 3D Secure support, and dispute handling.

Integration Requirements

Before connecting a third-party provider, have these ready:

• Owner access: only the store owner can add or change a payment provider.
• Provider account: verified business and bank details, plus the credentials or API keys it issues.
• Matching address: your store address must fall in a country the provider supports.
• Provider type: direct (payment on your checkout) or external (redirect to a hosted page).
• One card provider: only one credit card provider can be active at a time. Keep the old provider’s credentials until you finish refunds on its orders.
• Feature fit: confirm support for subscriptions, in-person sales, and the currencies you sell in.
• A test route: Shopify Payments test mode, Shopify’s Test payment gateway, or the provider’s test mode. All need a paid plan.

For Shopify Payments, you need two-step authentication, an EIN or SSN/ITIN, and identity documents if Shopify asks for them. Businesses evaluating payment options can use Shopify consulting services to make informed decisions before setup.

How to Set Up a Payment Gateway in Shopify

Before connecting a payment gateway, make sure you have a verified payment provider account and the required business details ready. Shopify lets you activate Shopify Payments or connect a supported third-party provider from the Payments settings.

Step 1: Open Shopify Payment Settings

1. Log in to your Shopify admin.
2. Go to Settings → Payments.
3. Review the available payment providers for your store.

Step 2: Activate Shopify Payments or Connect a Third-Party Provider

Option 1: Shopify Payments	Option 2: Third-Party Payment Gateway
Select Shopify Payments.	Select your preferred provider from the available options.
Complete the account setup.	Connect an existing provider account or create a new one.
Enter your business and banking details.	Enter the required account credentials.
Submit required verification information.	Complete the authorization process.
Enable available payment methods.	Install the provider app if required.

Step 3: Configure Payment Settings

After connecting the gateway, review available settings based on your provider:

• Enable supported payment methods.
• Configure payment capture settings.
• Review fraud prevention controls.
• Enable authentication options supported by the provider.

Step 4: Test the Payment Gateway

Before accepting real payments, run test transactions to verify:

• Successful payments
• Declined payments
• Failed transactions
• Refund processing
• Payment confirmation emails
• Order status updates

Also check the checkout experience on both mobile and desktop devices.

Step 5: Enable Live Payments

Once testing is complete:

• Disable test mode.
• Confirm the payment provider is active.
• Place a final live transaction if required. Use a low-priced product, then refund or cancel the order afterward so it doesn’t affect your reports.
• Verify that orders and payments appear correctly in Shopify admin.

Setting up a payment gateway in Shopify involves connecting your provider, configuring payment settings, testing transactions, and confirming that checkout works correctly.

Completing these steps before launch helps prevent payment failures and ensures customers can complete purchases without issues. For connecting payment platforms with other business systems, a Shopify integration service can help manage complex connections.

How to Test a Shopify Payment Gateway Before Going Live

Testing a payment gateway before launch helps you catch checkout issues before customers do. A complete test should verify payment processing, order creation, refunds, and customer notifications.

How to Run Each Test

Turn on test mode for Shopify Payments (in the Shopify Payments settings under Settings > Payments), or use Shopify’s Bogus Gateway or your provider’s test mode. Then use the test cards below at checkout with any future expiry date and any three-digit security code.

Scenario	Test card number	Expected result
Approved payment	4242 4242 4242 4242	Order is created and marked paid
Declined payment	4000 0000 0000 0002	Checkout shows a decline message, and the customer can retry
Bogus Gateway: approved	1	Order is created and marked paid
Bogus Gateway: declined / error	2 (declined), 3 (error)	Checkout shows a failure or error message

Always cancel and refund test orders afterward. Confirm the exact test card numbers in the Shopify Help Center, as they can change.

Test Successful Transactions

Place a test order using Shopify’s test mode or your payment provider’s test environment to confirm that payments are processed correctly.

Verify:

• Payment is approved successfully
• Order is created in Shopify admin
• Payment status updates correctly
• Customer receives an order confirmation

Test Failed and Declined Payments

A payment gateway should handle unsuccessful transactions correctly. Test declined payments to confirm that customers receive clear error messages and can retry checkout.

Check:

• Declined card responses
• Failed payment messages
• Retry payment options
• Order status after failed attempts

Verify Refund Processing

Test the refund process to ensure completed payments can be returned correctly.

Confirm:

• Refund requests are processed
• Order status updates after refund
• Customer receives refund confirmation
• Refund records appear correctly in Shopify

Check Payment Status Updates

Confirm that payment updates from the gateway are reflected accurately in Shopify.

Review:

• Authorized payments
• Captured payments
• Failed payments
• Refunded transactions

This helps prevent mismatches between payment provider records and Shopify orders.

Test Different Devices and Payment Methods

Test checkout across different devices and supported payment methods to ensure a consistent customer experience.

Verify:

• Mobile checkout
• Desktop checkout
• Different browsers
• Available payment options
• Currency display

Testing your Shopify payment gateway before launch helps catch transaction errors, checkout issues, and payment status problems early. Once all payment scenarios work correctly, the store is ready to accept live transactions.

Common Shopify Payment Gateway Issues and How to Fix Them

Payment gateway issues can prevent customers from completing purchases or delay payment processing. Most problems are related to provider settings, account verification, payment configuration, or communication between Shopify and the payment provider.

Payment Gateway Is Not Showing in Shopify

A payment gateway may not appear in Shopify if it is unavailable for your store location, unsupported for your business type, or if your account information does not meet provider requirements.

Check:

• Store location and business details
• Provider availability in your region
• Account verification status
• Shopify payment settings
• Whether the address in Settings > General matches the country of your bank account and the provider’s supported countries.

If the provider is supported but still unavailable, contact the payment provider for account-specific issues.

Payment Provider Is Not Connecting

Connection issues usually occur when provider credentials are incorrect, the account setup is incomplete, or required permissions are missing.

To fix this:

• Verify provider login details
• Confirm the account is approved
• Reconnect the payment app if required
• Check for provider-side service issues

Customer Payment Is Declined

A declined payment can happen because of incorrect customer details, insufficient funds, bank restrictions, or fraud checks.

Before troubleshooting technical issues:

• Confirm the payment details entered by the customer
• Check whether the decline is from the bank or payment provider
• Review fraud settings if legitimate payments are being blocked

Payment Is Successful, but Order Status Is Incorrect

This issue occurs when Shopify does not receive the correct payment update from the provider.

Check:

• Payment status in Shopify admin
• Provider transaction status
• Webhook or app connection settings
• Order timeline updates

If the payment is confirmed but Shopify does not update the order, contact the provider.

Payment Is Pending or the Authorization Expired

If your capture setting is manual or on fulfillment, the card authorization can expire before you capture it, and the payment fails. Capture payments within the authorization window, or switch to automatic capture at checkout. If an authorization has expired, ask the customer to pay again with a new order or payment link.

Refund Is Not Processing

Refund delays can happen due to provider processing times, account restrictions, or incorrect refund steps.

Check:

• Whether the payment was captured
• Whether the refund was initiated through Shopify or the provider
• Provider refund timelines
• Available refund balance

Payout Is Delayed or on Hold

Payout delays may occur because of account reviews, risk checks, bank issues, or provider-specific policies.

Review:

• Payout status in Shopify admin
• Provider notifications
• Bank account details
• Any pending verification requests

Shopify Payments Account Is Restricted or Under Review

Shopify may restrict an account that needs more verification, or that shows unusual activity. Open the notice in your admin, upload the documents requested, and confirm that your business details and bank account match your legal records. Respond promptly, because payouts can stay on hold until the review is complete.

Payment Gateway Integration Stops Working

A payment gateway may stop working after app updates, account changes, provider outages, or configuration changes.

Check:

• Provider status page
• Recent Shopify or app changes
• Payment settings
• Provider connection status

If the issue continues, involve the payment provider support team.

After you connect a payment gateway, issues can still occur because of account settings, provider limitations, checkout problems, or transaction errors. Identifying the cause helps merchants restore payment functionality quickly and avoid unnecessary checkout disruptions.

How to Secure Your Shopify Payments and Reduce Fraud

Choosing a secure gateway is only part of protecting your checkout. These settings and habits reduce fraud and chargebacks:

• Turn on two-step authentication for every staff account, and give staff only the permissions they need. Limit who can change payment settings.

• Use Shopify’s fraud analysis on each order. Review orders flagged as medium or high risk before you fulfill them.

• Check the card verification settings (CVV and address verification) in your payment provider settings, and decide how to treat mismatches.

• Keep 3D Secure enabled. Many banks require it for customers in the UK and EU (SCA), and it shifts liability for fraudulent chargebacks in many cases.

• Be cautious with large orders, rush shipping requests, and mismatched billing and shipping addresses.

• Keep your apps and theme updated, and remove apps that no longer need access to your checkout or customer data.

Best Practices for Managing Shopify Payment Gateways

Managing a payment gateway requires regular monitoring to maintain successful transactions, accurate payouts, and a smooth checkout experience.

Monitor Payment Success and Failure Rates

Track successful and failed transactions regularly to identify unusual drops in payment acceptance. A sudden increase in failures may indicate checkout issues, provider problems, or customer payment restrictions.

Track Refunds, Chargebacks, and Disputes

Keep records of refunds, chargebacks, and disputes to understand payment-related losses and resolve customer issues faster.

Review:

• Refund status
• Dispute deadlines
• Chargeback reasons
• Supporting transaction details

Monitor Payouts and Reconciliation

Regularly compare Shopify order records with payout reports to ensure received payments match completed transactions.

Check:

• Payout amounts
• Transaction fees
• Refund deductions
• Settlement records

Review Payment Methods Regularly

Review available payment methods based on customer preferences and store requirements. Remove unsupported options and enable methods that help customers complete purchases easily.

Keep Provider and Account Information Current

Update business details, bank information, and provider account details whenever changes occur. Outdated information can affect payment processing or delay payouts.

Regular monitoring helps merchants identify payment issues early, maintain accurate records, and keep the checkout experience reliable. Reviewing gateway performance periodically ensures payment operations continue to support business needs.

If your business has a unique platform and payment needs, custom Shopify development services make sense.

FAQS on Shopify Payment Gateway