@grtsnx/payba3 1.0.0

package/src/lib/paystack/paystack_llm.txt

@@ -0,0 +1,382 @@
+# Paystack Documentation
+
+> Paystack is Africa's leading payments infrastructure provider, enabling businesses to accept payments from customers via cards, bank accounts, mobile money, USSD, QR codes, and bank transfers. This documentation covers integration guides, SDKs, webhooks, and best practices for building payment experiences.
+
+Paystack operates in Nigeria, Ghana, South Africa, Kenya, and Côte d'Ivoire. The platform supports both online and in-person payments through various integration methods including Popup JS, Redirect, Mobile SDKs, and Terminal devices.
+
+Important notes:
+- All amounts are in smallest currency unit (kobo for NGN, pesewas for GHS, cents for KES/ZAR/USD)
+- API requests require authentication: secret keys (server-side) or public keys (client-side)
+- Test mode uses test API keys (`sk_test_*`, `pk_test_*`); live mode uses live keys (`sk_live_*`, `pk_live_*`)
+- Always verify transactions server-side before delivering value
+- Webhooks provide real-time notifications; validate signatures using your secret key
+- Supported currencies: NGN (Nigeria), GHS (Ghana), ZAR (South Africa), KES (Kenya), USD (International)
+
+## Home
+
+- [Paystack Documentation Home](https://paystack.com/docs/): Main entry point with quick start guides for accepting payments, sending money, and identity verification
+
+## Payments
+
+- [Payments Overview](https://paystack.com/docs/payments/): Introduction to accepting payments with Paystack including demos and integration options
+- [Accept Payments](https://paystack.com/docs/payments/accept-payments/): Integration methods including Popup JS, Redirect API, and Mobile SDKs for collecting payments
+- [Verify Payments](https://paystack.com/docs/payments/verify-payments/): How to verify transaction status and understand transaction states (success, failed, abandoned, pending)
+- [Payment Channels](https://paystack.com/docs/payments/payment-channels/): Supported payment methods including cards, mobile money, USSD, QR codes, bank transfers, and Apple Pay
+- [Apple Pay](https://paystack.com/docs/payments/apple-pay/): Setting up Apple Pay for web and Commerce Suite with domain registration and verification
+- [Recurring Charges](https://paystack.com/docs/payments/recurring-charges/): Tokenization and charging saved cards for repeat payments using authorization codes
+- [Subscriptions](https://paystack.com/docs/payments/subscriptions/): Creating plans and managing recurring subscription billing with automatic charges
+- [Split Payments](https://paystack.com/docs/payments/split-payments/): Splitting transaction settlements between main account and subaccounts
+- [Multi-split Payments](https://paystack.com/docs/payments/multi-split-payments/): Advanced splitting with transaction splits across multiple subaccounts
+- [Dedicated Virtual Accounts](https://paystack.com/docs/payments/dedicated-virtual-accounts/): Creating customer-specific bank accounts for receiving transfers (Nigeria & Ghana)
+- [Webhooks](https://paystack.com/docs/payments/webhooks/): Setting up webhook endpoints to receive real-time event notifications for transactions
+- [Refunds](https://paystack.com/docs/payments/refunds/): Initiating partial or full refunds for completed transactions
+- [Manage Disputes](https://paystack.com/docs/payments/manage-disputes/): Handling chargebacks and disputes through the Disputes API
+- [Test Payments](https://paystack.com/docs/payments/test-payments/): Test cards, bank accounts, and mobile money numbers for development
+
+## Payment Channels by Country
+
+### Nigeria (NGN)
+Cards (Visa, Mastercard, Verve), Bank Transfer, USSD, QR Code, Apple Pay
+
+### Ghana (GHS)
+Cards, Mobile Money (MTN, AirtelTigo, Telecel), Bank Transfer, QR Code
+
+### South Africa (ZAR)
+Cards, Apple Pay, QR Code
+
+### Kenya (KES)
+Cards, Mobile Money (M-PESA, Airtel Money)
+
+### Côte d'Ivoire (XOF)
+Cards, Mobile Money (MTN MoMo, Wave, Orange Money), Apple Pay
+
+## Terminal
+
+- [Terminal Overview](https://paystack.com/docs/terminal/): In-person payment solutions including Physical Terminal, Virtual Terminal, and Terminal API
+- [Invoice Payments](https://paystack.com/docs/terminal/invoice-payments/): Accepting payment for invoices and orders on Terminal devices
+- [Push Payment Requests](https://paystack.com/docs/terminal/push-payment-requests/): Initiating payment requests from POS systems to Terminal devices
+- [Custom Apps](https://paystack.com/docs/terminal/custom-apps/): Building custom Android applications that run on Paystack Terminal hardware
+- [Virtual Terminal](https://paystack.com/docs/terminal/virtual-terminal/): Using mobile phones as virtual POS devices with WhatsApp notifications
+
+## Transfers
+
+- [Transfers Overview](https://paystack.com/docs/transfers/): Sending money to bank accounts and mobile money wallets
+- [How Transfers Work](https://paystack.com/docs/transfers/how-transfers-work/): Understanding transfer flow, statuses, and processing times
+- [Single Transfers](https://paystack.com/docs/transfers/single-transfers/): Step-by-step guide to sending money to individual recipients
+- [Bulk Transfers](https://paystack.com/docs/transfers/bulk-transfers/): Batch disbursements to multiple recipients in a single request
+- [Creating Transfer Recipients](https://paystack.com/docs/transfers/creating-transfer-recipients/): Setting up beneficiaries with bank account or mobile money details
+- [Managing Transfers](https://paystack.com/docs/transfers/managing-transfers/): Balance management, OTP settings, and transfer controls
+
+## Identity Verification
+
+- [Identity Verification Overview](https://paystack.com/docs/identity-verification/): KYC tools for verifying customer identity and bank details
+- [Verify Account Number](https://paystack.com/docs/identity-verification/verify-account-number/): Confirming bank account ownership before transfers (Nigeria & Ghana)
+- [Validate Customer](https://paystack.com/docs/identity-verification/validate-customer/): BVN and identity verification for Dedicated Virtual Account customers
+- [Resolve Card BIN](https://paystack.com/docs/identity-verification/resolve-card-bin/): Getting card information from the first 6 digits of a card number
+
+## Developer Tools
+
+- [Developer Tools Overview](https://paystack.com/docs/developer-tools/): SDKs, libraries, and tools for Paystack integration
+- [InlineJS](https://paystack.com/docs/developer-tools/inlinejs/): JavaScript SDK for web payment integration with Popup checkout
+- [Flutter SDK](https://paystack.com/docs/developer-tools/flutter-sdk/): Cross-platform mobile SDK for Flutter applications (Beta)
+- [iOS SDK](https://paystack.com/docs/developer-tools/ios-sdk/): Native iOS SDK for accepting payments in Swift/Objective-C apps (Beta)
+- [Android SDK](https://paystack.com/docs/developer-tools/android-sdk/): Native Android SDK for accepting payments in Kotlin/Java apps
+
+## Guides
+
+- [Guides Overview](https://paystack.com/docs/guides/): Step-by-step tutorials for integrating Paystack with various frameworks
+- [Accept Payments on your Vue App](https://paystack.com/docs/guides/accept_payments_on_your_vue_app/): Vue.js integration tutorial with Paystack Popup
+- [Accept Payments on your React App](https://paystack.com/docs/guides/accept_payments_on_your_react_app/): React integration tutorial with component examples
+- [Accept Payments on your Android App](https://paystack.com/docs/guides/accept_payments_on_your_android_app/): Native Android integration with the Paystack Android SDK
+- [Accept Payments in your Flutter App](https://paystack.com/docs/guides/accept-payments-in-your-flutter-app/): Flutter integration guide with the Paystack Flutter SDK
+- [Using the Paystack Checkout in a Mobile WebView](https://paystack.com/docs/guides/using_the_paystack_checkout_in_a_mobile_webview/): Embedding Paystack checkout in mobile app WebViews
+- [Migrating from InlineJS V1 to V2](https://paystack.com/docs/guides/migrating-from-inlinejs-v1-to-v2/): Upgrading from legacy Popup to InlineJS V2
+
+## Libraries and Plugins
+
+- [Libraries and Plugins Overview](https://paystack.com/docs/libraries-and-plugins/): Official and community-maintained integrations
+- [Libraries](https://paystack.com/docs/libraries-and-plugins/libraries/): Server-side libraries for PHP, Python, Node.js, Java, .NET, Ruby, and more
+- [Plugins](https://paystack.com/docs/libraries-and-plugins/plugins/): E-commerce platform plugins for WordPress, WooCommerce, Shopify, Magento, PrestaShop, Joomla, BigCommerce, Xero, and Ecwid
+
+## Optional
+
+- [API Reference](https://paystack.com/docs/api/): Complete REST API documentation with all endpoints, parameters, and responses
+- [API Changelog](https://paystack.com/docs/changelog/api/): Latest API updates, new features, deprecations, and breaking changes
+- [OpenAPI Specification](https://github.com/PaystackOSS/openapi): Machine-readable API spec for code generation and tooling
+- [Paystack CLI](https://github.com/PaystackOSS/paystack-cli): Command-line tool for testing webhooks and managing integrations
+- [Paystack MCP Server](https://github.com/PaystackOSS/paystack-mcp-server): Model Context Protocol server for AI assistant integration
+- [Payslack Community](https://paystack.slack.com): Developer community on Slack for questions and discussions
+- [Paystack Support](https://support.paystack.com/): Help center with FAQs and support resources
+
+## Open Source Resources (PaystackOSS)
+
+- [PaystackOSS on GitHub](https://github.com/PaystackOSS/): Official open-source projects and sample code
+- [paystack-node](https://github.com/PaystackOSS/paystack-node): Official Node.js client library
+- [paystack-python](https://github.com/PaystackOSS/paystack-python): Official Python client library
+- [paystack_flutter](https://github.com/PaystackOSS/paystack_flutter): Official Flutter SDK
+- [sample-gift-store](https://github.com/PaystackOSS/sample-gift-store): Vue.js e-commerce demo with Paystack checkout
+- [sample-react](https://github.com/PaystackOSS/sample-react): React integration example
+- [sample-subscriptions-app](https://github.com/PaystackOSS/sample-subscriptions-app): Subscription billing implementation demo
+- [sample-restaurant](https://github.com/PaystackOSS/sample-restaurant): Terminal integration for in-person payments
+- [sample-logistics](https://github.com/PaystackOSS/sample-logistics): Payment on delivery with Terminal
+- [apple-pay-react](https://github.com/PaystackOSS/apple-pay-react): Apple Pay integration with React
+
+---
+
+# API Reference
+
+> The Paystack API is a RESTful, JSON-based API that enables programmatic access to payment processing, transfers, customer management, and identity verification. All requests must be authenticated and made over HTTPS.
+
+Base URL: `https://api.paystack.co`
+
+Authentication: Include your secret key in the Authorization header as `Bearer SECRET_KEY`. Public keys are only for client-side integrations (Popup, Mobile SDKs).
+
+HTTP Methods:
+- GET: Retrieve resources
+- POST: Create resources or perform actions
+- PUT: Update resources
+- DELETE: Remove resources
+
+Response Format: All responses return JSON with `status` (boolean), `message` (string), and `data` (object/array) fields.
+
+Supported Currencies: NGN (Nigeria), GHS (Ghana), ZAR (South Africa), KES (Kenya), USD (International)
+
+Amount Format: All amounts are in the smallest currency unit (e.g., kobo for NGN, pesewas for GHS)
+
+## API Introduction
+
+- [API Introduction](https://paystack.com/docs/api/): Overview of Paystack API basics, base URL, and getting started
+- [Authentication](https://paystack.com/docs/api/authentication/): API key management, public vs secret keys, and authorization headers
+- [Errors](https://paystack.com/docs/api/errors/): Error types (api_error, validation_error, processor_error), codes, and handling
+- [Transaction Errors](https://paystack.com/docs/api/errors/transaction/): Common transaction failure codes and troubleshooting
+- [Pagination](https://paystack.com/docs/api/pagination/): Offset and cursor-based pagination for list endpoints
+
+## Transactions API
+
+- [Transaction API](https://paystack.com/docs/api/transaction/): Create and manage payment transactions on your integration
+- [Initialize Transaction](https://paystack.com/docs/api/transaction/#initialize-transaction): POST /transaction/initialize - Start a new transaction and get authorization URL
+- [Verify Transaction](https://paystack.com/docs/api/transaction/#verify-transaction): GET /transaction/verify/:reference - Confirm transaction status by reference
+- [List Transactions](https://paystack.com/docs/api/transaction/#list-transactions): GET /transaction - Retrieve all transactions with pagination and filters
+- [Fetch Transaction](https://paystack.com/docs/api/transaction/#fetch-transaction): GET /transaction/:id - Get details of a specific transaction by ID
+- [Charge Authorization](https://paystack.com/docs/api/transaction/#charge-authorization): POST /transaction/charge_authorization - Charge a saved card using authorization code
+- [View Transaction Timeline](https://paystack.com/docs/api/transaction/#view-transaction-timeline): GET /transaction/timeline/:id_or_reference - Get transaction history and events
+- [Transaction Totals](https://paystack.com/docs/api/transaction/#transaction-totals): GET /transaction/totals - Get total volume and count of transactions
+- [Export Transactions](https://paystack.com/docs/api/transaction/#export-transactions): GET /transaction/export - Export transactions to CSV
+- [Partial Debit](https://paystack.com/docs/api/transaction/#partial-debit): POST /transaction/partial_debit - Charge partial amount from saved card
+
+## Charge API
+
+- [Charge API](https://paystack.com/docs/api/charge/): Initiate direct charges for various payment channels
+- [Create Charge](https://paystack.com/docs/api/charge/#create-charge): POST /charge - Initiate a charge with email, amount, and payment channel details
+- [Submit PIN](https://paystack.com/docs/api/charge/#submit-pin): POST /charge/submit_pin - Submit card PIN for charges requiring it
+- [Submit OTP](https://paystack.com/docs/api/charge/#submit-otp): POST /charge/submit_otp - Submit OTP for 2FA verification
+- [Submit Phone](https://paystack.com/docs/api/charge/#submit-phone): POST /charge/submit_phone - Submit phone number for verification
+- [Submit Birthday](https://paystack.com/docs/api/charge/#submit-birthday): POST /charge/submit_birthday - Submit birthday for card verification
+- [Submit Address](https://paystack.com/docs/api/charge/#submit-address): POST /charge/submit_address - Submit billing address for international cards
+- [Check Pending Charge](https://paystack.com/docs/api/charge/#check-pending-charge): GET /charge/:reference - Check status of a pending charge
+
+## Customer API
+
+- [Customer API](https://paystack.com/docs/api/customer/): Manage customer records and their payment authorizations
+- [Create Customer](https://paystack.com/docs/api/customer/#create-customer): POST /customer - Create a new customer with email and optional details
+- [List Customers](https://paystack.com/docs/api/customer/#list-customers): GET /customer - Retrieve all customers with pagination
+- [Fetch Customer](https://paystack.com/docs/api/customer/#fetch-customer): GET /customer/:email_or_code - Get customer details by email or customer code
+- [Update Customer](https://paystack.com/docs/api/customer/#update-customer): PUT /customer/:code - Update customer information
+- [Validate Customer](https://paystack.com/docs/api/customer/#validate-customer): POST /customer/:customer_code/identification - Verify customer identity with BVN
+- [Whitelist/Blacklist Customer](https://paystack.com/docs/api/customer/#whitelist-blacklist-customer): POST /customer/set_risk_action - Set risk action to allow or deny transactions
+- [Deactivate Authorization](https://paystack.com/docs/api/customer/#deactivate-authorization): POST /customer/deactivate_authorization - Disable a saved card authorization
+
+## Plans API
+
+- [Plan API](https://paystack.com/docs/api/plan/): Create and manage subscription plans
+- [Create Plan](https://paystack.com/docs/api/plan/#create-plan): POST /plan - Create a plan with name, amount, and billing interval
+- [List Plans](https://paystack.com/docs/api/plan/#list-plans): GET /plan - Retrieve all plans with pagination
+- [Fetch Plan](https://paystack.com/docs/api/plan/#fetch-plan): GET /plan/:id_or_code - Get plan details by ID or plan code
+- [Update Plan](https://paystack.com/docs/api/plan/#update-plan): PUT /plan/:id_or_code - Update plan details
+
+## Subscriptions API
+
+- [Subscription API](https://paystack.com/docs/api/subscription/): Manage recurring billing subscriptions
+- [Create Subscription](https://paystack.com/docs/api/subscription/#create-subscription): POST /subscription - Subscribe a customer to a plan
+- [List Subscriptions](https://paystack.com/docs/api/subscription/#list-subscriptions): GET /subscription - Retrieve all subscriptions with filters
+- [Fetch Subscription](https://paystack.com/docs/api/subscription/#fetch-subscription): GET /subscription/:id_or_code - Get subscription details
+- [Enable Subscription](https://paystack.com/docs/api/subscription/#enable-subscription): POST /subscription/enable - Reactivate a disabled subscription
+- [Disable Subscription](https://paystack.com/docs/api/subscription/#disable-subscription): POST /subscription/disable - Pause or cancel a subscription
+- [Generate Update Subscription Link](https://paystack.com/docs/api/subscription/#generate-update-subscription-link): GET /subscription/:code/manage/link - Get link for customer to update card
+
+## Payment Pages API
+
+- [Payment Pages API](https://paystack.com/docs/api/page/): Create and manage payment pages (hosted payment forms)
+- [Create Payment Page](https://paystack.com/docs/api/page/#create-payment-page): POST /page - Create a payment page with custom slug
+- [List Payment Pages](https://paystack.com/docs/api/page/#list-payment-pages): GET /page - Retrieve all payment pages
+- [Fetch Payment Page](https://paystack.com/docs/api/page/#fetch-payment-page): GET /page/:id_or_slug - Get payment page details
+- [Update Payment Page](https://paystack.com/docs/api/page/#update-payment-page): PUT /page/:id_or_slug - Update payment page details
+- [Check Slug Availability](https://paystack.com/docs/api/page/#check-slug-availability): GET /page/check_slug_availability/:slug - Check if a slug is available
+- [Add Products](https://paystack.com/docs/api/page/#add-products): POST /page/:id/product - Add products to a payment page
+
+## Products API
+
+- [Product API](https://paystack.com/docs/api/product/): Create and manage products for payment pages and storefronts
+- [Create Product](https://paystack.com/docs/api/product/#create-product): POST /product - Create a new product
+- [List Products](https://paystack.com/docs/api/product/#list-products): GET /product - Retrieve all products
+- [Fetch Product](https://paystack.com/docs/api/product/#fetch-product): GET /product/:id - Get product details
+- [Update Product](https://paystack.com/docs/api/product/#update-product): PUT /product/:id - Update product details
+- [Delete Product](https://paystack.com/docs/api/product/#delete-product): DELETE /product/:id - Remove a product
+
+## Storefront API
+
+- [Storefront API](https://paystack.com/docs/api/storefront/): Create and manage digital storefronts (paystack.shop)
+- [Create Storefront](https://paystack.com/docs/api/storefront/#create-storefront): POST /storefront - Create a new storefront with slug
+- [List Storefronts](https://paystack.com/docs/api/storefront/#list-storefronts): GET /storefront - Retrieve all storefronts
+- [Fetch Storefront](https://paystack.com/docs/api/storefront/#fetch-storefront): GET /storefront/:id - Get storefront details
+- [Update Storefront](https://paystack.com/docs/api/storefront/#update-storefront): PUT /storefront/:id - Update storefront details
+- [Delete Storefront](https://paystack.com/docs/api/storefront/#delete-storefront): DELETE /storefront/:id - Remove a storefront
+
+## Payment Requests API
+
+- [Payment Request API](https://paystack.com/docs/api/payment-request/): Create and manage invoices and payment requests
+- [Create Payment Request](https://paystack.com/docs/api/payment-request/#create-payment-request): POST /paymentrequest - Create an invoice for a customer
+- [List Payment Requests](https://paystack.com/docs/api/payment-request/#list-payment-requests): GET /paymentrequest - Retrieve all payment requests
+- [Fetch Payment Request](https://paystack.com/docs/api/payment-request/#fetch-payment-request): GET /paymentrequest/:id_or_code - Get payment request details
+- [Verify Payment Request](https://paystack.com/docs/api/payment-request/#verify-payment-request): GET /paymentrequest/verify/:code - Verify payment request status
+- [Send Notification](https://paystack.com/docs/api/payment-request/#send-notification): POST /paymentrequest/notify/:code - Send payment request to customer email
+- [Payment Request Totals](https://paystack.com/docs/api/payment-request/#payment-request-totals): GET /paymentrequest/totals - Get total amount and count
+- [Finalize Payment Request](https://paystack.com/docs/api/payment-request/#finalize-payment-request): POST /paymentrequest/finalize/:code - Finalize a draft payment request
+- [Update Payment Request](https://paystack.com/docs/api/payment-request/#update-payment-request): PUT /paymentrequest/:id_or_code - Update payment request details
+- [Archive Payment Request](https://paystack.com/docs/api/payment-request/#archive-payment-request): POST /paymentrequest/archive/:code - Archive a payment request
+
+## Subaccounts API
+
+- [Subaccount API](https://paystack.com/docs/api/subaccount/): Manage subaccounts for split payments
+- [Create Subaccount](https://paystack.com/docs/api/subaccount/#create-subaccount): POST /subaccount - Create a subaccount with bank details and split percentage
+- [List Subaccounts](https://paystack.com/docs/api/subaccount/#list-subaccounts): GET /subaccount - Retrieve all subaccounts
+- [Fetch Subaccount](https://paystack.com/docs/api/subaccount/#fetch-subaccount): GET /subaccount/:id_or_code - Get subaccount details
+- [Update Subaccount](https://paystack.com/docs/api/subaccount/#update-subaccount): PUT /subaccount/:id_or_code - Update subaccount details
+
+## Transaction Splits API
+
+- [Transaction Split API](https://paystack.com/docs/api/split/): Configure multi-split payment rules
+- [Create Split](https://paystack.com/docs/api/split/#create-split): POST /split - Create a transaction split configuration
+- [List Splits](https://paystack.com/docs/api/split/#list-splits): GET /split - Retrieve all transaction splits
+- [Fetch Split](https://paystack.com/docs/api/split/#fetch-split): GET /split/:id - Get transaction split details
+- [Update Split](https://paystack.com/docs/api/split/#update-split): PUT /split/:id - Update split configuration
+- [Add/Update Split Subaccount](https://paystack.com/docs/api/split/#add-update-split-subaccount): POST /split/:id/subaccount/add - Add or update subaccount in split
+- [Remove Subaccount from Split](https://paystack.com/docs/api/split/#remove-subaccount-from-split): POST /split/:id/subaccount/remove - Remove subaccount from split
+
+## Transfers API
+
+- [Transfer API](https://paystack.com/docs/api/transfer/): Send money to bank accounts and mobile money wallets
+- [Initiate Transfer](https://paystack.com/docs/api/transfer/#initiate-transfer): POST /transfer - Send money to a transfer recipient
+- [Finalize Transfer](https://paystack.com/docs/api/transfer/#finalize-transfer): POST /transfer/finalize_transfer - Complete transfer with OTP
+- [Initiate Bulk Transfer](https://paystack.com/docs/api/transfer/#initiate-bulk-transfer): POST /transfer/bulk - Send money to multiple recipients at once
+- [List Transfers](https://paystack.com/docs/api/transfer/#list-transfers): GET /transfer - Retrieve all transfers with filters
+- [Fetch Transfer](https://paystack.com/docs/api/transfer/#fetch-transfer): GET /transfer/:id_or_code - Get transfer details
+- [Verify Transfer](https://paystack.com/docs/api/transfer/#verify-transfer): GET /transfer/verify/:reference - Verify transfer status
+
+## Transfer Recipients API
+
+- [Transfer Recipient API](https://paystack.com/docs/api/transfer-recipient/): Manage transfer beneficiaries
+- [Create Transfer Recipient](https://paystack.com/docs/api/transfer-recipient/#create-transfer-recipient): POST /transferrecipient - Create a recipient with bank or mobile money details
+- [Bulk Create Transfer Recipients](https://paystack.com/docs/api/transfer-recipient/#bulk-create-transfer-recipients): POST /transferrecipient/bulk - Create multiple recipients at once
+- [List Transfer Recipients](https://paystack.com/docs/api/transfer-recipient/#list-transfer-recipients): GET /transferrecipient - Retrieve all transfer recipients
+- [Fetch Transfer Recipient](https://paystack.com/docs/api/transfer-recipient/#fetch-transfer-recipient): GET /transferrecipient/:id_or_code - Get recipient details
+- [Update Transfer Recipient](https://paystack.com/docs/api/transfer-recipient/#update-transfer-recipient): PUT /transferrecipient/:id_or_code - Update recipient details
+- [Delete Transfer Recipient](https://paystack.com/docs/api/transfer-recipient/#delete-transfer-recipient): DELETE /transferrecipient/:id_or_code - Remove a transfer recipient
+
+## Transfer Control API
+
+- [Transfer Control API](https://paystack.com/docs/api/transfer-control/): Manage transfer settings and balance
+- [Check Balance](https://paystack.com/docs/api/transfer-control/#check-balance): GET /balance - Get available balance on integration
+- [Fetch Balance Ledger](https://paystack.com/docs/api/transfer-control/#fetch-balance-ledger): GET /balance/ledger - Get balance ledger entries
+- [Resend OTP](https://paystack.com/docs/api/transfer-control/#resend-otp): POST /transfer/resend_otp - Resend OTP for transfer verification
+- [Disable OTP](https://paystack.com/docs/api/transfer-control/#disable-otp): POST /transfer/disable_otp - Disable OTP requirement for transfers
+- [Finalize Disable OTP](https://paystack.com/docs/api/transfer-control/#finalize-disable-otp): POST /transfer/disable_otp_finalize - Complete OTP disable with token
+- [Enable OTP](https://paystack.com/docs/api/transfer-control/#enable-otp): POST /transfer/enable_otp - Re-enable OTP requirement
+
+## Settlements API
+
+- [Settlement API](https://paystack.com/docs/api/settlement/): View settlement payouts to your bank account
+- [List Settlements](https://paystack.com/docs/api/settlement/#list-settlements): GET /settlement - Retrieve all settlements with filters
+- [List Settlement Transactions](https://paystack.com/docs/api/settlement/#list-settlement-transactions): GET /settlement/:id/transactions - Get transactions in a settlement
+
+## Dedicated Virtual Accounts API
+
+- [Dedicated Virtual Account API](https://paystack.com/docs/api/dedicated-virtual-account/): Manage customer-specific virtual bank accounts
+- [Create Dedicated Virtual Account](https://paystack.com/docs/api/dedicated-virtual-account/#create-dedicated-virtual-account): POST /dedicated_account - Create a DVA for a customer
+- [Assign Dedicated Virtual Account](https://paystack.com/docs/api/dedicated-virtual-account/#assign-dedicated-virtual-account): POST /dedicated_account/assign - Assign DVA to existing customer
+- [List Dedicated Virtual Accounts](https://paystack.com/docs/api/dedicated-virtual-account/#list-dedicated-virtual-accounts): GET /dedicated_account - Retrieve all DVAs
+- [Fetch Dedicated Virtual Account](https://paystack.com/docs/api/dedicated-virtual-account/#fetch-dedicated-virtual-account): GET /dedicated_account/:dedicated_account_id - Get DVA details
+- [Requery Dedicated Virtual Account](https://paystack.com/docs/api/dedicated-virtual-account/#requery-dedicated-virtual-account): GET /dedicated_account/requery - Check for missed transactions
+- [Deactivate Dedicated Virtual Account](https://paystack.com/docs/api/dedicated-virtual-account/#deactivate-dedicated-virtual-account): DELETE /dedicated_account/:dedicated_account_id - Deactivate a DVA
+- [Split Dedicated Virtual Account Transaction](https://paystack.com/docs/api/dedicated-virtual-account/#split-dedicated-virtual-account-transaction): POST /dedicated_account/split - Configure split for DVA transactions
+- [Remove Split from DVA](https://paystack.com/docs/api/dedicated-virtual-account/#remove-split-from-dva): DELETE /dedicated_account/split - Remove split configuration
+- [Fetch Bank Providers](https://paystack.com/docs/api/dedicated-virtual-account/#fetch-bank-providers): GET /dedicated_account/available_providers - Get supported DVA banks
+
+## Bulk Charges API
+
+- [Bulk Charge API](https://paystack.com/docs/api/bulk-charge/): Process multiple recurring charges in batch
+- [Initiate Bulk Charge](https://paystack.com/docs/api/bulk-charge/#initiate-bulk-charge): POST /bulkcharge - Create a bulk charge batch
+- [List Bulk Charge Batches](https://paystack.com/docs/api/bulk-charge/#list-bulk-charge-batches): GET /bulkcharge - Retrieve all bulk charge batches
+- [Fetch Bulk Charge Batch](https://paystack.com/docs/api/bulk-charge/#fetch-bulk-charge-batch): GET /bulkcharge/:id_or_code - Get batch details
+- [Fetch Charges in Batch](https://paystack.com/docs/api/bulk-charge/#fetch-charges-in-batch): GET /bulkcharge/:id_or_code/charges - Get individual charges in batch
+- [Pause Bulk Charge](https://paystack.com/docs/api/bulk-charge/#pause-bulk-charge): GET /bulkcharge/pause/:batch_code - Pause a running batch
+- [Resume Bulk Charge](https://paystack.com/docs/api/bulk-charge/#resume-bulk-charge): GET /bulkcharge/resume/:batch_code - Resume a paused batch
+
+## Disputes API
+
+- [Dispute API](https://paystack.com/docs/api/dispute/): Handle chargebacks and payment disputes
+- [List Disputes](https://paystack.com/docs/api/dispute/#list-disputes): GET /dispute - Retrieve all disputes with filters
+- [Fetch Dispute](https://paystack.com/docs/api/dispute/#fetch-dispute): GET /dispute/:id - Get dispute details
+- [List Transaction Disputes](https://paystack.com/docs/api/dispute/#list-transaction-disputes): GET /dispute/transaction/:id - Get disputes for a transaction
+- [Update Dispute](https://paystack.com/docs/api/dispute/#update-dispute): PUT /dispute/:id - Update dispute with refund amount
+- [Add Evidence](https://paystack.com/docs/api/dispute/#add-evidence): POST /dispute/:id/evidence - Upload evidence for dispute
+- [Get Upload URL](https://paystack.com/docs/api/dispute/#get-upload-url): GET /dispute/:id/upload_url - Get URL to upload dispute documents
+- [Resolve Dispute](https://paystack.com/docs/api/dispute/#resolve-dispute): PUT /dispute/:id/resolve - Accept or decline dispute
+- [Export Disputes](https://paystack.com/docs/api/dispute/#export-disputes): GET /dispute/export - Export disputes to CSV
+
+## Refunds API
+
+- [Refund API](https://paystack.com/docs/api/refund/): Process partial and full refunds
+- [Create Refund](https://paystack.com/docs/api/refund/#create-refund): POST /refund - Initiate a refund for a transaction
+- [List Refunds](https://paystack.com/docs/api/refund/#list-refunds): GET /refund - Retrieve all refunds with filters
+- [Fetch Refund](https://paystack.com/docs/api/refund/#fetch-refund): GET /refund/:reference - Get refund details
+- [Retry Refund](https://paystack.com/docs/api/refund/#retry-refund): POST /refund/:reference/retry - Retry a failed refund with new bank details
+
+## Terminal API
+
+- [Terminal API](https://paystack.com/docs/api/terminal/): Manage Paystack Terminal devices and events
+- [Send Event](https://paystack.com/docs/api/terminal/#send-event): POST /terminal/:terminal_id/event - Send payment event to Terminal
+- [Fetch Event Status](https://paystack.com/docs/api/terminal/#fetch-event-status): GET /terminal/:terminal_id/event/:event_id - Check event processing status
+- [Fetch Terminal Status](https://paystack.com/docs/api/terminal/#fetch-terminal-status): GET /terminal/:terminal_id/presence - Check if Terminal is online
+- [List Terminals](https://paystack.com/docs/api/terminal/#list-terminals): GET /terminal - Retrieve all registered Terminals
+- [Fetch Terminal](https://paystack.com/docs/api/terminal/#fetch-terminal): GET /terminal/:terminal_id - Get Terminal details
+- [Update Terminal](https://paystack.com/docs/api/terminal/#update-terminal): PUT /terminal/:terminal_id - Update Terminal details
+- [Commission Terminal](https://paystack.com/docs/api/terminal/#commission-terminal): POST /terminal/commission_device - Activate a new Terminal
+- [Decommission Terminal](https://paystack.com/docs/api/terminal/#decommission-terminal): POST /terminal/decommission_device - Deactivate a Terminal
+
+## Verification API
+
+- [Verification API](https://paystack.com/docs/api/verification/): KYC and identity verification endpoints
+- [Resolve Account](https://paystack.com/docs/api/verification/#resolve-account): GET /bank/resolve - Confirm bank account ownership with account number and bank code
+- [Validate Account](https://paystack.com/docs/api/verification/#validate-account): POST /bank/validate - Validate account details for South African accounts
+- [Resolve Card BIN](https://paystack.com/docs/api/verification/#resolve-card-bin): GET /decision/bin/:bin - Get card information from first 6 digits
+
+## Apple Pay API
+
+- [Apple Pay API](https://paystack.com/docs/api/apple-pay/): Register and manage domains for Apple Pay transactions
+- [Register Domain](https://paystack.com/docs/api/apple-pay/#register-domain): POST /apple-pay/domain - Register a domain for Apple Pay
+- [List Domains](https://paystack.com/docs/api/apple-pay/#list-domains): GET /apple-pay/domain - List all registered Apple Pay domains
+- [Unregister Domain](https://paystack.com/docs/api/apple-pay/#unregister-domain): DELETE /apple-pay/domain - Remove a domain from Apple Pay
+
+## Integration API
+
+- [Integration API](https://paystack.com/docs/api/integration/): Manage integration settings
+- [Fetch Timeout](https://paystack.com/docs/api/integration/#fetch-timeout): GET /integration/payment_session_timeout - Get payment session timeout
+- [Update Timeout](https://paystack.com/docs/api/integration/#update-timeout): PUT /integration/payment_session_timeout - Set payment session timeout
+
+## Miscellaneous API
+
+- [Miscellaneous API](https://paystack.com/docs/api/miscellaneous/): Supporting APIs for banks, countries, and currencies
+- [List Banks](https://paystack.com/docs/api/miscellaneous/#list-banks): GET /bank - Get list of supported banks by country
+- [List Countries](https://paystack.com/docs/api/miscellaneous/#list-countries): GET /country - Get list of supported countries
+- [List States](https://paystack.com/docs/api/miscellaneous/#list-states): GET /address_verification/states - Get states for AVS verification

package/src/lib/qoreid/qoreid_llm.txt

@@ -0,0 +1,68 @@
+# QoreID
+
+QoreID provides identity-verification APIs for KYC, business verification, CAC lookups, and hosted verification sessions.
+
+## Configuration
+
+- Base URL used by payba3: `https://api.qoreid.com`
+- Optional override: `QOREID_BASE_URL`
+- payba3 env switch: `QOREID_ENVIRONMENT=sandbox|live`
+- Sandbox keys: `QOREID_CLIENT`, `QOREID_SECRET`
+- Live keys: `QOREID_LIVE_CLIENT`, `QOREID_LIVE_SECRET`
+
+## Authentication
+
+QoreID API calls should be made from the backend with client credentials. payba3 obtains and caches an access token, then refreshes it before expiry.
+
+Token response shapes can vary by integration surface. Accept both:
+
+```json
+{
+  "accessToken": "token",
+  "expiresIn": 3600
+}
+```
+
+and:
+
+```json
+{
+  "access_token": "token",
+  "expires_in": 3600
+}
+```
+
+Never expose QoreID client secrets to frontend code.
+
+## Sessions
+
+Create hosted verification sessions with:
+
+`POST /v1/sessions`
+
+Use this when integrating the QoreID Web SDK or any hosted verification flow. The backend should mint the session token and pass only the safe session data to the frontend.
+
+## CAC Verification
+
+Default CAC Basic endpoint:
+
+`POST /v1/ng/identities/cac-basic`
+
+Premium variants:
+
+- `POST /v2/ng/identities/cac-premium`
+- `POST /v3/ng/identities/cac-premium`
+
+Common body:
+
+```json
+{
+  "regNumber": "RC123456"
+}
+```
+
+## payba3 Notes
+
+- `verifyCacNumber(cacNumber)` defaults to CAC Basic V1.
+- Use `verifyCacNumber(cacNumber, { version: "v3", level: "premium" })` for CAC Premium V3.
+- Use `createSession(payload)` for hosted/SDK flows.

package/src/lib/safehaven/safehaven_llm.txt

@@ -0,0 +1,77 @@
+# Safehaven
+
+Safehaven MFB provides Nigerian banking APIs for account creation, subaccounts, virtual accounts, transfers, and value-added services.
+
+## Environments
+
+- Sandbox API: `https://api.sandbox.safehavenmfb.com`
+- Live API: `https://api.safehavenmfb.com`
+- payba3 env switch: `SAFEHAVEN_ENVIRONMENT=sandbox|live`
+- Optional override: `SAFEHAVEN_BASE_URL`
+
+## Authentication
+
+Generate an access token with:
+
+`POST /oauth2/token`
+
+Headers:
+
+- `accept: application/json`
+- `content-type: application/json`
+
+Body:
+
+```json
+{
+  "grant_type": "client_credentials",
+  "client_assertion_type": "urn:ietf:params:oauth:client-assertion-type:jwt-bearer",
+  "client_id": "SAFEHAVEN_CLIENT_ID",
+  "client_assertion": "SAFEHAVEN_CLIENT_ASSERTION"
+}
+```
+
+Token responses include:
+
+- `access_token`
+- `expires_in`
+- `refresh_token`
+- `client_id`
+- `ibs_client_id`
+- `ibs_user_id`
+
+Use `expires_in` to refresh before expiry. For banking/account APIs, prefer the returned `ibs_client_id` as the `ClientID` header. Fall back to the OAuth `client_id` only when the token response does not include `ibs_client_id`.
+
+## Subaccounts
+
+Create an individual subaccount with:
+
+`POST /accounts/v2/subaccount`
+
+Headers:
+
+- `authorization: Bearer {access_token}`
+- `ClientID: {ibs_client_id}`
+- `accept: application/json`
+- `content-type: application/json`
+
+Common body fields:
+
+```json
+{
+  "phoneNumber": "08000000000",
+  "identityType": "vID",
+  "identityId": "identity-id",
+  "emailAddress": "customer@example.com",
+  "externalReference": "customer_123",
+  "autoSweep": false
+}
+```
+
+Identity flows may use `identityId`, `identityNumber`, `otp`, or `callbackUrl` depending on the selected `identityType`.
+
+## payba3 Notes
+
+- Safehaven token refresh must be automatic.
+- Store token metadata, not only `access_token`, because account calls need `ibs_client_id`.
+- Never expose `SAFEHAVEN_CLIENT_ASSERTION` to browser/client code.

package/src/lib/seerbit/seerbit_llm.txt

@@ -0,0 +1,61 @@
+# SeerBit
+
+SeerBit provides online payments, virtual accounts, collections, payment links, products/orders, recurring billing, and checkout APIs.
+
+## Environment
+
+- Primary API base URL: `https://seerbitapi.com/api/v2`
+- payba3 env switch: `SEERBIT_ENVIRONMENT=sandbox|live`
+- Optional override: `SEERBIT_BASE_URL`
+- Sandbox keys: `SEERBIT_PUBLIC_KEY`, `SEERBIT_SECRET_KEY`
+- Live keys: `SEERBIT_LIVE_PUBLIC_KEY`, `SEERBIT_LIVE_SECRET_KEY`
+
+## Authentication
+
+Generate the encrypted bearer token with:
+
+`POST /encrypt/keys`
+
+Body:
+
+```json
+{
+  "key": "{secretKey}.{publicKey}"
+}
+```
+
+Use the returned encrypted key as:
+
+`Authorization: Bearer {encryptedKey}`
+
+The encrypted-key response may appear as either `EncryptedSecKey` or `EncrytedSecKey`; robust integrations should support both spellings.
+
+## Virtual Accounts
+
+Create a virtual account:
+
+`POST /virtual-accounts`
+
+Body:
+
+```json
+{
+  "publicKey": "SEERBIT_PUBLIC_KEY",
+  "fullName": "Jane Doe",
+  "bankVerificationNumber": "00000000000",
+  "currency": "NGN",
+  "country": "NG",
+  "reference": "customer_123",
+  "email": "jane@example.com"
+}
+```
+
+Retrieve a virtual account:
+
+`GET /virtual-accounts/{paymentReference}`
+
+## payba3 Notes
+
+- `bankVerificationNumber` is optional in payba3 input and defaults to an empty string for sandbox-friendly flows.
+- Production/compliance flows should pass BVN when required by the merchant/provider configuration.
+- SeerBit encrypted bearer keys do not expose a standard `expires_in` field in the documented response; regenerate on process restart or when the provider rejects a cached token.