SkillsAdd

rexedge/paystack

paystack-payment-requests

>- Paystack Payment Requests (Invoicing) API — create, manage, and send payment requests (invoices) to customers. Supports line items, taxes, due dates, draft mode, auto invoice numbering, split payments, email notifications, and archiving. Use this skill whenever building invoicing systems, sending payment requests to customers, managing invoice line items and taxes, tracking invoice totals and statuses, or implementing B2B payment collection. Also use when you see references to /paymentreques…

First seen Mar 8, 2026

Installation

$ npx skills add rexedge/paystack --skill paystack-payment-requests
View on skills.sh ↗ GitHub repository ↗

Also in this package

Other skills from rexedge/paystack · top by installs.

npx skills add rexedge/paystack
paystack-transfers 76 paystack-setup 62 paystack-transfer-recipients 36 paystack-transactions 33 paystack-disputes 31 paystack-webhooks 27 paystack-testing 24 paystack-charges 24 paystack-subscriptions 24 paystack-plans 24

Browse all from rexedge/paystack

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1
License MIT
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,795 B
  • docs SUMMARY.md 613 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 23 installs

SKILL.md

Paystack Payment Requests

The Payment Requests API lets you create and manage invoices for goods and services.

Depends on: paystack-setup for the paystackRequest helper.
Related: paystack-customers for customer codes used in requests.

Endpoints

Method Endpoint Description
POST /paymentrequest Create a payment request
GET /paymentrequest List payment requests
GET /paymentrequest/:idorcode Fetch a payment request
PUT /paymentrequest/:idorcode Update a payment request
GET /paymentrequest/verify/:code Verify a payment request
POST /paymentrequest/notify/:code Send notification
GET /paymentrequest/totals Get totals/metrics
POST /paymentrequest/finalize/:code Finalize a draft
POST /paymentrequest/archive/:code Archive a request

Create Payment Request

Param Type Required Description
customer string Yes Customer ID or code
amount integer No Amount in subunits (if no line items)
due_date datetime No ISO 8601 due date
description string No Short description
line_items array No [{ name, amount, quantity? }]
tax array No [{ name, amount }]
currency string No Currency code (default: NGN)
send_notification boolean No Send email (default: true)
draft boolean No Save as draft (default: false)
has_invoice boolean No Add auto-incrementing invoice number
invoice_number integer No Override invoice number
split_code string No Split code for revenue sharing 
// Invoice with line items and tax
const invoice = await paystackRequest<{
  id: number;
  request_code: string;
  invoice_number: number;
}>("/paymentrequest", {
  method: "POST",
  body: JSON.stringify({
    customer: "CUS_xwaj0txjryg393b",
    description: "Q1 2024 Services",
    due_date: "2024-03-31",
    line_items: [
      { name: "Consulting (10 hours)", amount: 500000, quantity: 1 },
      { name: "Design work", amount: 200000, quantity: 1 },
    ],
    tax: [
      { name: "VAT (7.5%)", amount: 52500 },
    ],
    send_notification: true,
    has_invoice: true,
  }),
});
// invoice.data.request_code → "PRQ_1weqqsn2wwzgft8"

// Draft invoice (no notification sent)
await paystackRequest("/paymentrequest", {
  method: "POST",
  body: JSON.stringify({
    customer: "CUS_xwaj0txjryg393b",
    amount: 100000,
    description: "Draft invoice",
    draft: true,
  }),
});

List Payment Requests

const requests = await paystackRequest(
  "/paymentrequest?status=pending&currency=NGN&perPage=20"
);

Fetch / Verify

// Fetch
const req = await paystackRequest(`/paymentrequest/${encodeURIComponent("PRQ_code")}`);

// Verify (includes payment status)
const verified = await paystackRequest(
  `/paymentrequest/verify/${encodeURIComponent("PRQ_code")}`
);

Send Notification

Re-send the payment request email to the customer:

await paystackRequest(`/paymentrequest/notify/${encodeURIComponent("PRQ_code")}`, {
  method: "POST",
});

Get Totals

const totals = await paystackRequest("/paymentrequest/totals");
// totals.data.pending → [{ currency: "NGN", amount: 42000 }]
// totals.data.successful → [{ currency: "NGN", amount: 0 }]
// totals.data.total → [{ currency: "NGN", amount: 42000 }]

Finalize Draft

await paystackRequest(`/paymentrequest/finalize/${encodeURIComponent("PRQ_code")}`, {
  method: "POST",
  body: JSON.stringify({ send_notification: true }),
});

Update Payment Request

await paystackRequest(`/paymentrequest/${encodeURIComponent("PRQ_code")}`, {
  method: "PUT",
  body: JSON.stringify({
    customer: "CUS_xwaj0txjryg393b",
    description: "Updated invoice",
    due_date: "2024-06-30",
    amount: 150000,
  }),
});

Archive

await paystackRequest(`/paymentrequest/archive/${encodeURIComponent("PRQ_code")}`, {
  method: "POST",
});