Paystack

Paystack Create Refund

Create a refund for a Paystack transaction. Pass the transaction reference or ID from list_transactions. Omit amount for a full refund, or specify amount in subunits for a partial refund. Only successful transactions can be refunded.

Paystack Create Transaction

Initialize a new Paystack transaction. Returns authorization_url (payment link to send to customer), access_code, and reference. This does NOT charge the customer — they must visit the authorization_url to complete payment. Amount is in subunits (kobo): 5000 = NGN 50.

Paystack Create Transfer

Initiate a transfer (payout) from your Paystack balance to a recipient. Requires amount in subunits and a recipient_code (RCP_xxx) from create_transfer_recipient. Source is always your Paystack balance. Returns transfer_code and status.

Paystack Create Transfer Recipient

Create a transfer recipient for payouts. Requires recipient type (nuban/ghipss/mobile_money/basa), name, account_number, and bank_code (from Paystack's bank list). Returns a recipient_code needed to initiate transfers via create_transfer.

Paystack List Customers

List customers on your Paystack account. Returns email, customer_code, first_name, last_name, phone, metadata, and risk_action for each customer. Use to find a customer before looking up their transactions or subscriptions.

Paystack List Disputes

List payment disputes (chargebacks) on your Paystack account. Returns dispute ID, status (awaiting-merchant-feedback, awaiting-bank-feedback, pending, resolved), amount, currency, transaction reference, and resolution details. Use to monitor chargebacks and identify transactions needing attention.

Paystack List Invoices

List payment requests (invoices) on your Paystack account. Returns request_code, amount (in subunits), currency, status (pending/paid), customer email, description, and offline_reference. Use to track outstanding invoices and follow up on unpaid requests.

Paystack List Refunds

List refunds processed on your Paystack account. Returns refund ID, amount (in subunits — divide by 100 for display), currency, status, transaction reference, and merchant note. Use for accounting reconciliation or tracking customer refund requests.

Paystack List Settlements

List settlements (payouts) from Paystack to your bank account. Returns settlement ID, total_amount, settled_amount, currency, settlement_date, and deductions. Use for financial reconciliation — correlate with transactions and transfers to track fund flow.

Paystack List Subscriptions

List subscriptions on your Paystack account. Returns subscription_code, status (active, non-renewing, attention, completed, cancelled), plan details, customer email, next_payment_date, and email_token. Use to monitor recurring billing and identify subscriptions needing attention.

Paystack List Transactions

List transactions on your Paystack account. Returns transaction ID, reference, amount (in subunits — divide by 100 for display), currency, status (success/abandoned/failed), channel (card/bank/ussd/mobile_money), customer email, paid_at timestamp, and authorization details. The primary tool for reviewing payment activity and sales volume.

Paystack List Transfers

List transfers (payouts) initiated from your Paystack balance. Returns transfer_code, amount (in subunits), currency, status (success/pending/failed/reversed), recipient details, reason, and created_at. Use to audit outbound payments and reconcile with settlements.

Paystack Upsert Customer

Create or update a Paystack customer. To create: provide email (required), first_name, last_name, phone, metadata. To update: provide customer_code (CUS_xxx from list_customers) plus fields to change. Returns the customer object with customer_code for use in transactions and subscriptions.