Paystack for Shopify: What Is Possible

Shopify handles payments differently from self-hosted platforms like WooCommerce. On WooCommerce, you install a plugin that gives you full control over the checkout flow. On Shopify, the checkout is a Shopify-owned experience. Third-party payment providers like Paystack plug into Shopify's payment processing pipeline, but Shopify remains in charge of the checkout page, the order flow, and the customer experience.

When a customer reaches your Shopify store's checkout and selects Paystack as the payment method, Shopify redirects them to Paystack's payment page. The customer completes the payment on Paystack's hosted page, and Paystack redirects them back to your Shopify store's order confirmation page. Shopify then updates the order status based on the payment result.

This is the redirect flow. Unlike WooCommerce, there is no inline popup option on Shopify. The customer always leaves your store briefly to complete payment on Paystack's page before returning. For most customers, this is seamless enough. But if you want the payment form embedded directly on your checkout page, Shopify does not offer that option for third-party payment providers.

This guide is part of the Paystack plugins and no-code integrations cluster.

Setting up Paystack on Shopify is straightforward. No plugin installation required because Shopify has Paystack listed as a supported payment provider for African markets.

Step 1: Log in to your Shopify admin. Go to Settings at the bottom of the left sidebar, then click Payments.

Step 2: Add a payment method. In the "Payment providers" section, click "Add a provider" or "Choose a provider." Search for Paystack in the list. Shopify lists third-party providers by region, so you may need to filter by your country.

Step 3: Enter your Paystack API keys. You will need your Public Key and Secret Key from the Paystack Dashboard (Settings > API Keys & Webhooks). Enter the test keys first if you want to test before going live.

Step 4: Activate Paystack. Click "Activate" or "Save." Paystack is now available as a payment option on your store's checkout.

Step 5: Test a transaction. Place a test order on your store. Select Paystack at checkout. Use Paystack's test card (4084 0840 8408 4081, any future expiry, CVV 408). Confirm that the order completes and appears in both your Shopify orders and your Paystack Dashboard.

Once testing passes, switch to live API keys. Your store is now accepting real payments through Paystack.

The payment channels available to your Shopify customers depend on your Paystack account's country and configuration, not on Shopify itself. Shopify passes the payment request to Paystack, and Paystack determines which payment options to show.

Nigeria: Cards (Visa, Mastercard, Verve), bank transfers, and USSD. Nigerian merchants see the widest range of payment options because Paystack's deepest integrations are with Nigerian banks.

Ghana: Cards and mobile money (MTN MoMo, AirtelTigo Money, Vodafone Cash). Mobile money is significant in Ghana, and Paystack supports the major providers.

South Africa: Cards. Paystack's South African offering is card-focused as of 2026.

Kenya: Cards and M-Pesa. M-Pesa is critical for Kenyan merchants since a large portion of online payments in Kenya flow through mobile money.

One thing to understand: the payment channels that appear on Paystack's hosted page are controlled by your Paystack Dashboard settings. If you want to disable a specific channel (for example, USSD), you do that in the Paystack Dashboard, not in Shopify. Shopify has no settings for controlling which Paystack payment methods are displayed.

This is where Shopify's model creates friction for merchants who want full control over their payment flow. When you use Paystack on Shopify, several things are locked down.

Checkout page design. Shopify owns the checkout page. You cannot add custom HTML, inject Paystack's inline JS, or modify the payment step's layout. The checkout looks like every other Shopify checkout, with Paystack appearing as a selectable payment method.

Webhook handling. Shopify receives the payment confirmation from Paystack and processes it internally. You do not configure a Paystack webhook URL for Shopify orders. If you need custom webhook handling (for example, to trigger provisioning in an external system), you use Shopify's own webhook system, not Paystack's.

Split payments and subaccounts. Paystack's split payment and subaccount features are not accessible through Shopify. If you run a marketplace and need to split each transaction between a seller and a platform fee, Shopify's checkout does not expose this capability. You would need a custom solution outside of Shopify.

Custom metadata. When you integrate Paystack directly, you can attach custom metadata to transactions (order IDs, user IDs, product categories). Shopify passes its own metadata to Paystack, and you cannot add custom fields. This can complicate reconciliation if you need to match Paystack transactions against data that Shopify does not include automatically.

Transaction fees. Shopify charges an additional transaction fee (typically 2%) for orders processed through third-party payment providers. This is on top of whatever Paystack charges. This fee does not apply if you use Shopify Payments (Stripe-powered), but Shopify Payments is not available in most African countries. Check Shopify's pricing page for your specific plan's third-party transaction fee.

Most Shopify-Paystack problems fall into a few categories.

"Payment provider not available" at checkout. This usually means your Shopify store's country setting does not match a country where Paystack is available. Shopify only shows Paystack as an option for stores registered in Nigeria, Ghana, South Africa, or Kenya. If your store is set to a different country (even if your Paystack account is Nigerian), Paystack will not appear. Check your Shopify store's address under Settings > Store Details.

Currency mismatch errors. Your Shopify store's currency must match your Paystack account's supported currency. A Nigerian Paystack account expects NGN transactions. If your Shopify store prices products in USD, the payment will fail. Set your store's currency to match your Paystack account, or use Shopify's currency conversion features to display prices in other currencies while settling in your local currency.

Payment succeeds on Paystack but Shopify order stays "Payment pending." This is rare but happens if the redirect callback from Paystack to Shopify fails (network timeout, browser issue). Shopify usually resolves this automatically through its internal payment verification, but it can take a few minutes. If the order is still pending after 15 minutes, check the Paystack Dashboard to confirm the payment was successful, then manually mark the order as paid in Shopify.

Test transactions appearing as real orders. Make sure you switch between test and live API keys correctly. If you enter test keys and process a test transaction, it appears as a real order in Shopify. Cancel or archive these test orders to avoid confusion.

This is the question most African e-commerce merchants eventually ask: should I use Shopify with Paystack, or should I use WooCommerce with Paystack?

Choose Shopify when:

• You want a fully managed platform with hosting, security, and updates handled for you.
• Your payment flow is simple: customer adds to cart, pays, you fulfill the order.
• You do not need custom checkout logic, split payments, or deep Paystack API integration.
• You prefer paying a monthly subscription and transaction fees over managing a server.
• You value Shopify's built-in inventory management, shipping, and app ecosystem.

Choose WooCommerce when:

• You need full control over the checkout experience, including inline payment popups.
• You want access to all Paystack features: split payments, subaccounts, custom metadata, subscription billing with plan mapping.
• You want to avoid Shopify's third-party transaction fee on every order.
• You are comfortable managing WordPress hosting or have a developer who can handle it.
• You need to customize the payment flow with business logic that Shopify's checkout cannot accommodate.

For detailed WooCommerce setup, see Paystack for WooCommerce: setup and troubleshooting.

Shopify works well for straightforward e-commerce. But there are specific scenarios where Shopify's limitations around third-party payment providers become blockers.

Marketplace businesses. If you run a multi-vendor marketplace where each sale needs to be split between the seller, the platform, and possibly a logistics partner, Shopify's checkout cannot handle Paystack's split payment API. You would need to build a custom solution using Shopify's APIs and a separate payment processing layer, which defeats the purpose of using Shopify for simplicity.

Subscription-heavy businesses. While Shopify has subscription app integrations, connecting them with Paystack's subscription billing requires careful coordination. WooCommerce Subscriptions with the Paystack plugin handles this more natively.

Businesses needing detailed transaction metadata. If your reconciliation, analytics, or compliance processes require custom data attached to each Paystack transaction, Shopify's limited metadata passing is a problem. A custom integration or WooCommerce gives you full control over what data goes into each transaction.

The honest assessment: Shopify with Paystack works well for 80% of small to mid-size e-commerce stores in Africa. For the other 20% with more complex payment needs, a different platform or a custom build is the better path. If you want to explore no-code alternatives to both, see Paystack Payment Links or Paystack Storefronts.