Start a Donation

​

What happens after you call it

1. You get back a checkout_url and a transaction_id. The donation is recorded as pending.
2. The donor opens the link and pays. If you sent a redirect_url, they land back there afterwards.
3. The payment provider confirms the payment to Transparency Hub, the donation turns paid, and it shows up in the campaign in the app.
4. Check on it any time with GET /v1/transactions/{transaction_id}, or list a campaign’s giving with List Campaign Payments (GET /v1/fundraising/campaigns/{campaign_id}/payments).

​

Things worth knowing

• amount is in normal money units — 150 means 150.00 — and must be at least 1. The currency defaults to the campaign’s.
• cover_fees: true adds the provider’s fee on top, so the campaign receives the full amount.
• The chapter must have finished setting up a payment method; if it has not, you get 409 with a message saying so.
• payment_gateway_id is only needed when a chapter has more than one method set up and you want a particular one.

{
  "amount": 150,
  "donor_name": "Ada Lovelace",
  "donor_email": "ada@example.org",
  "cover_fees": true,
  "redirect_url": "https://alumni.example.org/thank-you"
}

{
  "status": "success",
  "data": {
    "checkout_url": "https://checkout.paystack.com/abc123",
    "transaction_id": 501,
    "transaction_ref": "THN-2026-0001",
    "amount": 150.0,
    "currency": "NGN",
    "payment_status": "pending",
    "campaign_id": 2
  }
}