> ## 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 Heleket

> Connect your own Heleket account to accept crypto on Komerza

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

Komerza registers the payment webhook automatically, so there's no callback URL for you to configure.

## Prerequisites

* A [Heleket account](https://heleket.com/).
* A website URL for your store — Heleket verifies your domain and moderates the merchant before activating API access.

<Steps>
  <Step title="Create a merchant and get it approved">
    Heleket issues payment credentials per **merchant**, and a merchant must be approved before its keys work.

    1. Log into Heleket and go to **Business → Merchants**.
    2. Click **Create merchant** and give it a name.
    3. Open the merchant's **Settings**, click **Leave a request**, enter your **website URL**, and complete **domain verification**.
    4. Wait for **moderation** — the payment key and Merchant ID become usable once the merchant is approved.
  </Step>

  <Step title="Copy your payment API key and Merchant ID">
    Once the merchant is approved, in its **Settings** tab:

    1. Copy the **API key for payments** (regenerate it if needed).
    2. Copy the **Merchant ID** (a UUID) shown in the same tab.

    <Note>
      Don't confuse this with the **payout API key** under your personal-account **Settings → API** (protected by 2FA) — that key is for withdrawals, not for accepting payments.
    </Note>
  </Step>

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

    Komerza automatically registers the payment webhook with Heleket — 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/heleket/1-light.png" alt="Connect Heleket 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/heleket/1-dark.png" alt="Connect Heleket in Komerza" />
  </Step>

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

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

## How it works

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

## Troubleshooting

| Problem                    | Fix                                                                                                         |
| -------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Credentials rejected       | Confirm your merchant has passed **moderation** — the payment key doesn't work until it's approved.         |
| Using the wrong key        | Use the **API key for payments** from the merchant's Settings, not the personal-account **payout API key**. |
| A coin isn't using Heleket | Check **Coin routing** — the coin may be routed to another processor or to self-custody.                    |