Use Only One Widget per Page
Donorfy Web Widgets cannot operate correctly when more than one widget is present on a single webpage.
Only add one widget per page.
Do not include a hidden widget on the same page.
Do not place Stripe and GoCardless widgets on the same webpage.
Using Squarespace
Squarespace requires additional steps to embed Web Widgets correctly.
See: Using Widgets in Squarespace
Use HTTPS and an SSL Certificate
Your donation page must load over https://, not http://.
If your page loads as Not Secure, the widget may fail to initialise.
Avoid iFrames (GoCardless)
GoCardless Web Widgets cannot be placed inside an iFrame.
Remove the iFrame and embed the HTML directly into the page.
Check the Error Log in Donorfy
Error details are intentionally limited in the widget to prevent exposing sensitive information.
To view full error information:
Go to Financial, click Online Donations.
Open the Errors & Info tab.
Review any errors linked to the failed submission.
Check Browser Console Errors
Open your browser’s developer tools.
View the Console.
Reload the donation page and look for JavaScript errors.
Common issues include:
Missing or incompatible jQuery versions.
Incorrect script loading order.
If you see jQuery-related errors, add the script reference near the top of the <head>:
<script type="text/javascript" src="https://ajax.aspnetcdn.com/ajax/jquery/jquery-1.9.1.min.js"></script>
You may need assistance from your web developer to resolve script dependency issues.
Fix “Not Secure” Warnings
If your page displays as Not Secure, it may be loading assets over http.
Example of incorrect image reference:
<img id="img-spinner" src="http://cdn.donorfy.com/wwimages/loading.gif" alt="Loading">
Replace the source with an https version:
Fix Invalid Settings Errors
Messages such as:
Invalid GoCardless Settings
Invalid Stripe Settings
Permission errors for Stripe keys
These indicate that your Donorfy connection to the payment provider is incorrect.
To resolve:
Disconnect from Stripe or GoCardless.
Reconnect using the correct account credentials.
Stripe Key Errors and Publishable Key Issues
Common messages include:
“No such token… a similar object exists in test mode”
“Use your platform’s publishable key combined with the stripeAccount parameter”
This means the Stripe Publishable Key in your widget does not match the one used by your Stripe Connect integration.
To resolve:
Regenerate the widget in Donorfy.
Locate the updated PublishableKey field.
Copy the updated key into your widget HTML.
Example:
<input type="hidden" id="PublishableKey" value="pk_xxxxxxxx">
📌 Note: Web Widgets cannot use test publishable keys.
To test, use a real card for a £1 donation, then cancel the transaction in Stripe.
Wrong Page Displayed After Direct Debit Signup
If supporters are redirected to the Donorfy default error page (https://donorfy.com/payment-error), the widget URLs may be invalid.
Check that:
Thank-you URLs are present.
Full URLs are used (e.g. https://example.org/thankyou)
URLs do not contain:
Query parameters
Dashes or characters outside letters/numbers
Correct any invalid URLs in your Web Widget settings.
Stripe Amount Mismatch
If Stripe debits a smaller amount than Donorfy shows (e.g. £0.55 instead of £55):
The Amount field must include a decimal:
Correct:
<input type="hidden" name="Amount" value="55.00" id="Amount">
Incorrect:
<input type="hidden" name="Amount" value="55" id="Amount">
Missing or Non-Functional Stripe Card Fields
Possible causes include:
Cookie management tools blocking Stripe scripts.
Disable cookie blocking on the donation page.Strong Customer Authentication fields not styled.
If placeholder text appears (e.g. “1234 1234 1234 1234”), the widget is working.
You can style the Stripe Elements fields using yourInitialiseFormfunction.
Fix “$ is not a function” Errors
Add jQuery at the top of your widget code:
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.7.1/jquery.min.js"></script>
Fix Invalid Widget ID Issues
Errors such as:
“Invalid widgetId”
“Invalid payment owner”
Indicate that the WidgetId is incorrect or missing.
Check your hidden field:
<input type="hidden" id="WidgetId" value="xxxxxxx-xxxx-xxx-xxxx-xxxxxxxxxxxx" />
If the ID is all zeros or missing:
Regenerate the widget HTML in Donorfy.
Replace the widget HTML on your webpage.
⚠️Important:
Web Widgets are a Professional only feature. Essential subscribers, please contact us to find out more about upgrading.