# Paymenter

> Install the Mintage Pay gateway on Paymenter and test it with test money before going live.

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

Adds **Mintage Pay** as a payment gateway for Paymenter invoices. The client pays in USDC or USDT on the Mintage Pay
payment page, the money goes straight to your own wallet, and the invoice is marked **Paid** by itself when the payment
is final.

## What you need

- Paymenter 1.x.
- File access to the Paymenter folder (or its `extensions` volume in Docker), and an admin who can manage extensions.
- Paymenter reachable on public **https**, so Mintage Pay can send it payment updates.
- Invoices in a currency Mintage Pay supports: 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 or XOF. Clients always pay in US
  dollar stablecoins: a price in another currency is converted when the payment is started.
- A Mintage Pay account with at least one payout address set.

## Install

1. Download [mintagepay-paymenter.zip](https://app.mintagepay.com/downloads/mintagepay-paymenter.zip) and unpack it.
2. Copy its `extensions` folder into your Paymenter folder, merging it with the `extensions` folder already there. This
   must exist afterwards: `extensions/Gateways/MintagePay/MintagePay.php`.
3. In Paymenter's admin, open **Extensions > Gateways**, add **MintagePay** and enable it.
4. In the Mintage Pay dashboard, open **Developers > API keys** and create a key. Copy it: it is shown only once.
5. In the same dashboard, open **Developers > Webhooks**, add an endpoint with this address and copy its signing secret:

   ```
   https://<your Paymenter address>/extensions/gateways/mintagepay/webhook
   ```

6. In the gateway's settings in Paymenter, paste the **API key** and the **Webhook signing secret**, and save.

## Try it first with test money

1. Create a free account at [sandbox.mintagepay.com](https://sandbox.mintagepay.com), set a payout address, and create
   a key (it starts with `mp_test_`) and a webhook endpoint there.
2. Put the sandbox key and its webhook secret in the gateway, and save.
3. Create an invoice for a test client, for example 1.00 USD.
4. Open the invoice as the client, click **Pay**, choose **Mintage Pay** and click **Pay Now**. You land on a payment
   page with a **Test mode** banner.
5. Pay with free test money: the payment page has a button to get some.
6. Within a minute or two the invoice is **Paid**, with one transaction carrying the payment's reference.
7. When you are happy, put your live key and the live endpoint's secret in the gateway.

## Good to know

- A second payment attempt reuses the same payment, so a client never pays twice by mistake.
- A repeated payment update is recorded once.
- A staging and a live Paymenter on one Mintage Pay key never record each other's payments.
- Refunds are made from the Mintage Pay dashboard; record them in Paymenter yourself.
- Automatic renewals (billing agreements) are not supported yet: renewal invoices are paid one by one.