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

# Setup NOWPayments

> Connect your own NOWPayments account to accept crypto on Komerza

Accept crypto through your own **NOWPayments** account. You bring the account and funds settle to your NOWPayments balance — NOWPayments charges a **0.5–1%** service fee, and Komerza adds nothing on top.

Komerza connects using your **API key** and **IPN secret**, and registers the payment webhook automatically — there's no callback URL for you to configure.

## Prerequisites

* A [NOWPayments account](https://nowpayments.io/) (free to create).
* A **payout wallet address** — NOWPayments won't issue an API key until one is saved on your account.

<Steps>
  <Step title="Add a payout wallet and create an API key">
    NOWPayments requires a payout wallet before it will generate API keys.

    1. Log into your [NOWPayments dashboard](https://account.nowpayments.io/).
    2. Go to **Store Settings → Payments**.
    3. Enter your **payout (outcome) wallet address** and click **Save**.
    4. Scroll up to the **API keys** section and click **Add new key**.
    5. Copy the new **API key**.
  </Step>

  <Step title="Generate your IPN secret">
    1. Still under **Store Settings → Payments**, scroll to **Instant Payment Notifications (IPN)**.
    2. Generate the **IPN Secret key** and copy it.

    <Warning>
      NOWPayments shows the IPN secret **only once**. Copy it before leaving the page — if you lose it, generate a new one and update it in Komerza.
    </Warning>
  </Step>

  <Step title="Connect NOWPayments in Komerza">
    1. In your dashboard, open **Settings** under **Online Store**, then go to **Cryptocurrency**.
    2. Under **Processors**, find **NOWPayments** and click **Connect**.
    3. Paste your **API key** and **IPN secret**, then save.

    Komerza automatically registers the payment webhook with NOWPayments — you don't need to add a callback URL anywhere.

    <img className="block dark:hidden rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintlify.s3.us-west-1.amazonaws.com/komerza/images/nowpayments/1-light.png" alt="Connect NOWPayments in Komerza" />

    <img className="hidden dark:block rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintlify.s3.us-west-1.amazonaws.com/komerza/images/nowpayments/1-dark.png" alt="Connect NOWPayments in Komerza" />
  </Step>

  <Step title="Route your coins to NOWPayments">
    On the Cryptocurrency page, open **Coin routing** and set each coin you want NOWPayments to handle to **NOWPayments** — or confirm default routing already points there.
  </Step>

  <Step title="Test the connection">
    Make a small test payment on your store to confirm NOWPayments processes it and the order is marked as paid before you go live.
  </Step>
</Steps>

## How it works

1. A customer picks a NOWPayments-backed coin at checkout.
2. NOWPayments handles the payment and funds settle to your **NOWPayments balance**.
3. NOWPayments sends an IPN callback; Komerza validates it with your **IPN secret** and marks the order paid, triggering delivery.

## Troubleshooting

| Problem                        | Fix                                                                                                                                   |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| Can't create an API key        | Add a **payout wallet** in **Store Settings → Payments** and click **Save** first — NOWPayments blocks key creation until one exists. |
| Payments not marked as paid    | Re-check the **IPN secret** in Komerza. If it was regenerated in NOWPayments, paste the new value.                                    |
| A coin isn't using NOWPayments | Check **Coin routing** — the coin may be routed to another processor or to self-custody.                                              |
| Lost your IPN secret           | Generate a new one in **Store Settings → Payments → Instant Payment Notifications** and update it in Komerza.                         |