# WooCommerce

> Add Mintage Pay to a WooCommerce store: install the plugin from WordPress.org, connect your account, test with test money, and handle orders and refunds.

Source: https://mintagepay.com/docs/integrations/woocommerce/ (last updated 2026-11-10)

Mintage Pay has a WooCommerce plugin on WordPress.org: [Mintage Pay for WooCommerce](https://wordpress.org/plugins/mintage-pay/). Install it like any other plugin, connect your Mintage Pay account, and orders mark themselves paid. This page covers what you need, setup, testing with test money, what happens to orders and how refunds work.

## What you need

- WordPress 6.4 or later, WooCommerce 8.0 or later and PHP 7.4 or later.
- Your store online at an **https** address. Mintage Pay contacts your store to tell it about each payment.
- A supported store currency: US dollars or one of many other currencies ([full list](#supported-store-currencies)).
- A Mintage Pay account with at least one payout address.

## What your customers see

You can offer up to three ways to pay, and drag them into the order you want:

- **Pay with crypto:** USDC or USDT from any wallet or exchange.
- **Pay by card:** a card, for stores where Mintage Pay offers card payments. You receive USDC.
- **Pay by app:** Cash App, where available.

Customers pay in a secure window that opens over your checkout, so they never leave your store.

## Install and connect

1. In WordPress, go to **Plugins > Add New Plugin**. Search for **Mintage Pay**, click **Install Now**, then
   **Activate**.
2. Go to **WooCommerce > Settings > Payments > Mintage Pay** and click **Connect to Mintage Pay**.
3. Sign in to Mintage Pay. Check that the store address shown is yours, then click **Approve**.
4. You are taken back to WordPress. The page says **Connected to (your business name)**, and Mintage Pay is now on at
   your checkout.
5. Tick **Update Mintage Pay automatically** and click **Save changes**. Fixes and new payment options then install
   on their own.

To show card and crypto as separate options, switch on **Mintage Pay: Pay by card** and **Mintage Pay: Pay with
crypto** under **WooCommerce > Settings > Payments**.

Good to know:

- Only approve a connection you just started in your own WordPress.
- Connecting needs the Owner, Admin or Developer role on your Mintage Pay account. The account owner gets an email
  each time a store is connected.
- Prefer to paste a key? In the Mintage Pay dashboard, go to **Developers > API keys** and create one. It is shown
  only once. Paste it in the plugin settings, tick **Enable Mintage Pay** and click **Save changes**.
- Leave **API base URL** empty. The plugin works out where to connect from your key.
- You can also download [mintage-pay.zip](https://app.mintagepay.com/downloads/mintage-pay.zip) and upload it under
  **Plugins > Add New > Upload Plugin**.

## Try it first with test money

1. Create a free account at [sandbox.mintagepay.com](https://sandbox.mintagepay.com) and add a payout address.
2. In the plugin settings, click **Connect a test (sandbox) account** and approve. The page shows **TEST MODE:
   sandbox, test money only**.
3. Open your store in a private browser window, place an order and pay it. The payment page has a button that gives
   you free test money.
4. When you are ready, click **Connect to Mintage Pay** to connect your live account. The plugin asks before it
   replaces the test connection. Click **Replace the key**.

## What happens to orders

| What happened | Order status |
|---|---|
| Customer started paying | Pending payment |
| Paid in full | Processing |
| Paid, but the amount does not match the order | On hold, with a note. Check before you ship |
| Paid only part | On hold, with a note saying how much is still owed |
| Not paid in time | Cancelled, and the stock goes back |
| Paid part, then the time ran out | On hold. Refund the customer or ask for the rest |
| Paid after the order was cancelled | On hold. Check before you ship |

Each order has a **Mintage Pay** box showing the payment status, the payments received and a **Refresh** link.

## Refunds

Crypto payments are in your own wallet, so you send those refunds from there. The plugin does the rest.

1. Open the order, click **Refund** and enter the amount. Then click the **Refund via** button for Mintage Pay. It
   shows the amount and your method's name, for example **Refund $50.00 via Mintage Pay**.
2. A **Send now** link appears in the order notes. Reload the page if you do not see it yet.
3. Click it, sign in to Mintage Pay and send the refund from your wallet.
4. Once the refund goes through, the plugin records it on the order, puts the items back in stock if you ticked
   **Restock**, and WooCommerce emails your customer.

If Mintage Pay needs the customer's refund address first, the order note says so and links to the payment, where you
can ask them for it.

## If something is not working

- **Mintage Pay does not show at checkout:** look for a notice at the top of your WordPress admin. It says what to
  fix, for example an unsupported store currency.
- **"Not connected" next to Webhook:** click **Reconnect webhook**. Do this too after moving your store to a new
  address. If it still fails, check that your site works over https and that no security plugin or firewall blocks
  `/?wc-api=mintage_pay`.
- **An order did not update:** open it and click **Refresh** in the Mintage Pay box.
- **You need more detail:** tick **Debug log** in the plugin settings, then look in **WooCommerce > Status > Logs**.
  Your key is never written to the log.
- **Still stuck?** Write to [hello@mintagepay.com](mailto:hello@mintagepay.com).

## Supported store currencies

USD, EUR, GBP, CAD, AUD, CHF, JPY, MXN, BRL, INR, SGD, AED, PLN, SEK, NOK, DKK, NZD, ZAR, TRY, KRW, HKD, NGN, ARS, PHP,
IDR, VND, PKR, EGP, BDT, KES, GHS, TZS, COP, CLP, PEN, UYU, PYG, BOB, DOP, GTQ, CRC, THB, MYR, TWD, LKR, NPR, KZT, UAH,
ILS, SAR, QAR, CZK, HUF, RON, ISK, XAF and XOF.

Crypto payments are in US dollar stablecoins. If your prices are in another currency, the amount is converted at checkout,
and the payment page shows both amounts.
