How to Set Up NOWPayments for XFile Ultra
NOWPayments creates hosted crypto invoices (many coins). The site marks a payment paid from the IPN (Instant Payment Notification) when status is finished or confirmed. The browser return URL alone is not enough if IPN never arrives.
NOWPayments is built-in — no premium plugin required.
Where to find it
Admin → Settings → Payment → NOWPayments
1. Turn Enable NOWPayments checkout on
2. Paste API key and IPN secret
3. Paste the IPN callback URL into NOWPayments Instant payment notifications
4. Optional: Pay currencies allowlist; Fixed exchange rate (default on)
5. Use Sandbox / test mode while learning
6. Save settings and test
Enable for reseller (optional): shows this gateway on reseller balance top-up checkout. Member Premium upgrade and member balance top-up use the main Enable toggle only. Reseller enable needs the Reseller System premium plugin.
Fields in XFile Ultra
| Field | Setting key | From NOWPayments |
|---|---|---|
| Enable | nowpayments_checkout_enabled |
Main on/off |
| Enable for reseller | nowpayments_checkout_reseller_enabled |
Reseller top-up |
| API key | nowpayments_api_key |
Store API keys |
| IPN secret | nowpayments_ipn_secret |
IPN settings |
| Pay currencies | nowpayments_pay_currencies |
Optional CSV tickers |
| Fixed exchange rate | nowpayments_fixed_rate |
Locks rate for the invoice |
| Sandbox / test mode | nowpayments_test_mode |
api-sandbox.nowpayments.io |
IPN URL:
https://YOUR-DOMAIN/api/webhooks/nowpaymentsSuccess return (automatic on each invoice — you do not enter it in NOWPayments settings):
https://YOUR-DOMAIN/api/checkout/nowpayments/returnEnv overrides: NOWPAYMENTS_API_KEY, NOWPAYMENTS_IPN_SECRET.
Step 1 — API key and IPN secret
Required IPN statuses XFile Ultra fulfills on: finished or confirmed
The IPN callback must be registered and reachable. Browser success return alone does not mark paid while the invoice is still pending.
1. Open your NOWPayments account
2. Go to Store Settings → Payments → API keys (wording may vary) and create/copy an API key
3. Open Instant payment notifications (IPN)
4. Copy the IPN secret
5. Set / paste the IPN callback URL to the admin webhook URL above (this is the required “webhook” permission / destination for payment notifications)
Official API docs: NOWPayments Postman / API
Step 2 — Optional coin allowlist
- Leave Pay currencies empty → offer coins enabled in your NOWPayments account
- Or enter a comma-separated list of tickers (example:
btc,eth,usdt) to restrict the chooser
Step 3 — Paste into XFile Ultra
1. Admin → Settings → Payment → NOWPayments
2. Paste API key + IPN secret
3. Turn Sandbox / test mode on with sandbox credentials
4. Keep Fixed exchange rate on unless you know you want floating rates
5. Enable checkout → Save
6. Pay a test invoice on /premium
What is Sandbox / Test mode?
Sandbox (sometimes labeled Test mode) means you use the provider’s test environment — fake cards, fake buyers, no real money. Turn it on while learning. When you go live:
1. Turn Sandbox / Test mode off
2. Paste live keys (not test keys)
3. Register live webhooks (Stripe/PayPal have separate Test vs Live webhook endpoints)
Common problems
Payment stuck pending
IPN never reached your server (HTTPS, firewall, wrong IPN URL/secret). Check NOWPayments IPN logs. Return URL success while pending does not grant Premium.
Coin missing from checkout
Ticker not in Pay currencies, or not enabled in the NOWPayments account.
Sandbox vs live mixup
Test-mode toggle must match sandbox vs production API key.