# 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](/docs/testing.md), 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](/docs/support/refunds.md).

## 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](mailto:support@paymos.io).
