Skip to content
Plugins
Open .md
On this page

Stablecoin donations in GiveWP

Connect Paymos to GiveWP, test a donation in Sandbox, and check the donation status before switching to Live.

Paymos Stablecoin Donations adds one-time stablecoin donations to GiveWP’s native Visual and legacy forms. After a donor pays, open their donation in GiveWP to see whether GiveWP has marked it complete.

Requirements

You need WordPress 6.9 or later, GiveWP 4.19.1.1 or later, and PHP 7.4 or later. Check that OpenSSL is available and that your WordPress site uses HTTPS. Once the plugin is public, get paymos-givewp.zip from the Paymos dashboard or the GitHub release.

Install and connect

With GiveWP enabled, open Plugins → Add New Plugin → Upload Plugin in WordPress. Upload the ZIP and activate the plugin.

Go to GiveWP → Settings → Payment Gateways → Paymos. Choose Sandbox and turn on GiveWP test mode so they match. Open the intended project in the Paymos dashboard. Return to the GiveWP gateway settings and click Connect Paymos. When the code and Open Paymos appear, click Open Paymos. In Paymos, check the site URL and displayed project, compare the code with the one in WordPress, and approve. Return to GiveWP, wait for Connected in Sandbox, then enable Paymos in the form you want to test.

Sandbox donation

Open the form as a donor and make a simulated donation. The form takes you through a status page on your site to the Paymos-hosted checkout. Follow the sandbox guide, then open the donation in GiveWP and check that it shows as complete. After a successful test, select Live in the same panel and repeat the connection and approval. Wait for Connected in Live in GiveWP, then turn off GiveWP test mode.

Payment and receipt

When the plugin creates the invoice, it sends the amount, currency, project, and an opaque reference. The plugin checks the webhook’s HMAC signature and verifies the project, invoice, amount, and currency through the API. WordPress runs scheduled checks to pick up pending work.

Once the plugin verifies that the full amount or more has arrived, it marks the donation complete in GiveWP and offers the donor the usual GiveWP receipt. It completes each donation only once. If funds arrive late or cover only part of the amount, review the donation before treating it as complete.

Refunds

If you have refund permissions, open GiveWP → Paymos refunds to see whether you can return the full donation or the excess. Paymos sends the refund to the sender address recorded on the original payment. When a full refund completes, GiveWP marks the donation as refunded. Refunding the excess keeps it complete. See the refund guide.

Deactivation and uninstall

Deactivating the plugin stops scheduled checks. Uninstalling it removes the local credentials and closes browser access to the status page. GiveWP keeps its donation history, and WordPress keeps the minimum references needed to follow up on unresolved donations. If you need help tracing one, email Paymos support.