Paystack Agent Skills: Automate Fintech Payments

24 AI agent skills for Paystack API integration — automate transactions, webhooks, subscriptions, transfers, and marketplace splits in TypeScript, Node.js, and Next.js.

Paystack Agent Skills are production-ready, type-safe automated payment agent patterns that teach GitHub Copilot, Cursor, and other AI coding agents how to integrate every Paystack API endpoint. Install with a single command and build fintech workflows, e-commerce checkouts, SaaS billing, and payout systems instantly. These Paystack developer tools cover 24 endpoints — from initializing transactions to managing marketplace splits.

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

• Official Paystack API Documentation
• Paystack Dashboard
• Paystack Skills on npm
• Paystack Skills GitHub Pages
• Skills.sh Open Agent Skills Ecosystem
• Report an Issue with Paystack Skills
• Community Discussions for Paystack Skills

Related Projects

• Interswitch Agent Skills — 18 AI agent skills for Interswitch API integration (Web Checkout, Quickteller, wallets, transfers, VAS)

Contributing

Found an issue or want to improve a Paystack skill? Report a bug or suggest a feature or submit a pull request.

License

MIT