Donations

Create tip-jar style donation links with a default amount, suggested presets, and an optional custom-amount toggle.

Donations are reusable payment links with a configurable Default donation amount (required, default 10.00), optional Suggested amounts presets shown to supporters, and an Allow custom amount toggle. With custom amounts enabled, supporters can override the default at checkout — similar to a tip jar.

How donations work

When a supporter opens a donation link, the payzum hosted checkout shows the configured default amount and any suggested presets. If custom amounts are allowed, the supporter can enter a different amount. Once they confirm, a crypto invoice is generated. The resulting invoice is tagged with invoice_type: donation in the IPN payload, which you can use in your webhook handler to distinguish donations from regular payments or subscriptions.

Creating a donation link

Go to Merchants → [your merchant] → Donations.
Click + New donation link.
Fill in the Reference / order ID (optional) and Description (optional) fields.
Click Create donation link. The link is created and listed in the donations table.

You can share the generated link directly or embed it as a button using the payzum embeddable widget. Each click on the link starts a fresh invoice scoped to that donation session.

Donation links are reusable — each visitor who opens the link gets their own invoice.

Viewing donation payments

Paid donations appear in the Invoices list for the merchant. You can also receive IPN notifications for each completed donation — configure your webhook URL in merchant settings to get real-time callbacks.

IPN handling

The IPN payload for a completed donation includes invoice_type: "donation" so your server can credit the supporter, send a thank-you email, or trigger any other downstream flow. See Payment IPN for the full payload shape.