FAQ

For merchants

Do I need a Paystack public key?

No. The plugin initialises and verifies payments from your server with the secret key only.

Which payment channels will my customers see?

Whatever your Paystack account offers for the currency — cards, bank transfer, USSD, QR, mobile money. Enable or disable channels in your Paystack dashboard; the plugin has no channel setting.

Can I use different Paystack accounts for different sales channels?

Payments and refunds read the key of the order's sales channel, but webhook signatures are checked with the key saved on All Sales Channels. Webhooks for other accounts are therefore rejected, and orders paid on those channels only become paid when the customer returns to the shop. One Paystack account per installation is the supported setup.

Why is an order not marked as paid even though Paystack shows the payment?

Either the customer did not return and the webhook is not reaching your shop, or the amount/currency check failed. See Troubleshooting.

Does the plugin create currencies such as NGN or XOF?

No. Add currencies in Shopware yourself. The plugin converts amounts correctly for whichever currency the order uses.

Can I refund from the Paystack dashboard instead?

Yes. Paystack then sends refund.pending and refund.processed webhooks and the refund appears on the Shopware order automatically, as long as the amount fits within what is still refundable.

How long does a refund take?

Paystack processes refunds in the background; the Shopware refund becomes Completed when Paystack confirms it. How long the customer waits for the money depends on their bank and channel.

Can staff refund without being administrators?

Yes — grant Process Paystack refunds on their role. See Refunds → Who can refund.

Is customers' bank data encrypted?

No. Bank details and BVNs are stored as customer custom fields in plain text. Enable the feature only if you need it. See Customer bank details.

Does the plugin support subscriptions or saved cards?

No.

Is it in the Shopware Store?

Not yet. Install with Composer or a ZIP — see Installation.

How do I test without real money?

Turn on Enable Sandbox Mode and save your Paystack Test Secret Key. Paystack's test page then offers ready-made outcomes (Success, Declined, …). See Taking payments and Paystack: Test payments.

Where do I find a payment in the Paystack dashboard?

Copy the Reference from the order's Paystack tab and search for it under Transactions in the Paystack dashboard.

Can I refund part of a payment?

Yes. The Process Refund dialog is prefilled with the full refundable amount; enter a smaller one. See Refunds.

I refunded, but the order still shows Paid.

Shopware records the refund when Paystack's refund webhooks arrive. If they never arrive, check the webhook URL — see Troubleshooting. Don't refund a second time.

Why does the customer see payment options I didn't choose in Shopware?

The channels on the Paystack page (card, transfer, bank, USSD, …) are set in your Paystack dashboard. The plugin has no setting for them.