Connect Paystack to AI agents

Connect Paystack to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

Supported Tools

list_dedicated_virtual_accounts

List Dedicated Virtual Accounts

Retrieve a list of dedicated virtual accounts on your integration. Filter by active status, currency, provider, or customer.

update_plan

Update Plan

Update an existing subscription plan. Modify the name, amount, interval, description, and notification settings.

create_refund

Create Refund

Create a refund for a completed transaction. You can refund the full amount or a partial amount. Refunds go through statuses: pending, processing, processed, success/failed.

resolve_dispute

Resolve Dispute

Resolve a transaction dispute by providing evidence or accepting the dispute with a refund.

list_plans

List Plans

Retrieve a paginated list of subscription plans on your integration. Filter by status, interval, or amount.

list_customers

List Customers

Retrieve a paginated list of customers on your integration. Supports filtering by date range.

charge_authorization

Charge Authorization

Charge a customer's saved payment authorization from a previous successful transaction. Useful for recurring payments, one-click checkout, and billing customers without redirecting them. Amounts are in the **smallest currency unit**.

list_disputes

List Disputes

Retrieve a paginated list of transaction disputes. Filter by status, transaction, or date range.

list_payment_pages

List Payment Pages

Retrieve a paginated list of payment pages on your integration.

list_subaccounts

List Subaccounts

Retrieve a paginated list of subaccounts on your integration.

list_banks

List Banks

Retrieve the list of supported banks and their codes. Use this to find the bank code needed for verifying accounts and creating transfer recipients.

get_customer

Get Customer

Fetch details for a single customer by email or customer code. Returns full customer profile including transactions and subscriptions.

update_customer

Update Customer

Update an existing customer's details. Can modify name, phone, and metadata. Can also whitelist or blacklist a customer by setting the risk action.

list_refunds

List Refunds

Retrieve a paginated list of refunds on your integration. Filter by reference, currency, or date range.

list_payment_requests

List Payment Requests

Retrieve a paginated list of payment requests/invoices. Filter by customer, status, currency, or date range.

create_customer

Create Customer

Create a new customer record on your Paystack integration. Customers are used to track payment history and manage recurring billing.

list_transactions

List Transactions

Retrieve a list of transactions on your integration. Supports filtering by status, customer, date range, and amount. Returns paginated results.

create_payment_page

Create Payment Page

Create a hosted payment page that can be shared via link. Useful for collecting payments without building a custom checkout. Amount is in the **smallest currency unit**. Leave amount empty to let the customer enter an amount.

list_transfers

List Transfers

Retrieve a paginated list of transfers. Filter by date range.

create_subaccount

Create Subaccount

Create a subaccount for splitting payments. Subaccounts represent third-party businesses or vendors that receive a portion of each transaction.

initiate_transfer

Initiate Transfer

Send money to a bank account or mobile money number. You must first create a transfer recipient, then use their recipient code here. The source is always "balance". Amounts are in the **smallest currency unit**.

disable_subscription

Disable Subscription

Cancel/disable an active subscription. Requires the subscription code and the email token (returned when the subscription was created or can be found in subscription details).

update_payment_page

Update Payment Page

Update an existing payment page's name, description, amount, or active status.

create_plan

Create Plan

Create a subscription plan that defines recurring billing parameters. Plans specify the amount, currency, and billing interval for automatic charges. Amounts are in the **smallest currency unit** (e.g., kobo for NGN).

verify_bank_account

Verify Bank Account

Resolve and verify a bank account number. Returns the account name for confirmation before creating a transfer recipient. Use the List Banks tool to get the bank code.

create_transfer_recipient

Create Transfer Recipient

Create a transfer recipient (bank account or mobile money) to receive funds. The recipient code can then be used to initiate transfers.

resolve_card_bin

Resolve Card BIN

Look up card details using the first 6 digits (BIN) of a card number. Returns the card brand, type, issuing bank, and country.

create_subscription

Create Subscription

Subscribe a customer to an existing plan. The customer must have a valid payment authorization (from a previous transaction). Supports card and direct debit (Nigeria).

initialize_transaction

Initialize Transaction

Initialize a new payment transaction on Paystack. Returns an authorization URL where the customer can complete payment, or use for programmatic charge flows. Amounts are in the **smallest currency unit** (e.g., kobo for NGN: NGN 100 = 10000).

create_payment_request

Create Payment Request

Create and send an invoice/payment request to a customer. Supports line items, tax, due dates, and notifications. Amounts are in the **smallest currency unit**.

list_subscriptions

List Subscriptions

Retrieve a paginated list of subscriptions. Filter by customer or plan.

list_settlements

List Settlements

Retrieve a paginated list of settlements (payouts) made by Paystack to your bank account. Provides insight into when funds were settled and for how much.

get_subscription

Get Subscription

Fetch details for a single subscription by its ID or code. Returns the subscription's status, plan, customer, billing history, and next payment date.

enable_subscription

Enable Subscription

Re-enable a previously disabled subscription. Requires the subscription code and the email token.

verify_transaction

Verify Transaction

Verify the status of a transaction using its reference. Returns full transaction details including payment status, amount, customer, and authorization info.

create_dedicated_virtual_account

Create Dedicated Virtual Account

Create a dedicated virtual bank account (DVA) for a customer. All bank transfers to this account are automatically recorded as transactions from the customer. Currently only available for Nigeria-based businesses.

More integrations teams use with Paystack

Shopify

Manage e-commerce stores including products, orders, customers, inventory, and fulfillment. Create and update products with variants, images, and metafields. Process and track orders, draft orders, refunds, and transactions. Manage customer records, addresses, and marketing consent. Track and adjust inventory levels across multiple locations. Handle fulfillment workflows including routing to warehouses and third-party logistics. Create and manage discount codes, price rules, and automatic discounts. Configure shipping rates, carrier services, and delivery profiles. Build custom storefronts with cart management and checkout via the Storefront API. Manage content including pages, blogs, articles, and themes. Support B2B commerce with company profiles, catalogs, and custom pricing. Receive webhooks for events across orders, products, customers, inventory, fulfillment, collections, carts, checkouts, disputes, and more.

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Stripe

Process payments, manage subscriptions, and handle invoices. Create and manage customers, payment methods, and product catalogs. Issue refunds, handle disputes, and submit chargeback evidence. Create checkout sessions and payment links. Manage connected accounts and platform fund flows via Stripe Connect. Configure payouts to bank accounts and debit cards. Apply coupons and promotion codes to subscriptions and invoices. Calculate and collect taxes automatically. Access balance information and transaction history. Upload files for dispute evidence and identity verification. Create and manage virtual and physical payment cards via Issuing. Receive real-time webhook notifications for payment, subscription, invoice, and account events.

Abstract

Validate, enrich, and look up data through a suite of utility APIs. Validate email addresses for deliverability, format, and risk (disposable, spam trap, role-based detection). Validate and identify phone numbers with carrier, line type, and location details. Geolocate IP addresses and detect VPNs, proxies, and TOR usage. Enrich company data from domains or emails. Retrieve live and historical currency exchange rates and perform conversions. Look up public holidays by country and date. Get current time and convert between timezones. Scrape web page content from URLs. Capture website screenshots. Compress and optimize images. Generate user avatars. Validate VAT numbers and retrieve VAT rates. Validate IBAN bank account numbers.

Acculynx

Manage roofing contractor business operations including jobs, contacts, estimates, invoices, and payments. Create and search jobs with milestone tracking, assign representatives, and monitor job lifecycle events. Create and retrieve contacts with communication logging. Access estimates, supplements, and financial worksheets. Create and manage invoices, payments, and expenses. Schedule and update appointments via calendars. Upload documents, photos, and videos to jobs. Retrieve company settings such as insurance companies, lead sources, milestones, and trade types. Access reports and manage webhook subscriptions for real-time event notifications on job, contact, and financial changes.

Acuity Scheduling

Create, retrieve, update, cancel, and reschedule appointments. Manage availability by querying open dates and time slots for appointment types and calendars. Block time slots to prevent bookings. Manage client records including creation, retrieval, updates, and deletion. List appointment types, add-ons, calendars, and intake forms. Create and validate gift certificates, packages, and coupons. Retrieve orders and product listings. Subscribe to webhooks for appointment and order events.

Technical notes for Paystack

Process payments and manage transactions for African businesses. Initialize and verify transactions across multiple payment channels including cards, bank transfers, USSD, mobile money, and QR codes. Create and manage customers, subscriptions, and recurring billing plans. Issue refunds, handle disputes, and track settlements. Transfer funds to bank accounts and mobile money recipients individually or in bulk. Split transaction settlements across multiple subaccounts. Create dedicated virtual accounts for customers, generate payment pages and invoices, and manage products, storefronts, and orders. Verify bank accounts, cards, and customer identities. Receive real-time webhook notifications for transaction, transfer, subscription, invoice, refund, and dispute events.

Connect Paystack to production AI agents

See how Metorial gives Paystack access the governance, tracing, and security controls teams need.

Frequently asked questions

Common questions about connecting Paystack to AI agents with Metorial.

  1. Can Metorial connect Paystack to AI agents?
    Yes. Metorial connects AI agents to Paystack through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.