Skip to main content

Selling

Accept Paystack

For stores in South Africa: shoppers pay by card, EFT or Apple Pay on Paystack's secure checkout, straight into your own Paystack account. Refund from the order page.

Overview

Connect your own Paystack account and South African shoppers can choose Card, EFT or Apple Pay (Paystack) at checkout. They pay on Paystack's own secure checkout page and come back to your store; the money goes straight into your Paystack account, and Paystack pays it out to your bank. BestWebby never holds it and never sees card details.

0% added fees — Paystack's own fees apply, billed by Paystack to you. BestWebby adds nothing on top of Paystack's rates.

Paystack is invite-only while it rolls out, and it is offered to stores established in South Africa: it is on every plan once BestWebby switches it on for your store. When it is on, Settings → Paystack appears in your settings menu, and Settings → Payments points to it.

Who can use it. The store owner saves and removes the Paystack keys; both ask for your two-step code if you have two-factor authentication on, because they decide where your money goes. Refunds work like card refunds: whoever may refund an order may refund a Paystack order.

Before you start

  • A Paystack business account for your South African business. You open it with Paystack, and Paystack checks your business, not BestWebby.
  • Your storefront sells in South African rand (ZAR). Paystack is offered on storefronts whose currency your Paystack account settles in. If your store is not in ZAR yet, choose South African Rand on Store currency before you add prices: the store currency can change until something is priced or sold, and every storefront changes with it.
  • The payment methods you want (cards, EFT, Apple Pay and others Paystack offers in South Africa) switched on in your Paystack dashboard. Shoppers see exactly the methods your Paystack account offers.

Step 1: Save your Paystack keys

  1. In your Paystack dashboard, open Settings, then API Keys & Webhooks. Copy the public key (starts with pk_live_) and the secret key (starts with sk_live_).
  2. In BestWebby, go to Settings → Paystack, paste both keys and click Check and save keys.
  3. Confirm with your two-step code if asked.

BestWebby asks Paystack, with your secret key, a question that changes nothing (your account balance), to check the keys before saving them. A key Paystack does not accept is never saved. Your secret key is stored encrypted and is never shown again; to change it, click Replace keys.

One Paystack account takes payments for one BestWebby store.

Step 2: Set the webhook URL in Paystack

Settings → Paystack shows your store's webhook URL, for example https://yourstore.bestwebby.com/api/paystack/webhook. Copy it, and in your Paystack dashboard, under Settings → API Keys & Webhooks, paste it as the Live Webhook URL (or the Test Webhook URL if you saved test keys), then save.

Paystack uses it to tell your store about every payment, refund and dispute. A payment is confirmed when the shopper comes back to your store anyway; the webhook makes sure it is confirmed even if they close the page first.

What shoppers see

At checkout, after their details, shoppers choose Card, EFT or Apple Pay (Paystack). They are taken to Paystack's checkout for the same total, pay there, and come back to your store, which confirms the payment with Paystack before telling them it went through. The order is placed and its items are held as for any order; it shows as paid in your Orders as soon as Paystack confirms the payment, and the shopper gets the usual order confirmation.

If they leave Paystack's page without paying, nothing is charged and the held items go back on sale when the order expires. A bank payment that takes a while to clear stays waiting until Paystack confirms it.

Refunds

Every refund of a Paystack order goes back through Paystack, from your Paystack account:

  • Orders → Refund: in full, part of the amount, or chosen items.
  • Returns: approving a refund on a return, or the price difference when an exchange costs less.
  • Editing a paid order: when the change makes the order cost less, the difference goes back through Paystack.

The refund is in your finance records at once. If Paystack refuses it, nothing is recorded and you are told. Paystack queues refunds and pays them out over the next days; if Paystack later reports that a refund failed, you are told, so you can refund the shopper another way.

Make refunds from BestWebby, not in your Paystack dashboard: a refund made in Paystack is not added to the order or your finance records. When Paystack reports one, BestWebby tells you, so you can record it.

When an edit makes the order cost more

Paystack cannot charge the shopper again without them. Paying an order-edit balance through Paystack is not available yet: ask the shopper to pay the difference another way, and record it on the order.

Disputes

When a shopper disputes a Paystack payment, BestWebby tells you, with a link to the order and the date Paystack wants your answer by, and again when Paystack reminds you or closes it. You answer disputes, and send evidence, in your Paystack dashboard under Disputes.

Your payouts

Paystack pays your sales out to your bank. You see every payment, Paystack's fee on it and your payouts in your own Paystack dashboard (Open Paystack on the card). BestWebby never holds or moves this money.

Test mode

Save your test keys (pk_test_… and sk_test_…) to try it first: the card says Test keys — no real money moves, shoppers pay with Paystack's test cards, and BestWebby marks these payments as test payments. Save your live keys when you are ready, and set the Live Webhook URL.

Disconnect Paystack

On Settings → Paystack, click Disconnect and confirm. Shoppers are no longer offered Paystack and your keys are deleted from BestWebby. Orders already paid are not affected, but they can no longer be refunded through Paystack from BestWebby: refund them in your Paystack dashboard. Disconnect when no order is waiting for payment. You can also remove the webhook URL in your Paystack dashboard.

Troubleshooting

  • "Paystack did not accept that secret key." Copy it again from Settings → API Keys & Webhooks in your Paystack dashboard. If you generated new keys there, the old ones stop working.
  • "The two keys are from different modes." Paste both test keys or both live keys.
  • "Paystack is offered to stores established in South Africa." Your store's country of establishment is not one where BestWebby offers Paystack.
  • Paystack is connected but shoppers do not see it. Check that your storefront sells in a currency your Paystack account settles in (the card lists them), and that the card says Active.
  • The card says Paystack no longer accepts the saved key. You changed your keys in Paystack: paste the current ones.
  • A store with only Paystack. You do not need a card account as well: when Paystack is the only way your store takes payment, Buy now and Checkout still show, and shoppers pay through Paystack.