Paystack
Nigerian financial technology company that offers payment processing services to businesses in Africa.
This is a first-class FlyMyAI MCP. Agents discover it automatically via tool search and call the actions below on demand - you never wire it up by hand. See the Composio catalog for how discovery works.
Connect
Paystack authenticates with an API key. Generate the credential in your Paystack account, then paste it into FlyMyAI the first time an agent uses a Paystack action.
Get your Paystack credential →
Fields to fill in FlyMyAI
| Field | Details |
|---|---|
Secret Key | Your Paystack secret key (starts with sk_test_ for test mode or sk_live_ for live mode). Find this in your Paystack Dashboard under Settings > API Keys & Webhooks. (required) |
Actions
Every action this integration exposes. Agents pick the right one from the task; you do not call them by name.
| Action | What it does | Required inputs |
|---|---|---|
PAYSTACK_ADD_PRODUCTS_TO_PAGE | Tool to add products to a Paystack payment page. Use when you need to add products to an existing page that was created with 'product' type. This action adds the specified products to the page, allowing customers to select from multiple products when making a… | id, products |
PAYSTACK_ADD_PRODUCTS_TO_STOREFRONT | Tool to add previously created products to a Storefront. Use when you need to associate existing products with a specific storefront. | id, products |
PAYSTACK_ADD_SPLIT_CODE_TO_VIRTUAL_TERMINAL | Tool to add a split code to a virtual terminal. Use when you need to assign payment splitting configuration to a virtual terminal. | code, split_code |
PAYSTACK_ADD_SUBACCOUNT_TO_SPLIT | Tool to add a subaccount to a split configuration, or update the share of an existing subaccount. Use this when you need to modify the payment distribution by adding new partners/customers to a split or adjusting their allocation. The split must already exist… | id, subaccount, share |
PAYSTACK_ARCHIVE_PAYMENT_REQUEST | Tool to archive a payment request to clean up records. Use when you need to remove a payment request from active listings. An archived payment request cannot be verified and will not appear when listing payment requests. | id |
PAYSTACK_ASSIGN_DESTINATION_TO_VIRTUAL_TERMINAL | Tool to assign WhatsApp destinations to a Virtual Terminal for payment notifications. Use when you need to add recipients who will receive notifications for payments made through a specific Virtual Terminal. | code, destinations |
PAYSTACK_CHECK_PENDING_CHARGE | Tool to check the status of a pending charge transaction. Use when you receive a 'pending' status from a charge endpoint or need to verify if a charge status has changed. Wait at least 10 seconds after initiating a charge before calling this endpoint. | reference |
PAYSTACK_CHECK_SLUG_AVAILABILITY | Tool to check if a custom slug is available for use when creating a payment page. Use when you need to verify a slug is not already taken before creating a new payment page. | slug |
PAYSTACK_CREATE_BULK_TRANSFER_RECIPIENT | Create multiple transfer recipients in batches. Use when you need to add multiple recipients at once for transfers. Duplicate account numbers automatically return existing recipient records instead of creating duplicates. | batch |
PAYSTACK_CREATE_CHARGE | Tool to initiate a payment by integrating the payment channel of your choice. Use when you need to charge a customer using authorization code, bank account, mobile money, or USSD. | email, amount |
PAYSTACK_CREATE_CUSTOMER | Tool to create a customer on your Paystack integration. Use when you need to add a new customer with their email address and optional details like name and phone number. | email |
PAYSTACK_CREATE_PAYMENT_PAGE | Tool to create a payment page on your Paystack integration. Use when you need to create a payment page that customers can visit to make payments. | name |
PAYSTACK_CREATE_PAYMENT_REQUEST | Create a new payment request by issuing an invoice to a customer. Use this when you need to request payment from a customer for goods or services. | customer, amount |
PAYSTACK_CREATE_PLAN | Tool to create a plan for recurring payments on Paystack. Use when you need to set up subscription billing or recurring payment schedules. The plan defines the amount, interval, and other settings for recurring charges to customers. | name, amount, interval |
PAYSTACK_CREATE_REFUND | Tool to initiate a refund for a previously completed transaction on Paystack. Use when a customer requests a refund or when you need to reverse a payment. The refund can be for the full transaction amount or a partial amount. | transaction |
PAYSTACK_CREATE_SPLIT | Tool to create a split configuration for transaction revenue sharing. Use when you need to configure how transaction revenue should be split between multiple subaccounts (e.g., for marketplace platforms, revenue sharing, or commission distribution). | name, type, currency, subaccounts, bearer_type |
PAYSTACK_CREATE_STOREFRONT | Create a digital storefront on Paystack to manage and display products. Use this when you need to set up a new online shop for selling digital or physical products. | name, slug, currency |
PAYSTACK_CREATE_SUBACCOUNT | Tool to create a subaccount on your Paystack integration. Use when you need to set up a new subaccount with bank details and settlement information. | business_name, settlement_bank, account_number, percentage_charge |
PAYSTACK_CREATE_TRANSFER_RECIPIENT | Tool to create a new recipient for transfers. Use when you need to set up a recipient before initiating a transfer. Note: A duplicate account number will lead to retrieval of the existing record rather than creating a new one. | type, name, account_number, bank_code |
PAYSTACK_CREATE_VIRTUAL_TERMINAL | Create a Virtual Terminal on your Paystack integration to accept payments. Use this when you need to set up a new payment terminal for in-person or remote transactions with custom notification settings. | name, destinations |
PAYSTACK_DEACTIVATE_AUTHORIZATION | Tool to deactivate an authorization when a card or payment method needs to be forgotten. Use when customers want to remove saved payment methods from their account. | authorization_code |
PAYSTACK_DEACTIVATE_VIRTUAL_TERMINAL | Tool to deactivate a Virtual Terminal on your integration. Use when you need to disable a terminal and prevent it from accepting further payments. | code |
PAYSTACK_DELETE_PRODUCT | Delete a previously created product from Paystack by its ID. Use this when you need to remove a product from your catalog. The deletion is permanent and cannot be undone. | id |
PAYSTACK_DELETE_STOREFRONT | Delete a previously created storefront from Paystack by its ID. Use this when you need to remove a storefront. The deletion is permanent and cannot be undone. | id |
PAYSTACK_DELETE_TRANSFER_RECIPIENT | Tool to delete a transfer recipient by setting it to inactive status. Use when you need to remove a recipient from the active transfer list. | code |
PAYSTACK_DISABLE_OTP_FOR_TRANSFERS | Tool to disable OTP requirement for programmatic transfers. Use when you want to complete transfers without OTP verification. Returns an OTP needed to finalize the request. | - |
PAYSTACK_DISABLE_SUBSCRIPTION | Tool to disable a subscription on your Paystack integration. Use when you need to stop recurring charges for a customer subscription. Requires the subscription code and email verification token sent to the customer. | code, token |
PAYSTACK_DUPLICATE_STOREFRONT | Tool to duplicate a previously created Storefront. Use when you need to create a copy of an existing storefront with the same configuration. | id |
PAYSTACK_ENABLE_OTP_REQUIREMENT_FOR_TRANSFERS | Tool to enable OTP requirement for transfers. Use when a customer wants to stop being able to complete transfers programmatically and require OTP verification instead. | - |
PAYSTACK_EXPORT_TRANSACTIONS | Tool to export transactions from Paystack for a specific timeframe. Use when you need to download transaction data for reporting, analysis, or record-keeping purposes. The API returns a download link that expires after a certain time. | - |
PAYSTACK_FETCH_BALANCE | Tool to fetch the available balance on your Paystack integration. Use when you need to check account balance across different currencies. | - |
PAYSTACK_FETCH_BALANCE_LEDGER | Tool to fetch all pay-ins and pay-outs that went into your Paystack balance. Use when you need to view transaction history and balance changes over time. | - |
PAYSTACK_FETCH_BULK_CHARGE_BATCH | Tool to retrieve a specific bulk charge batch by code. Use when you need to check the progress of a bulk charge batch via its total_charges and pending_charges attributes. | code |
PAYSTACK_FETCH_CUSTOMER | Tool to get details of a customer on your integration. Use when you need to retrieve customer information using their customer code. | code |
PAYSTACK_FETCH_MANDATE_AUTHORIZATIONS | Tool to fetch the list of direct debit mandate authorizations associated with a customer. Use when you need to retrieve all mandate authorizations for a specific customer ID. | id |
PAYSTACK_FETCH_PAYMENT_PAGE | Tool to fetch details of a payment page on your Paystack integration. Use when you need to retrieve information about a specific payment page by its ID. | id |
PAYSTACK_FETCH_PAYMENT_REQUEST | Tool to fetch details of a payment request from Paystack. Use when you need to retrieve comprehensive information about a previously created payment request, including customer details, payment status, line items, and associated metadata. | id |
PAYSTACK_FETCH_PAYMENT_SESSION_TIMEOUT | Tool to fetch the payment session timeout configured on your Paystack integration. Use when you need to check the current timeout duration for payment sessions. | - |
PAYSTACK_FETCH_PLAN | Tool to get details of a plan on your integration. Use when you need to retrieve plan information using the plan code or ID. | code |
PAYSTACK_FETCH_PRODUCT | Tool to get details of a product on your integration. Use when you need to retrieve product information by its ID. | id |
PAYSTACK_FETCH_PRODUCT_ORDERS | Tool to fetch all orders for a particular product on your Paystack integration. Use when you need to retrieve order history and details for a specific product by its ID. | id |
PAYSTACK_FETCH_REFUND | Tool to get details of a refund on your integration. Use when you need to retrieve comprehensive information about a specific refund, including status, amount, customer details, and timestamps. | id |
PAYSTACK_FETCH_SPLIT | Tool to get details of a split configuration for a transaction. Use when you need to retrieve split payment configuration information by its ID. | id |
PAYSTACK_FETCH_STOREFRONT | Tool to get the details of a previously created Storefront. Use when you need to retrieve information about a specific storefront including its products, contacts, and configuration. | id |
PAYSTACK_FETCH_STOREFRONT_ORDERS | Tool to fetch all orders in a Paystack storefront. Use when you need to retrieve order information for a specific storefront using its ID. | id |
PAYSTACK_FETCH_SUBACCOUNT | Tool to get details of a subaccount on your integration. Use when you need to retrieve subaccount information using the subaccount code. | code |
PAYSTACK_FETCH_SUBSCRIPTION | Tool to get details of a subscription on your integration. Use when you need to retrieve subscription information using the subscription code. | code |
PAYSTACK_FETCH_TRANSACTION | Tool to get details of a transaction carried out on your integration. Use when you need to retrieve comprehensive information about a specific transaction, including payment status, customer details, authorization info, and timestamps. | id |
PAYSTACK_FETCH_TRANSACTION_TIMELINE | Tool to fetch the timeline of a transaction showing the steps taken from initiation to completion. Use when you need to debug payment flows or understand where customers encountered issues during the payment process. | id |
PAYSTACK_FETCH_TRANSFER_RECIPIENT | Tool to fetch details of a transfer recipient. Use when you need to retrieve information about an existing recipient using their recipient code. | code |
PAYSTACK_FETCH_VIRTUAL_TERMINAL | Tool to fetch a Virtual Terminal on your Paystack integration. Use when you need to retrieve details about an existing virtual terminal, including its configuration, payment methods, and active status. | code |
PAYSTACK_FINALIZE_PAYMENT_REQUEST | Tool to finalize the creation of a draft payment request for a customer. Use when you need to convert a draft payment request into an active one that can be paid by the customer. | id |
PAYSTACK_GENERATE_UPDATE_SUBSCRIPTION_LINK | Tool to generate a link for updating the card on a subscription. Use when you need to allow a customer to update their payment card for an active subscription. | code |
PAYSTACK_GET_PAYMENT_REQUEST_TOTALS | Tool to retrieve metrics for all pending and successful payment requests. Use when you need an overview of payment request amounts grouped by currency and status. | - |
PAYSTACK_GET_TRANSACTION_TOTALS | Tool to get the total amount received on your Paystack account. Use when you need to retrieve transaction totals and pending transfers, optionally filtered by date range. | - |
PAYSTACK_INITIALIZE_AUTHORIZATION | Tool to initialize a reusable authorization for recurring transactions. Use when you need to create a direct debit mandate that allows charging a customer's account repeatedly without requiring them to provide payment details each time. | email, channel |
PAYSTACK_INITIALIZE_TRANSACTION | Tool to initialize a transaction from your backend. Returns an authorization URL to redirect the customer to for payment. Use when you need to start a payment flow and get a checkout URL for the customer. | email, amount |
PAYSTACK_INITIATE_BULK_CHARGE | Tool to initiate a bulk charge on your integration. Use when you need to charge multiple customers at once using their authorization codes. | charges |
PAYSTACK_LIST_BANKS | Tool to get a list of all supported banks and their properties on Paystack. Use when you need to retrieve available banks for payments, transfers, or account verification. | - |
PAYSTACK_LIST_BULK_CHARGE_BATCHES | Tool to list bulk charge batches created on your integration. Use when you need to view all bulk charge batches, optionally filtering by status (active, paused, or complete) and paginating through results. | - |
PAYSTACK_LIST_CHARGES_IN_BATCH | Tool to retrieve the charges associated with a specified bulk charge batch. Use when you need to inspect individual charge details within a batch to monitor charge statuses or retrieve charge-level information. | code |
PAYSTACK_LIST_COUNTRIES | Tool to retrieve a list of countries that Paystack currently supports. Use when you need to know which countries are available for Paystack operations. | - |
PAYSTACK_LIST_CUSTOMERS | Tool to list customers available on your integration. Use when you need to retrieve all customers with optional filtering by date range and pagination support. | - |
PAYSTACK_LIST_DISPUTES | Tool to list transaction disputes filed by customers on your Paystack integration. Use when you need to retrieve disputes with optional filtering by status, transaction, or date range. | - |
PAYSTACK_LIST_DOMAINS | Tool to list all registered Apple Pay domains on your integration. Use when you need to retrieve domains configured for Apple Pay payments. | - |
PAYSTACK_LIST_MANDATE_AUTHORIZATIONS | Tool to get a list of all direct debit mandates on your integration. Use when you need to retrieve mandate authorizations with optional filtering by status and pagination support. | - |
PAYSTACK_LIST_ORDERS | Tool to list orders available on your integration. Use when you need to retrieve all orders with optional filtering by date range and pagination support. | - |
PAYSTACK_LIST_PAYMENT_PAGES | Tool to list payment pages available on your Paystack integration. Use when you need to retrieve all payment pages with optional filtering by date range and pagination. | - |
PAYSTACK_LIST_PAYMENT_REQUESTS | Tool to list all previously created payment requests to your customers. Use when you need to retrieve a list of payment requests with optional filters for customer, status, currency, or date range. | - |
PAYSTACK_LIST_PLANS | Tool to list all subscription plans available on your integration. Use when you need to retrieve plans, optionally filtering by interval, amount, or date range. | - |
PAYSTACK_LIST_PRODUCTS | Tool to list products available on your integration. Use when you need to retrieve all products with optional filtering by date range, active status, and pagination support. | - |
PAYSTACK_LIST_REFUNDS | Tool to list refunds available on your integration. Use when you need to retrieve a list of refunds with optional filters for date range and pagination. | - |
PAYSTACK_LIST_SETTLEMENTS | Tool to list settlements made to your settlement accounts. Use when you need to retrieve settlement information with optional pagination support. | - |
PAYSTACK_LIST_SPLITS | Tool to list the transaction splits available on your integration. Use when you need to retrieve all split configurations with optional filtering by name, status, subaccount, or date range. | - |
PAYSTACK_LIST_STATES_AVS | Tool to retrieve a list of states for a country for address verification. Use when you need to get available states/provinces for a specific country code. | country |
PAYSTACK_LIST_STOREFRONTS | Tool to list storefronts available on your integration. Use when you need to retrieve all storefronts with optional filtering by status and pagination support. | - |
PAYSTACK_LIST_STOREFRONT_PRODUCTS | Tool to list all products in a Paystack storefront. Use when you need to retrieve product information for a specific storefront using its ID. | id |
PAYSTACK_LIST_SUBACCOUNTS | Tool to list subaccounts available on your integration. Use when you need to retrieve all subaccounts with optional filtering by active status and pagination support. | - |
PAYSTACK_LIST_SUBSCRIPTIONS | Tool to list all subscriptions available on your integration. Use when you need to retrieve subscriptions, optionally filtering by plan, customer, or date range. | - |
PAYSTACK_LIST_TRANSACTIONS | Tool to list transactions that have occurred on your integration. Use when you need to retrieve all transactions with optional filtering by date range, status, source, channel, customer, and other criteria. Supports both cursor-based and page-based pagination. | - |
PAYSTACK_LIST_TRANSFERS | Tool to list all transfers carried out on your integration. Use when you need to retrieve transfer history with optional filtering by status, recipient, or date range. | - |
PAYSTACK_LIST_TRANSFER_RECIPIENTS | Tool to list transfer recipients available on your integration. Use when you need to retrieve all recipients with optional pagination support. | - |
PAYSTACK_LIST_VIRTUAL_TERMINALS | Tool to list virtual terminals available on your integration. Use when you need to retrieve all virtual terminals with pagination support. | - |
PAYSTACK_PAUSE_BULK_CHARGE | Tool to pause processing of a bulk charge batch. Use when you need to temporarily stop a bulk charge batch from processing further charges. | code |
PAYSTACK_PUBLISH_STOREFRONT | Tool to make a Storefront publicly available on Paystack. Use this when you need to publish a previously created storefront so that customers can access and purchase from it. | id |
PAYSTACK_REMOVE_SUBACCOUNT_FROM_SPLIT | Tool to remove a subaccount from a split configuration. Use this when you need to stop payment distribution to a specific partner or customer in an existing split. The share parameter must match the subaccount's current allocation. | id, subaccount, share |
PAYSTACK_RESEND_OTP_FOR_TRANSFER | Tool to resend OTP for a transfer. Use when a customer is having trouble receiving their OTP and needs a new one sent to complete their transfer. | transfer_code, reason |
PAYSTACK_RESOLVE_CARD_BIN | Tool to get basic information about a card BIN (Bank Identification Number). Use when you need to retrieve card details such as brand, issuing bank, country, and card type from the first 6 digits of a card. | bin |
PAYSTACK_RESUME_BULK_CHARGE_BATCH | Tool to resume processing of a previously paused bulk charge batch. Use when you need to restart a paused bulk charge batch using its batch code. | code |
PAYSTACK_SEND_PAYMENT_REQUEST_NOTIFICATION | Tool to send an email notification to a customer for a previously created payment request. Use when you need to remind a customer about an unpaid invoice or payment request. | id |
PAYSTACK_SEND_SUBSCRIPTION_UPDATE_LINK | Tool to send an email to the customer with a link to update the card on their subscription. Use when a customer needs to update their payment card for an active subscription and you want to notify them via email. | code |
PAYSTACK_SET_RISK_ACTION | Tool to set a customer's risk action by whitelisting or blacklisting them. Use when you need to apply fraud prevention rules to a specific customer by setting their risk action to 'allow' (whitelist), 'deny' (blacklist), or 'default' (no special action). | customer |
PAYSTACK_SUBMIT_PHONE | Tool to submit phone number when requested during a charge transaction. Use this when a charge requires phone number submission for verification or authentication purposes. | phone, reference |
PAYSTACK_TRIGGER_DIRECT_DEBIT_ACTIVATION_CHARGE | Tool to trigger an activation charge on an inactive direct debit mandate for a customer. Use when a mandate needs to be reactivated or retried. | id, authorization_id |
PAYSTACK_UNASSIGN_DESTINATION_FROM_VIRTUAL_TERMINAL | Tool to unassign WhatsApp destinations from a Virtual Terminal. Use when you need to remove recipients who should no longer receive payment notifications for a specific Virtual Terminal. | code, targets |
PAYSTACK_UNREGISTER_APPLE_PAY_DOMAIN | Tool to unregister a top-level domain or subdomain previously used for Apple Pay integration. Use when you need to remove a domain from your Apple Pay configuration. | domainName |
PAYSTACK_UPDATE_CUSTOMER | Tool to update a customer's details on your Paystack integration. Use when you need to modify existing customer information such as name, phone number, or metadata. | code |
PAYSTACK_UPDATE_PAYMENT_PAGE | Tool to update a payment page on your Paystack integration. Use when you need to modify details of an existing payment page such as name, description, amount, or active status. | id |
PAYSTACK_UPDATE_PAYMENT_REQUEST | Tool to update a payment request on your Paystack integration. Use when you need to modify details of an existing payment request such as amount, description, due date, or other attributes. | id |
PAYSTACK_UPDATE_PAYMENT_SESSION_TIMEOUT | Tool to update the payment session timeout on your Paystack integration. Use when you need to change the duration before a payment session expires. | timeout |
PAYSTACK_UPDATE_PLAN | Tool to update a plan's details on your Paystack integration. Use when you need to modify an existing plan's name, amount, interval, or other settings. Only the fields you provide will be updated; other fields remain unchanged. | code |
PAYSTACK_UPDATE_PRODUCT | Tool to update a product on your integration. Use when you need to modify product details like name, description, price, or currency. | id |
PAYSTACK_UPDATE_SPLIT | Tool to update a split configuration for transactions. Use when you need to modify split settings such as name, active status, or bearer type. | id |
PAYSTACK_UPDATE_STOREFRONT | Tool to update the details of a previously created Storefront. Use when you need to modify storefront information such as name, description, or slug. | id |
PAYSTACK_UPDATE_SUBACCOUNT | Tool to update a subaccount's details on your Paystack integration. Use when you need to modify existing subaccount information such as business name, bank details, contact information, or activation status. | code |
PAYSTACK_UPDATE_TRANSFER_RECIPIENT | Tool to update the details of a transfer recipient. Use when you need to modify an existing recipient's name or email address. | code |
PAYSTACK_VALIDATE_BANK_ACCOUNT | Tool to validate the authenticity of a customer's bank account before sending money. Use when you need to confirm account details are correct and the account is active and can receive funds. | account_number, account_name, account_type, bank_code, country_code, document_type |
PAYSTACK_VALIDATE_CUSTOMER | Tool to validate a customer's identity on your Paystack integration. Use when you need to verify customer identification details such as BVN and bank account information. The verification happens asynchronously, and Paystack sends a webhook event when verific… | code, first_name, last_name, type, country, bvn, bank_code, account_number |
PAYSTACK_VALIDATE_ORDER | Tool to validate a pay for me order on Paystack. Use when you need to verify the details and status of a previously created order using its unique order code. | code |
PAYSTACK_VERIFY_PAYMENT_REQUEST | Tool to verify the status of a previously created payment request on Paystack. Use when you need to check if a payment request has been paid or to retrieve details about a specific payment request using its request code. | id |
PAYSTACK_VERIFY_STOREFRONT_SLUG | Tool to verify the availability of a slug before using it for a Storefront. Use when you need to check if a slug is available before creating a new storefront. | slug |
PAYSTACK_VERIFY_TRANSACTION | Tool to confirm the status of a transaction using its reference. Use when you need to verify a payment was successful or check the current state of a transaction after customer completes checkout. | reference |
Links
We love our partners - FlyMy.AI builds with the best. Thanks, Paystack!