> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dezerx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# NOWPayments

> Accept crypto payments with NOWPayments

![NOWPayments settings in Spartan](https://mintcdn.com/dezerx/dVNBM3sq4VCh7CKa/public/gateways/nowpayments/settings.webp?fit=max\&auto=format\&n=dVNBM3sq4VCh7CKa\&q=85\&s=579d8035e00aa72dfcc8ab90421df434)

Customers pay in the crypto they choose on the NOWPayments hosted page. The invoice stays in the currency the customer was quoted.

## On the provider side

**1. Copy the API key**

In the NOWPayments dashboard open Store Settings, API keys and create a key.

**2. Add the IPN callback**

Open Store Settings, Instant Payment Notifications, paste the URL from the Webhook section and generate the IPN secret key.

**3. Sandbox**

For tests use the NOWPayments sandbox account, which has its own API key and IPN secret.

## In Spartan

Go to Integrations, Modules, then open NOWPayments and enable the module.

| Field | Value |
| - | - |
| Mode | Sandbox or Live. The key fields switch with it |
| Live API Key, Live IPN Secret | From the live account |
| Sandbox API Key, Sandbox IPN Secret | From the sandbox account |
| Store Currency | Optional. Prices every NOWPayments invoice in this currency, for example USD. Converting needs a matching rate under Currencies |

Leave a secret field empty to keep the stored value.

## Webhook

```text theme={null}
https://yourdomain.com/api/nowpayments/webhook/callback
```

An invoice is marked paid when NOWPayments reports the payment as finished.

## Troubleshooting

* Saving fails: both the API key and the IPN secret are required for the selected mode.
* Paid in crypto but invoice open: check the IPN URL and that the IPN secret matches.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.