Title: Joedavtian Donations for PlanetStudio Payment Gateway Author: joedavtian Published: October 31, 2026 Last modified: October 31, 2026 --- Search plugins ![](https://ps.w.org/joedavtian-donations-for-planetstudio-payment-gateway/assets/ banner-772x250.png?rev=3776482) ![](https://ps.w.org/joedavtian-donations-for-planetstudio-payment-gateway/assets/ icon-256x256.png?rev=3776482) # Joedavtian Donations for PlanetStudio Payment Gateway By [joedavtian](https://profiles.wordpress.org/joedavtian/) [Download](https://downloads.wordpress.org/plugin/joedavtian-donations-for-planetstudio-payment-gateway.1.0.3.zip) * [Details](https://wordpress.org/plugins/joedavtian-donations-for-planetstudio-payment-gateway/#description) * [Reviews](https://wordpress.org/plugins/joedavtian-donations-for-planetstudio-payment-gateway/#reviews) * [Installation](https://wordpress.org/plugins/joedavtian-donations-for-planetstudio-payment-gateway/#installation) * [Development](https://wordpress.org/plugins/joedavtian-donations-for-planetstudio-payment-gateway/#developers) [Support](https://wordpress.org/support/plugin/joedavtian-donations-for-planetstudio-payment-gateway/) ## Description Joedavtian Donations for PlanetStudio Payment Gateway adds a three-step donation form, fundraising campaigns and monthly or weekly recurring donations to any WordPress site. Payments go through [PlanetStudio Payment Gateway](https://www.planetstudio.am)( PSPG) and whichever bank you have configured there. It keeps its own donor, donation and recurring-donation records, so it does not need GiveWP or WooCommerce. This is an independent add-on. It is not made or supported by PlanetStudio. **Donation form** * Three steps: amount, details, review. One-time, monthly and weekly giving (each can be switched off). * Suggested amounts, minimums and maximums per currency, checked again on the server. * Donors pay in the currency they choose. Nothing is converted at payment time. * Works behind page caches and CDNs: the security tokens are fetched when the page is on screen, not printed into it. * Honeypot, minimum fill time and a per-address throttle stop scripted submissions before any bank order is created. Optional Cloudflare Turnstile check, using the keys you already saved in PSPG. * Errors send the donor back to the form, in their own language, with everything they typed still filled in. * Its script and stylesheet load only on pages that show the form or a campaign. **Campaigns** * A Campaign post type with a goal, an end date, a progress bar and an optional supporters list. * Optionally, donations in several currencies are combined into one progress figure using a daily exchange rate. Visitors can switch the figure between currencies. * A campaign closes when its end date passes. Tick “Stop taking donations when the goal is reached” on a campaign to also close it at its goal; otherwise it keeps taking donations past 100%. * When a campaign closes, its recurring donations are ended, the bank is asked to release the saved cards, and the donors are emailed. **Recurring donations** * Offered through ArCa-network banks in PSPG, the saved-card path that has been proven in production. Other banks take one-time donations. * Charged hourly on the donor’s sign-up anniversary, with retries after 3, 7 and 14 days before cancelling. A declined charge is retried and the donor told; a charge the bank never confirms is checked again rather than counted. * A run charges for 20 seconds at a time; if charges are still due, it continues a minute later, so a busy sign-up day is not charged late every month. * Every email carries a cancel link that stays valid for the life of the donation. * Payments the bank never reported back are re-checked every 15 minutes, so a donor who closes the tab still gets a receipt. **Payments you can trust in the totals** * A donation counts as paid only when the bank says paid, for the order it was registered under. * A payment the bank reports for a different amount or currency is held for review: left out of every total, no receipt sent, staff alerted. * A full refund or a void made in PSPG > Orders marks the donation refunded, so totals stay right. A partial refund is logged and the donation stays paid. **Emails** * Receipts, recurring activation, failed-payment, cancellation and campaign-ended emails. * Editable subject, heading and body per language, with placeholders, plus your logo, colours and social links. * Written in the language the donor gave in, even when sent later from a scheduled job. * Optional short note to staff addresses for each new donation. **Admin** * Donation log with filters, search, CSV export and a row of headline figures. * Recurring donations list with cancel. * A `pspgd_manage_donations` capability: every administrator has it, and a role editor can give it to staff who should see donations but not change the bank or the settings. * Test mode that never contacts the bank and keeps test donations out of every total. * WordPress privacy export and erase support. ### Shortcode ``` [pspgd_donation_form] ``` Attributes: * `campaign_id` — attach donations to a campaign. Campaign pages add the form themselves, so this is only needed to place a campaign’s form somewhere else. * `privacy_policy_url` — the link beside the consent checkbox. Defaults to the site’s privacy policy page. ### Customising **Appearance.** Colours, font and corner radius are set in Form Settings and apply to the form, campaign pages, the payment result screen and every email. The stylesheet reads them as CSS custom properties, so a theme can override them: ``` body .pspgd-donation-form, body .pspgd-campaign { --pspgd-primary: #0a7d4f; --pspgd-radius: 0; } ``` Available properties: `--pspgd-primary`, `--pspgd-accent`, `--pspgd-ink`, `--pspgd- font`, `--pspgd-radius`. **Languages.** Donor-facing wording (form labels, error messages and email templates) can be edited per language on the settings screens. Donor languages follow Polylang when it is installed, otherwise the site language, or the list you enter in Form Settings. English and Armenian are built in. To add another language, copy `includes/ locales/hy.php` to e.g. `includes/locales/de.php` and translate it, or supply the same array from your own plugin with the `pspgd_locale_pack` filter. Admin screens are translated the usual way with the `joedavtian-donations-for-planetstudio-payment- gateway` text domain. WPML is not supported directly; list your languages under Donor languages instead. **Actions.** * `pspgd_donation_paid` — a donation became paid (one-time, first recurring payment, or a scheduled charge). Receives the donation row; check `is_test`. * `pspgd_newsletter_optin` — a donor ticked the newsletter box. Receives their email, name, language, campaign and donation id, for any newsletter or CRM plugin. Mailchimp for WordPress also picks the box up by itself. * `pspgd_campaign_closed` — a campaign closed and its recurring donations were ended. Receives the campaign id, the reason (`goal_reached` or `ended`) and the cancelled subscriptions, for example to invite those donors to give monthly to the organisation instead. **Filters.** * `pspgd_known_currencies` — currencies that can be ticked in settings (default AMD, USD, EUR, RUB). * `pspgd_currency_symbols`, `pspgd_zero_decimal_currencies`, `pspgd_currency_defaults`— how a currency is shown and its default presets and limits. * `pspgd_supported_locales`, `pspgd_locale_pack` — donor languages and their wording. * `pspgd_campaign_slug` — URL base for campaigns (default `campaigns`). Re-save permalinks after changing it. * `pspgd_supporter_name` — how a supporter is named on a campaign page. * `pspgd_return_url` — where the “Return to site” button on the payment result screen goes. * `pspgd_retry_days`, `pspgd_max_consecutive_failures` — the retry schedule for failed recurring charges. * `pspgd_bank_supports_recurring` — whether recurring donations are offered through a bank. Off for banks outside the ArCa network; switch one on to test it on staging. * `pspgd_rate_limit`, `pspgd_submit_limit`, `pspgd_rate_window` — the throttle: donation attempts (default 5) and submissions of any kind (default 30) per address per window (default 10 minutes). * `pspgd_client_ip` — the visitor address the throttle uses. * `pspgd_load_assets` — whether the form’s script and stylesheet load in the page head. * `pspgd_fetch_exchange_rates`, `pspgd_exchange_rate_sources`, `pspgd_exchange_rate_max_age`— the exchange-rate source. * `pspgd_exchange_rate_max_change` — how far a newly fetched rate may move from the last known one before it is refused and logged (default 0.25, a 25% move; 0 turns the check off). ### External services **Exchange rates.** Off by default. When you tick **Combine currencies with daily exchange rates** in Form Settings and offer more than one currency, the plugin combines a campaign’s donations in different currencies into one progress figure. To do that it downloads public exchange rates once a day from the free [currency-api](https://github.com/fawazahmed0/exchange-api) project, served from `cdn.jsdelivr.net` with `currency-api.pages.dev` as a fallback. The request is a plain download of a published JSON file. No donor, donation or site data is sent. See the [jsDelivr privacy policy](https://www.jsdelivr.com/terms/privacy-policy-jsdelivr-net) and [Cloudflare privacy policy](https://www.cloudflare.com/privacypolicy/). Until you tick it, or on a site with one currency, nothing is downloaded and campaigns list each currency separately. The `pspgd_fetch_exchange_rates` filter can also switch it off. **Cloudflare Turnstile.** Off by default. When you switch it on under Form Settings > Spam protection, the donor’s browser loads Cloudflare’s Turnstile script from ` challenges.cloudflare.com` on pages that show the form, and Cloudflare checks the browser to tell people from scripts. When the donor submits, your site sends Cloudflare the resulting token, your Turnstile secret key and the donor’s IP address to confirm the check. No name, email or donation details are sent. See [Cloudflare’s Turnstile privacy addendum](https://www.cloudflare.com/turnstile-privacy-policy/) and [website terms](https://www.cloudflare.com/website-terms/). **Payments** are sent to the bank you configured in PlanetStudio Payment Gateway, under that bank’s own terms. ### Privacy The plugin stores each donor’s name, email address and language, and each donation’s amount, currency, date, status and bank reference. Card details never reach your site: donors enter them on the bank’s own payment page. To throttle repeated attempts, the form counts submissions per visitor address for ten minutes. The address is stored only as a hash, in a temporary value that expires with the window. With Turnstile on, the address is also sent to Cloudflare as described above. Donor data is included in **Tools > Export Personal Data** and **Tools > Erase Personal Data**. Erasing anonymises the donor and keeps the donation amounts and dates, which are usually financial records you must keep. A donor with an active recurring donation cannot be erased until it is cancelled. Deleting the plugin keeps all donation data unless you tick **Delete all donation data when the plugin is deleted** in Form Settings. ## Screenshots [⌊A campaign page: progress towards the goal across currencies, the campaign's story, the three-step donation form and the supporters list.⌉⌊A campaign page: progress towards the goal across currencies, the campaign's story, the three-step donation form and the supporters list.⌉[ A campaign page: progress towards the goal across currencies, the campaign’s story, the three-step donation form and the supporters list. [⌊The payment result screen a donor sees after paying, in your colours.⌉⌊The payment result screen a donor sees after paying, in your colours.⌉[ The payment result screen a donor sees after paying, in your colours. [⌊A receipt email, in the donor's language, with your logo and colours.⌉⌊A receipt email, in the donor's language, with your logo and colours.⌉[ A receipt email, in the donor’s language, with your logo and colours. [⌊The donation log: the figures at a glance, filters, search and CSV export.⌉⌊The donation log: the figures at a glance, filters, search and CSV export.⌉[ The donation log: the figures at a glance, filters, search and CSV export. [⌊Recurring donations, with each saved card's status and the next payment date.⌉⌊ Recurring donations, with each saved card's status and the next payment date.⌉[ Recurring donations, with each saved card’s status and the next payment date. [⌊A campaign's goal and end date, set beside the editor.⌉⌊A campaign's goal and end date, set beside the editor.⌉[ A campaign’s goal and end date, set beside the editor. [⌊Form settings: bank, currencies, test mode and recurring giving.⌉⌊Form settings: bank, currencies, test mode and recurring giving.⌉[ Form settings: bank, currencies, test mode and recurring giving. ## Installation 1. Install and activate PlanetStudio Payment Gateway and set up your bank’s credentials there. 2. Install and activate this plugin. 3. Go to **Donations > Form Settings**: 4. * choose the **Bank** donations go through, and tick the **Currencies** your bank accepts; * under **Spam protection**, if the site is behind Cloudflare or another proxy, choose where the visitor’s address comes from (the screen shows what each source holds for your own visit), and optionally switch on Turnstile; * set your **colours**, **font** and optional **payment methods image** under Appearance; * switch **test mode** on while you try things out. 5. Go to **Donations > Emails** and set the From address, Reply-to address, your logo, and any staff addresses to notify. 6. Put `[pspgd_donation_form]` on a page, or create a campaign under **Donations > Campaigns**. 7. Make a test donation with test mode on, then a real one with test mode off, before announcing the page. ## FAQ ### Does it work without PlanetStudio Payment Gateway? Only in test mode. Every real payment goes through PSPG. ### Which banks can take recurring donations? Banks on the ArCa network in PSPG. Ameriabank, Inecobank and AMIO take one-time donations; their saved-card payments have not been proven with this plugin, so recurring is off for them unless you switch it on with the `pspgd_bank_supports_recurring` filter to test on staging. Idram and Telcell cannot save cards. ### Can donors choose the currency? Yes, if you tick more than one. Each donation is charged in the donor’s chosen currency, so your bank must accept all of them. ### What happens to monthly donors when a campaign ends? Their recurring donation ends with the campaign: no further payments are taken, the bank is asked to release the saved card, and they are emailed. A gift to a campaign is earmarked, so it is not moved to general funds without asking. Use the `pspgd_campaign_closed` action if you want to invite them to give to the organisation instead. ### How do I refund a donation? In PlanetStudio Payment Gateway > Orders. After a full refund or a void the donation is marked refunded here automatically and leaves the totals. A partial refund is logged against the donation, which stays paid at its original amount. ### Where do the colours come from? Donations > Form Settings > Appearance. The defaults are a neutral blue. ### Do I need a server cron job? It is recommended for recurring donations. WordPress only runs scheduled jobs when someone visits the site, so on a quiet site charges, follow-up runs and the 15-minute payment re-checks can start late. Set `define( 'DISABLE_WP_CRON', true );` in wp- config.php and have the server request `https://your-site/wp-cron.php` every few minutes, or ask your host to do it. ### Does it work on multisite? Yes, activated on one site or for the whole network. Each site has its own donations, settings, bank and scheduled jobs, and its own choice in Form Settings about whether its donation data is deleted with the plugin. PlanetStudio Payment Gateway has to be active on the same sites. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Joedavtian Donations for PlanetStudio Payment Gateway” is open source software. The following people have contributed to this plugin. Contributors * [ joedavtian ](https://profiles.wordpress.org/joedavtian/) [Translate “Joedavtian Donations for PlanetStudio Payment Gateway” into your language.](https://translate.wordpress.org/projects/wp-plugins/joedavtian-donations-for-planetstudio-payment-gateway) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/joedavtian-donations-for-planetstudio-payment-gateway/), check out the [SVN repository](https://plugins.svn.wordpress.org/joedavtian-donations-for-planetstudio-payment-gateway/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/joedavtian-donations-for-planetstudio-payment-gateway/) by [RSS](https://plugins.trac.wordpress.org/log/joedavtian-donations-for-planetstudio-payment-gateway/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.3 * Renamed to Joedavtian Donations for PlanetStudio Payment Gateway, with the slug and text domain `joedavtian-donations-for-planetstudio-payment-gateway`, for the WordPress.org directory. Coming from an earlier zip, which used the folder` donations-for-planetstudio-payment-gateway`: install this one, deactivate and delete the old one (leave **Delete all donation data when the plugin is deleted** unticked), then activate this one. Settings and donations carry over. * Exchange rates are now off until you tick **Combine currencies with daily exchange rates** in Form Settings. Until then nothing is downloaded and campaigns show each currency separately. Sites that offer more than one currency and want one combined progress figure should tick it after updating. * A form label reworded with a percent sign in it (for example “100% of gifts help”) no longer breaks the form or the campaign page. * A font name in quotes in Form Settings now reaches the form’s inputs and buttons. #### 1.0.2 * Prepared for WordPress.org: screenshots in the readme, and every Plugin Check warning reviewed and explained in the code. No change in how the plugin behaves. #### 1.0.1 * Recurring donations are no longer charged at most ten an hour. A run keeps charging for 20 seconds and, if charges are still due, continues a minute later, so a busy sign-up day is not charged days late every month. * A donation whose confirmation was interrupted part-way (a crash or a lost database write) is now found within 15 minutes, checked with the bank again and confirmed and receipted if it was paid. It used to stay unconfirmed for good. * Test mode now takes the same path as a real payment, so a test donation refreshes the figures on the donation log and closes a campaign at its goal straight away, as a real one does. * A payment marked failed (the donor returning through the bank’s fail page, a declined card) can no longer overwrite a confirmation that arrived at the same moment. * A newly fetched exchange rate that moves more than 25% from the last one is refused and logged, so one bad rate cannot close a campaign at its goal early. Adjust or turn off with the `pspgd_exchange_rate_max_change` filter. * The admin screens name any part of PlanetStudio Payment Gateway this plugin calls that the installed version lacks. * Deactivating or deleting the plugin now clears all of its scheduled jobs; two were left behind before. * Multisite: network activation, deactivation and deletion now reach every site, not only the main one. * For developers: the `PSPGD_Admin::CAPABILITY` constant is now `PSPGD_Capability:: MANAGE_DONATIONS`. The capability itself, `pspgd_manage_donations`, is unchanged. #### 1.0.0 * First public version. ## Meta * Version **1.0.3** * Last updated **2 days ago** * Active installations **Fewer than 10** * WordPress version ** 6.5 or higher ** * Tested up to **7.1.4** * PHP version ** 7.4 or higher ** * Tags * [armenian banks](https://wordpress.org/plugins/tags/armenian-banks/)[campaigns](https://wordpress.org/plugins/tags/campaigns/) [donations](https://wordpress.org/plugins/tags/donations/)[fundraising](https://wordpress.org/plugins/tags/fundraising/) [recurring donations](https://wordpress.org/plugins/tags/recurring-donations/) * [Advanced View](https://wordpress.org/plugins/joedavtian-donations-for-planetstudio-payment-gateway/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/joedavtian-donations-for-planetstudio-payment-gateway/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/joedavtian-donations-for-planetstudio-payment-gateway/reviews/) ## Contributors * [ joedavtian ](https://profiles.wordpress.org/joedavtian/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/joedavtian-donations-for-planetstudio-payment-gateway/)