Donation Thank You

FREE block. The post-payment confirmation screen shown to donors after completing a donation.

Why use this

A thank-you page confirms to the donor that their payment was received, shows a summary of what they gave, and provides a way to return to the campaign.

What it does

The block reads the ?donation_id= and ?token= URL parameters set after a successful payment redirect. It verifies access using one of four methods: a valid token, a cookie set during the donation session, the logged-in user’s email matching the donor’s email, or administrator capability.

The block adapts its title and message based on the payment status:

Status	Display
paid or completed	Success title and message
cancelled or canceled	Cancellation message
failed or expired	Failure message
pending or open	Pending message

For paid donations, the block shows an itemised breakdown including the donation amount, optional platform tip, and any WooCommerce products added (PRO feature). A back button returns the donor to the originating action.

How to use it

1. The Thank You page is created automatically during plugin setup. It contains this block.
2. Customise the title and message for each payment state in the block inspector.
3. Toggle the donor name, amount, and payment method display on or off.
4. Set the back button text and color.

Settings and options

Option	Type	Default	Description
Success title	string	—	Title for paid/completed status
Success message	string	—	Body text for paid/completed status
Cancelled title	string	—	Title for cancelled status
Cancelled message	string	—	Body text for cancelled status
Failed title	string	—	Title for failed/expired status
Failed message	string	—	Body text for failed/expired status
Pending title	string	—	Title for pending/open status
Pending message	string	—	Body text for pending/open status
Show amount	boolean	true	Display the donation total
Show donor	boolean	true	Display the donor’s name
Show payment method	boolean	true	Display the payment method used
Amount label	string	—	Custom label for the total line
Donation label	string	—	Custom label for the donation-only line
Platform tip label	string	—	Custom label for the tip line
Donor label	string	—	Custom label for the donor name line
Payment method label	string	—	Custom label for the payment method line
Products label	string	—	Custom label for the products section
Button text	string	Return to Campaign	Back button label
Button color	string	#4a9d44	Back button background
Button text color	string	#ffffff	Back button text color
Button hover color	string	#c62d43	Back button hover color
Button font size	number	16	Back button font size
Button line height	number	1.5	Back button line height
Border radius	number	6	Back button corner rounding

What you can and cannot do

• You cannot access this page directly without a valid donation ID and token (or matching session/login). Attempting to view it without these parameters shows no donation data.
• The WooCommerce product breakdown is only shown when Fundations Pro and WooCommerce are both active.
• The back button target is always the originating action’s permalink; it cannot be customised to an arbitrary URL.

Troubleshooting

Page shows no donation data: The ?donation_id= and ?token= parameters are missing. This page should only be reached via the payment provider redirect, not navigated to directly.

Wrong status message is shown: The payment provider webhook may not have updated the donation status before the donor was redirected. Wait a few seconds and refresh. If the problem persists, check the webhook configuration in your payment provider dashboard.