NowPayments – Paymenter Gateway (Crypto Payments)

[JUSTIFY]
Accept 200+ cryptocurrencies (BTC, ETH, USDT & more) directly in Paymenter.
This production‑ready gateway integrates NowPayments with Paymenter, letting you collect secure crypto payments with real‑time status updates via IPN webhooks. Ideal for hosting providers, SaaS, and digital merchants who want fast global settlements and lower fees without building a custom crypto stack.
[/JUSTIFY]

What this extension does

Adds a "NowPayments" gateway in Paymenter (v1.0+)
Creates crypto invoices with a hosted checkout (QR code, on‑chain address)
Auto‑reconciles payments via IPN (paid, confirming, failed, etc.)
Verifies webhook signatures using HMAC‑SHA512
Supports 200+ coins with rate conversion from a base fiat (USD/EUR/GBP…)
Sandbox mode to test end‑to‑end without real funds
Clean logs and minimal configuration; no card data or private keys stored

Who is it for?

Hosting/VPS providers and resellers using Paymenter
SaaS and digital downloads needing global, borderless checkout
Projects wanting to add crypto alongside existing gateways

How it works (flow)

Customer selects NowPayments (Crypto) at checkout.
Extension creates a NowPayments invoice and redirects to the hosted page.
Customer pays in their chosen coin (QR/address shown).
NowPayments sends IPN webhooks → extension verifies HMAC signature.
Statuses are mapped in Paymenter (e.g., confirmed/finished → invoice marked paid).

Key Features

Secure payment processing via NowPayments hosted checkout
Automatic status sync (waiting/confirming/finished/failed…)
200+ cryptocurrencies supported with automatic conversion
HMAC‑SHA512 webhook signature verification
Sandbox/Test mode for safe end‑to‑end testing
Works with Paymenter v1.0+

Requirements

Paymenter v1.0 or newer
A NowPayments merchant account (sign up at <a href="https://nowpayments.io" target="_blank" class="text-[var(--vp-c-brand-1)] hover:underline">nowpayments.io</a>)
Server can receive HTTPS webhooks (publicly reachable callback URL)

Installation

1) Install the Extension

Go to Admin → Browse Extensions in Paymenter and install NowPayments.

2) Configure the Gateway

Navigate to Admin → Settings → Extension Settings and fill in:

<ol class="list-decimal pl-5 my-4 space-y-1">
<li>API Key (from NowPayments dashboard)
<li>IPN Secret Key (from NowPayments → Settings → IPN)
<li>Base Currency (e.g., USD / EUR / GBP)
<li>Sandbox Mode (optional)
</ol>

3) Set up IPN Webhook

<ol class="list-decimal pl-5 my-4 space-y-1">
<li>In NowPayments: Settings → IPN → enable notifications
<li>Set IPN Callback URL to:
<pre class="bg-gray-100 dark:bg-gray-800 p-3 rounded-md overflow-x-auto text-sm my-2"><code>https://yourdomain.com/extensions/gateways/nowpayments/webhook</code></pre>
<li>Generate and save your IPN Secret Key
<li>Paste the same key into your Paymenter configuration
</ol>

Configuration Reference

api_key — NowPayments API key (Required)
ipn_secret — Secret used to verify webhook signatures (Required)
currency — Base fiat currency for pricing (USD/EUR/GBP/…) (Required)
sandbox_mode — Use NowPayments sandbox environment (Optional)

Webhook Handling & Security

All incoming IPNs are validated using HMAC‑SHA512 to prevent spoofing:

hash_hmac('sha512', $request_body, $ipn_secret)

Status mapping used by the gateway:

finished, confirmed → invoice marked paid
waiting, confirming, sending → payment processing
partially_paid → partial payment logged
expired, failed, refunded → payment failed/cancelled

Testing (Sandbox)

Enable Sandbox Mode in the gateway settings
Use the NowPayments sandbox portal to generate test payments
Verify that Paymenter updates the invoice automatically on IPN

Troubleshooting

Webhook signature mismatch?

<ul class="list-disc pl-5 my-4 space-y-1">
<li>Confirm the same IPN Secret Key is set in both NowPayments and Paymenter
<li>Ensure IPN is enabled in your NowPayments account
</ul>

Payment not marked completed?

<ul class="list-disc pl-5 my-4 space-y-1">
<li>Check Paymenter logs at:
<pre class="bg-gray-100 dark:bg-gray-800 p-3 rounded-md overflow-x-auto text-sm my-2"><code>storage/logs/laravel.log</code></pre>
<li>Review webhook attempts in NowPayments → Payment History
</ul>

Minimum amount errors?

Each coin has a minimum amount on NowPayments. The gateway checks limits before creating payments and logs issues when below minimum.

FAQ

Which coins are supported? Over 200 cryptocurrencies including BTC, ETH, USDT, USDC, LTC, etc. (availability may vary by region).
Do I need to manage wallets? No—NowPayments handles addresses and confirmations; you just receive payouts per your NowPayments settings.
Can customers pay network fees? The gateway can pass fees to users or absorb them (configurable at code level).
Will this conflict with other gateways? No—You can keep multiple gateways active in Paymenter.

Support & Issues

If you need help, open a GitHub Issue with logs and steps to reproduce. Include your Paymenter version and whether sandbox mode is enabled.

License

This extension is open‑source under the MIT License.

[CENTER]Sponsored: vps.direct — Privacy‑focused hosting. Relentless performance.[/CENTER]

NOWPayments Crypto Gateway for Paymenter

Developer

Last Updated

Price

Installs

Categories

About this extension