Skip to content

Integrating Paystack

Auth: API key · Partner program: not required · Setup time: about 10 minutes · Last verified: 2026-05-15

Africa anchor (Stripe-owned but independent product). Strong in Nigeria + Ghana + South Africa + Kenya. Methods: cards, bank transfers, USSD, QR, mobile money.

Bearer-token (the merchant secret key — sk_test_… or sk_live_…). Generate under Settings → API Keys & Webhooks in the Paystack dashboard.

  • NGN settlement requires a Nigerian business. The Paystack account must be incorporated in Nigeria to settle in NGN. Cross-border merchants typically settle in USD via a Paystack International account; mobile money in Ghana/Kenya needs separate KYC.
  • amount is in kobo / cents. Integer minor units already — pass through unchanged.
  • Transaction-level currency. Returned per row in currency. Multi-currency merchants should not assume NGN.
  • Customer dedupe. Customers can be addressed by email (Paystack auto-creates if not present) or by customer_code. The adapter surfaces both — externalId = customer_code for stability across renames.

Configure under Settings → API Keys & Webhooks → Webhook URL. HMAC-SHA-512 of the raw body keyed with the secret API key (same one used for API auth), hex-encoded in x-paystack-signature.