What you need
| Field | What it does |
|---|---|
| API key | Lets us call NOWPayments to create the payment. Secret. |
| IPN secret | Confirms a payment notification truly came from NOWPayments. Secret. |
| Success URL / Cancel URL | Where the buyer lands after paying or backing out. |
IPN (Instant Payment Notification) is the NOWPayments name for the webhook they send when a payment status changes.
Why we ask for each field
API key
Authorizes creating the payment, so the funds settle to your account.
IPN secret
Proves an incoming notification is genuinely from NOWPayments, so nobody can forge a "paid" event. It is a separate value from the API key.
Success and Cancel URL
Plain settings: where the buyer lands after paying or backing out. Not secret.
Set up
- Testing: there is no sandbox
NOWPayments has no sandbox or test environment. To verify end to end, send a small real payment in a low-fee coin and confirm it appears in your dashboard. Treat that first small payment as your test. A NOWPayments account is free; you pay only the normal network and service fees on real payments.
- Copy your API key
Sign in at account.nowpayments.io, go to Settings → API key, generate a key, and copy it.
NOWPayments → Settings → API key - Set up the IPN callback and secret
- Go to Settings → IPN (Instant Payment Notifications).
- Set the callback URL to your project webhook address (below).
- Generate and copy the IPN Secret Key.
https://<your Coin Moebius host>/webhook/nowpayments/<your project id>
NOWPayments → Settings → IPN - Connect in the dashboard
Add provider → NOWPayments. Enter the API key, IPN secret, Success URL, and Cancel URL.
After you connect
There is no sandbox, so your first small real payment is the test:
- Create a product and place the buy button on a page (a local HTML file works) pointed at your project.
- Pay a small amount in a low-fee coin.
- Open the Transactions tab. When the new row status reaches succeeded, your API key and IPN secret are both working end to end.
Troubleshooting
Payment completes but the order stays pending.
The IPN is not arriving or not verifying. Confirm the callback URL matches and that the IPN secret in the dashboard matches the IPN Secret Key in your NOWPayments settings.
No way to test without paying.
Correct, there is no sandbox. Send a small real payment in a low-fee coin to fire a genuine IPN, then watch the order update.
Status only changes on real activity.
NOWPayments status reflects IPN deliveries, so a quiet account shows no status until a real payment moves.
Good to know
No test mode. Verify with a small real payment, not a sandbox.
Rotating secrets. Generate a new API key or IPN secret anytime, then paste the new value.
Questions? [email protected]