Interswitch Agent Skills: Automate Payment Integration

18 AI agent skills for Interswitch API integration — automate web checkout, card payments, wallets, transfers, VAS, and split settlement in TypeScript, Node.js, and Next.js.

Interswitch 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 Interswitch API product. Install with a single command and build fintech workflows, e-commerce checkouts, wallet platforms, bill payment apps, and lending systems instantly. These Interswitch developer tools cover 18 API products — from Web Checkout to Card 360 and Quickteller VAS.

Why Use Interswitch Skills?

• Modular — Install only the skills you need, not a monolithic guide
• Type-safe — Full TypeScript support with Zod validation 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 — 18 skills covering Interswitch's payment, wallet, card, transfer, and VAS APIs

Quick Start

# Install all 18 skills at once
npx skills add rexedge/interswitch --all

# Install a specific skill
npx skills add rexedge/interswitch -s interswitch-web-checkout

# Install multiple specific skills
npx skills add rexedge/interswitch -s interswitch-setup interswitch-webhooks interswitch-card-payments

Available Skills

Core

Skill	Description
interswitch-setup	API client setup, OAuth 2.0 token generation, Passport v2 auth, env config, TypeScript helpers
interswitch-webhooks	HmacSHA512 signature validation, event handling, Express.js & Next.js handlers, retry policy
interswitch-testing	Test credentials, test card numbers, sandbox URLs, webhook testing, going-live checklist

Payments & Checkout

Skill	Description
interswitch-web-checkout	Inline Checkout JS widget, Web Redirect HTML form, React/Next.js hook, redirect callback
interswitch-card-payments	Direct card payment, authData encryption, OTP validation, 3D Secure, Hosted Fields, Google Pay
interswitch-payment-links	Create, list, update, deactivate payment links — invoices, donations, tickets
interswitch-split-settlement	Split payments, beneficiary configuration, wallet-pay initialization, settlement accounts

Wallets & Transactions

Skill	Description
interswitch-wallets	Create wallet, get details, check balance, virtual cards, Zod validation
interswitch-transactions	Debit wallet, transaction status, requery, reversal, response codes
interswitch-transaction-search	Quick search, reference search, advanced/bulk search, reconciliation pattern

Transfers & Payouts

Skill	Description
interswitch-transfers	Account validation (name enquiry), MAC hash (SHA-512), single transfer, status check
interswitch-payouts	Payout channels, receiving institutions, institution details, routing logic

Value Added Services

Skill	Description
interswitch-vas	Biller categories, payment items, customer validation, bill payment, airtime recharge

Cards & Fintech

Skill	Description
interswitch-card360	Card issuance (virtual/physical), PIN management, block/unblock, balance inquiry
interswitch-fintech-cards	Card debit, reversal, balance enquiry, lien place/release
interswitch-cardless	Single/bulk paycode generation, status check, cancellation, ATM withdrawal

Insights & Data

Skill	Description
interswitch-customer-insights	Demographics, financial history, financial habits, KYC flow, NDPR compliance
interswitch-lending	Nano loans, salary lending, value financing, eligibility check, repayment

Use Cases

These skills help your AI agent build:

• E-commerce checkout — Web Checkout + Card Payments + Webhooks
• Wallet platform — Wallets + Transactions + Transfers
• Marketplace payments — Split Settlement + Transfers + Payouts
• Bill payment app — VAS + Wallets + Transactions
• Card management — Card 360 + Fintech Cards + Cardless
• Lending/credit — Lending + Customer Insights + Wallets
• Payout system — Transfers + Payouts + Transaction Search

Interswitch API Reference

Property	Value
Base URL (Sandbox)	https://qa.interswitchng.com
Base URL (Production)	https://saturn.interswitchng.com
Auth	OAuth 2.0 Bearer Token or Passport v2 (InterswitchAuth)
Content Type	application/json
Amount Unit	Kobo (multiply naira × 100)

Quick Links

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

Related Projects

• Paystack Agent Skills — 24 AI agent skills for Paystack API integration (transactions, webhooks, subscriptions, transfers, marketplace splits)

Contributing

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

License

MIT