Skip to main content
Use Paystack through Corsair: one client, typed API calls, and incoming webhooks. Authenticate with the secret key from Developers > API Keys & Webhooks (sk_test_ for test, sk_live_ for live); the plugin sends it as an Authorization Bearer token. Amounts are in the currency subunit (kobo for NGN, pesewas for GHS). Paystack answers some validation failures with HTTP 200 and status false in the body; the plugin turns those into errors so a caller never reads them as data. Some routes documented on the site (charge authorization, partial debit, timeline, totals, export, customer identification and direct debit, transfers, verification, payment pages) are not part of this plugin. Webhook deliveries come in two documented schemes: the legacy x-paystack-signature header (HMAC-SHA512 of the raw body keyed with your secret key) and the current Paystack-Signature header (t=…,v1=…, keyed with the whsec_ signing secret, 300-second timestamp tolerance). The plugin verifies whichever scheme a delivery uses; pass the matching secret as webhookSecret. Paystack delivers only from 52.31.139.75, 52.49.173.169 and 52.214.14.220. Every operation is described in the official docs: https://paystack.com/docs/api/ What you get:
  • 21 typed API operations
  • 1 incoming webhook event types

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

Verify a transaction
Start a checkout
See the full list on the API page.

Webhooks

This plugin registers 1 webhook event type. Configure the provider to POST to your Corsair HTTP handler, then use webhookHooks on the plugin factory. See Webhooks for every event path and payload shape, and Webhooks concept for routing.

What’s next

API reference

Every paystack.api.* operation with input and output types.

Webhooks

Event paths, payloads, and webhookHooks examples.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.