Question 1

What does Paystack API do?

Accepted Answer

Paystack is Nigeria's most widely adopted payment gateway API and is a subsidiary of Stripe, the global payments infrastructure company that acquired Paystack in 2020. Founded in 2015 by Shola Akinlade and Ezra Olubi, Paystack was part of Y Combinator's 2016 batch and quickly became the default payment choice for Nigerian developers and businesses. The company is CBN-licensed and PCI-DSS compliant, and currently serves thousands of businesses across Nigeria, Ghana, South Africa, and Kenya.

The Paystack API is RESTful and uses Bearer Token authentication. Every request must include an Authorization header with the format: Authorization: Bearer sk_live_xxxx (for production) or Authorization: Bearer sk_test_xxxx (for sandbox). API keys are obtained from the Paystack dashboard at dashboard.paystack.com. Paystack provides both public keys (used in client-side code to initialize the checkout) and secret keys (used server-side for all API calls). Developers must never expose the secret key in client-side code.

The standard Paystack integration flow involves three steps: initialize a transaction server-side using the /transaction/initialize endpoint (passing email, amount in kobo, and optional metadata), redirect the user to the returned authorization URL or embed the Paystack inline popup using the JavaScript SDK, then verify the transaction on your server using /transaction/verify/:reference after the customer is redirected back. This three-step flow ensures transactions are validated server-side before fulfilling orders, preventing fraud and order manipulation.

Paystack supports the widest range of payment channels of any Nigerian gateway: Verve, Visa, and Mastercard debit cards; bank transfer (pay by transfer); USSD (for customers without smartphones); mobile money (in Ghana); and QR code payments. The Paystack Checkout modal intelligently displays only the channels available for the customer's device and location.

In terms of pricing, local card transactions cost 1.5% plus ₦100, capped at ₦2,000 per transaction. The ₦100 flat fee is waived for transactions of ₦2,500 or less. This means very small transactions (micro-payments) are effectively charged at 1.5% only. International card transactions cost 3.9% plus ₦100, with no cap. Bank transfers (receiving payments via bank account) are charged flat: ₦10 for amounts up to ₦5,000; ₦25 for ₦5,001 to ₦50,000; and ₦50 for amounts above ₦50,000. Outgoing transfers (disbursements) are: ₦10 for ₦0–₦5,000; ₦25 for ₦5,001–₦50,000; ₦50 for above ₦50,000. There are no setup fees and no monthly platform fees. Businesses processing more than ₦10 million per month are eligible for volume-based discounts by contacting Paystack enterprise support.

The Paystack sandbox environment mirrors production exactly — all features available in live mode are available in test mode. This is a critical advantage for Nigerian developers who need to test subscription billing, split payments, and bulk transfers without using real money. Test mode uses test card numbers provided in the Paystack documentation and simulates bank transfer payments via a confirmation prompt.

Paystack also provides a Subscriptions API that allows developers to create subscription plans with daily, weekly, monthly, or annual billing cycles. When a customer first pays, a subscription authorization token is generated and stored securely by Paystack. Subsequent charges happen automatically without requiring the customer to re-enter card details. This is the foundation for building SaaS billing, membership platforms, and digital subscription products in Nigeria.

The Split Payments (multi-split) feature allows marketplace operators to automatically split collected revenue between multiple subaccounts at the time of transaction — specifying percentages or flat amounts for each recipient. This is commonly used by Nigerian food delivery platforms, logistics aggregators, and gig economy apps.

The Bulk Transfers API enables disbursement to hundreds of Nigerian bank accounts in a single API call by submitting a list of transfer recipients. This is used for payroll, agent commissions, loan disbursements, and customer refunds.

From a compliance standpoint, Paystack is PCI-DSS Level 1 certified — the highest level of payment card security certification. All card data is encrypted and processed on Paystack's infrastructure. Merchants are not required to be PCI-DSS certified themselves. Paystack operates under CBN supervision and complies with the Nigerian Data Protection Regulation (NDPR).

Webhook events from Paystack must be validated using the HMAC-SHA512 signature sent in the X-Paystack-Signature header. Developers should validate this signature before processing any webhook event. Paystack retries failed webhooks for up to 72 hours.

Known challenges for Nigerian developers: (1) International card transactions have no cap on the 3.9% fee — high-value international payments can be expensive. (2) Bank transfer payments can take up to 30 minutes during bank downtime, so developers must handle pending states gracefully. (3) BVN and NIN verification are not built into Paystack directly — these require Dojah or Smile Identity as a separate integration.

Frequently Asked Questions:

Can I use Paystack without a registered business? Yes — individuals can create a starter account and start accepting payments. However, you will need to provide CAC documents to unlock higher transaction limits and settlements.

Does Paystack support USD payments? Paystack processes international cards in USD, but settlements are in NGN after conversion. USD settlement is available only for Paystack International accounts.

Can I process recurring payments automatically? Yes — use the Subscriptions API to save a customer authorization token and charge them on any schedule automatically.

Is the test environment exactly like production? Yes — Paystack test mode has full feature parity with live mode, including subscriptions, splits, and bulk transfers.

Question 2

How much does Paystack API cost?

Accepted Answer

Paystack API is free to integrate, with fees charged per transaction (commission-based). Local cards: 1.5% + ₦100, capped at ₦2,000 (waived for ≤₦2,500). International cards: 3.9% + ₦100. Transfers: ₦10 (≤₦5K), ₦25 (₦5K–₦50K), ₦50 (>₦50K). Volume discounts >₦10M/month. No setup/monthly fees.

Question 3

How do I authenticate with the Paystack API API?

Accepted Answer

Bearer Token (Secret Key from Paystack Dashboard)

Question 4

Is there a rate limit on Paystack API?

Accepted Answer

Rate limited — contact Paystack for exact limits

Question 5

Does Paystack API offer a sandbox or test mode?

Accepted Answer

Yes — Paystack API provides a sandbox or test environment so you can integrate and test before going live.

Question 6

What is Paystack API best suited for?

Accepted Answer

Nigerian businesses of all sizes — from solo developers to enterprises — needing Nigeria's best-documented payment API with the widest developer ecosystem, comprehensive payment methods, and full-feature parity between test and live environments.

Question 7

Is there anything else I should know before integrating Paystack API?

Accepted Answer

Verified fee schedule from Paystack’s official pricing page: Nigeria local cards 1.5% + ₦100 (capped at ₦2,000, waived under ₦2,500). International cards 3.9% + ₦100 for Visa/Mastercard/Verve, 4.5% for Amex. Dedicated Virtual Accounts: 1%, capped at ₦300. Businesses processing over ₦10M/month can negotiate volume discounts with Paystack’s sales team. Full pricing: https://paystack.com/pricing

Question 8

Where can I find Paystack API's documentation?

Accepted Answer

The official API documentation is at https://paystack.com/docs/api/. The provider's website is https://paystack.com.

Question 9

Does Paystack API support Nigerian developers?

Accepted Answer

Yes — Paystack API explicitly supports Nigerian developers/use cases.

Paystack API

Features Included

Not Supported

Key Highlights

Required Access Documents

Use Cases

Ask question or give feedback

Sign in to participate

Discover similar API's

Ask question or give feedback

Sign in to participate