NOWPayments

What you need

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

1. 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.

2. Open Payments Settings in NOWPayments

   Sign in at account.nowpayments.io and go to Settings → Payments. This one screen holds the three things you need: Payout wallets (where funds land), API keys, and Instant payment notifications. You will visit each in turn.

   ⤢
3. Add a payout wallet

   NOWPayments unlocks the API only once you have a payout wallet on file. On Payout wallets, click Add new wallet, choose a currency, paste a wallet address you control, and click Add wallet. This is the address your crypto settles to.

   ⤢
4. Create an API key

   Open API keys and click Add new API key. Your keys are listed here, each with a copy icon, so you can come back and re-copy a key anytime.

   ⤢
5. Copy your API key

   NOWPayments shows the new key in an "API key created" dialog. Click the copy icon next to Your API key and set it aside. (The public key below it is not needed by Coin Moebius.) You can add an optional label, then click Save.

   ⤢

   This is your secret API key. Treat it like a password.

6. Set up the IPN callback and copy the IPN secret

   Open Instant payment notifications. IPN (Instant Payment Notification) is the NOWPayments name for the webhook they send when a payment status changes.

   1. In the Webhook URL field, paste your project’s NOWPayments webhook address (below), then click Save.
   2. Copy the IPN secret key shown at the top (use Regenerate if there is no value yet).
   3. Under Choose webhook format, select Classic way so amounts and IDs stay in their normal numeric format.

   https://api.coinmoebius.com/webhook/nowpayments/<your project id>

   ⤢

   Your project ID sits under the project name in the Coin Moebius dashboard; drop it into the address above. The connected provider card (last step) shows the same URL, so you can re-copy it anytime.

7. Back in Coin Moebius: Add provider → NOWPayments

   In your project, open the Providers tab, click Add provider, choose Connect a service, and pick NOWPayments. Paste your API key and IPN secret, set the Success URL and Cancel URL (where buyers land after paying or backing out), then click Save.

   ⤢
8. You are connected

   NOWPayments now appears on your Providers tab with the date it connected. The card shows the same webhook URL you pasted into NOWPayments, plus Edit and Disconnect. Because NOWPayments has no sandbox, we cannot auto-verify the IPN secret, so the card offers a micro-payment test: send a tiny real payment to confirm everything works end to end.

   ⤢

After you connect

There is no sandbox, so your first small real payment is the test:

1. Create a product and place the buy button on a page (a local HTML file works) pointed at your project.
2. Pay a small amount in a low-fee coin.
3. 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? Join our Discord