Paystack Skills Collection

24 modular AI agent skills for Paystack payment integration — TypeScript, Node.js, and Next.js ready.

Build payment systems, invoicing, subscriptions, marketplaces, and more with production-ready Paystack API patterns. Each skill teaches your AI coding agent exactly how to integrate a specific part of the Paystack API — type-safe, tested, and ready to ship.

Why Use Paystack Skills?

• Modular — Install only the skills you need, not a monolithic guide
• Type-safe — Full TypeScript support with generics and typed responses
• Production-ready — Battle-tested patterns with error handling and security
• AI-powered — Designed for AI coding agents (GitHub Copilot, Cursor, etc.)
• Comprehensive — 24 skills covering every Paystack API endpoint

Quick Start

# Install all 24 skills at once
npx skills add rexedge/paystack --all

# Install a specific skill
npx skills add rexedge/paystack -s paystack-transactions

# Install multiple specific skills
npx skills add rexedge/paystack -s paystack-setup paystack-webhooks paystack-charges

Available Skills

Core

| Skill | Description | | --- | --- | | paystack-setup | API client setup, environment config, TypeScript helpers, paystackRequest<T>() wrapper | | paystack-webhooks | HMAC SHA512 signature validation, event handling, IP whitelisting, retry policy | | paystack-testing | Test mode setup, test card numbers, webhook testing, integration test patterns |

Payments

| Skill | Description | | --- | --- | | paystack-transactions | Initialize, verify, list, fetch, charge authorizations, timeline, totals, export | | paystack-charges | Direct Charge API — card, bank, USSD, mobile money, QR, EFT | | paystack-payment-pages | Hosted payment pages — fixed/flexible amounts, subscriptions, products | | paystack-payment-requests | Invoicing — line items, taxes, due dates, draft mode, email notifications | | paystack-apple-pay | Apple Pay domain registration and management |

Customers & Products

| Skill | Description | | --- | --- | | paystack-customers | Customer CRUD, identity validation, whitelist/blacklist, direct debit | | paystack-products | Product catalog — stock tracking, pricing, payment page integration | | paystack-verification | Bank account resolution, account validation, card BIN lookup |

Subscriptions & Plans

| Skill | Description | | --- | --- | | paystack-plans | Payment plans — daily, weekly, monthly, quarterly, biannually, annually | | paystack-subscriptions | Subscription lifecycle — create, enable, disable, card update links |

Transfers & Payouts

| Skill | Description | | --- | --- | | paystack-transfers | Single and bulk money transfers, OTP finalization, verify | | paystack-transfer-recipients | Recipient management — NUBAN, GHIPSS, mobile money, BASA | | paystack-refunds | Full and partial refunds, retry with bank details |

Marketplace & Splits

| Skill | Description | | --- | --- | | paystack-subaccounts | Subaccount management — settlement schedules, marketplace payouts | | paystack-splits | Transaction splits — percentage/flat, multi-party revenue sharing | | paystack-dedicated-accounts | Dedicated Virtual Accounts (DVA) — Wema Bank, Access Bank |

Operations

| Skill | Description | | --- | --- | | paystack-disputes | Dispute/chargeback management — evidence, resolution workflows | | paystack-settlements | Settlement tracking and reconciliation | | paystack-terminal | Paystack Terminal (POS) — send events, commission devices | | paystack-integration | Integration settings — payment session timeout | | paystack-miscellaneous | Banks list, countries, states (AVS), bank code lookup |

Use Cases

These skills help your AI agent build:

• E-commerce checkout — Transactions + Webhooks + Customers
• SaaS billing — Plans + Subscriptions + Payment Pages
• Marketplace payments — Subaccounts + Splits + Transfers
• Invoicing system — Payment Requests + Customers + Webhooks
• POS integration — Terminal + Transactions + Settlements
• KYC verification — Verification + Customers + Dedicated Accounts
• Payout system — Transfer Recipients + Transfers + Settlements

Paystack API Reference

| Property | Value | | --- | --- | | Base URL | https://api.paystack.co | | Auth Header | Authorization: Bearer SECRET_KEY | | Content Type | application/json | | Amount Unit | Subunit of currency (kobo for NGN, pesewas for GHS, cents for USD/ZAR/KES) | | Amount Conversion | Multiply display amount × 100 |

Supported Countries & Currencies

| Country | Currency | Code | | --- | --- | --- | | Nigeria | Nigerian Naira | NGN | | Ghana | Ghanaian Cedi | GHS | | South Africa | South African Rand | ZAR | | Kenya | Kenyan Shilling | KES | | United States | US Dollar | USD |

Quick Links

• Paystack API Documentation
• Paystack Dashboard
• Skills Registry
• Report an Issue
• Discussions

Contributing

Found an issue or want to improve a skill? Open an issue or submit a pull request.

License

MIT