Skip to content

Customer payment providers

For OwnerAll plans

Choose how customers pay you for invoices, WhatsApp payment links, and the online shop. You can use your own gateway keys or let Akoole manage settlement.

This is not Billing, which is what you pay Akoole for your plan.

  • Know which provider you use (or want): Paystack, Flutterwave, Stripe, Square, or Razorpay.
  • For Own gateway, sign in to that provider’s dashboard. Start in test mode, then switch to live keys.
  • For Managed settlement, add a settlement bank account first.
  • Never paste live secret keys into chat, email, or support tickets.
  1. Open Payments settings

    Go to Settings → Payments. Set it up for the whole organisation, or add a branch override if each outlet settles separately.

    Payments: own gateway or Akoole managed
    Payments: own gateway or Akoole managed
  2. Choose Own gateway or Managed

    Own gateway: paste your provider keys and customers pay straight into your merchant account.

    Managed: Akoole’s platform keys plus your settlement account, where the provider supports it.

  3. Connect your provider

    Pick your provider below and follow its tab.

  1. In the Paystack Dashboard, open Settings → API Keys & Webhooks.

  2. Copy the Secret key (sk_…) and Public key (pk_…) for the mode you’re using.

  3. In the same screen, set the webhook URL to:

    https://api.akoole.com/webhooks/api/v1/paystack/shop-payments
  4. In Akoole, choose Own gateway → Paystack, paste both keys, and Save payments.

Both keys are needed the first time. Later you can leave the secret blank to keep the one on file.

  1. Check the status is active

    After saving, the status should change to active. If you see an error banner, fix it before sending real payment links.

  2. Test with a small payment

    Send a small invoice payment link, pay it (in test mode if you can), and check the invoice is marked paid once.

Customer paid but the invoice still shows unpaid

Check the webhook in your provider’s dashboard points to the shop-payments URL for that provider (not a billing URL). Also check test and live keys aren’t mixed: the keys you saved must match the mode that created the link.

Status won’t change to active

Some required fields are missing. Paystack, Flutterwave and Stripe need both keys. Square and Razorpay need all three fields.

Managed mode stuck on pending

Add a complete settlement bank account in Business details, then reopen Payments and save.

Mixing this up with Billing

Billing is your Akoole subscription. Settings → Payments is how customers pay your shop.