NOWPayments Crypto Gateway for Paymenter

NOWPayments Gateway Extension for Paymenter

Accept 300+ cryptocurrencies (Bitcoin, Ethereum, USDT, Litecoin, and more) on your Paymenter billing panel using the NOWPayments non-custodial payment gateway.

THE ADDON IS IN BETA AND HAVE ERROR I WILL FIX THEM ASAP !

Features

Supports 300+ cryptocurrencies
Non-custodial — funds go directly to your wallet
Automatic IPN webhook with HMAC-SHA512 signature verification
Sandbox / test mode support
Optional default pay currency (or let the customer choose)
Redirect to hosted NOWPayments payment page

Requirements

Paymenter (latest version)
PHP 8.1+
A NOWPayments account with a configured payout wallet

Installation

1. Copy the extension

Place the NOWPayments folder inside your Paymenter extensions directory:

Code:

extensions/
└── Gateways/
    └── NOWPayments/       ← paste here
        ├── NOWPayments.php
        ├── routes.php
        └── resources/
            └── views/
                └── error.blade.php

2. Enable the extension

Go to your Paymenter Admin Panel → Extensions → Gateways and enable NOWPayments.

Alternatively, use the artisan command:

Bash:

php artisan app:extension:create

3. Configure the gateway

In the admin panel under Extensions → NOWPayments → Settings, fill in:

Field	Description
API Key	Found in your NOWPayments Dashboard → Store Settings
IPN Secret Key	Found in NOWPayments Dashboard → Store Settings → Instant Payment Notifications
Sandbox Mode	Enable for testing (use sandbox.nowpayments.io credentials)
Default Pay Currency	Optional. e.g. btc, eth, usdttrc20. Leave empty to let the customer choose.

4. Set up your IPN Webhook URL

In your NOWPayments Dashboard, set the IPN callback URL to:

Code:

https://yourdomain.com/extensions/nowpayments/webhook

Make sure this URL is publicly accessible. It cannot be localhost.

Payment Flow

1. Customer clicks Pay on an invoice in Paymenter.
2. Paymenter calls NOWPayments::pay() which creates a NOWPayments invoice via API.
3. Customer is redirected to the hosted NOWPayments payment page.
4. Customer selects their preferred crypto (if not pre-set) and pays.
5. NOWPayments sends an IPN webhook to Paymenter when the payment status changes.
6. On finished / confirmed status, Paymenter marks the invoice as paid.
7. Customer is redirected back to the invoice page with a success message.

Supported Payment Statuses

NOWPayments Status

Paymenter Action

finished

Invoice marked as paid

confirmed

Invoice marked as paid

sending

Invoice marked as paid

partially_paid

Logged only (partial payment)

failed

Logged only

refunded

Logged only

expired

Logged only

Sandbox Testing

1. Create an account at sandbox.nowpayments.io
2. Generate a sandbox API key and IPN secret
3. Enable Sandbox Mode in the extension settings
4. Use NOWPayments sandbox docs for test transactions

Security

All IPN webhook requests are verified using HMAC-SHA512 signatures.
API keys are stored encrypted in Paymenter's database (using type: 'password').
Webhook endpoint is excluded from CSRF protection (required for external POST requests).

Support

NOWPayments API Docs: https://documenter.getpostman.com/view/7907941/S1a32n38
NOWPayments Support: https://nowpayments.io/help
Paymenter Docs: https://paymenter.org/development/extensions/gateway

NOWPayments Crypto Gateway for Paymenter v1.0

Overview Dependencies History

Requirements

NOWPayments Crypto Gateway for Paymenter v1.0

Overview Dependencies History

Requirements​

Requirements