Set up LiteShop Crypto Payments

What you get

LiteShop Crypto Payments adds cryptocurrency checkout to LiteShoper via hosted providers. Out of the box it supports NOWPayments and CoinGate. Shoppers are redirected to a secure payment page, then return to your store; webhooks confirm paid orders.

Before you start

• LiteShoper Commerce must be active
• Admin access to Commerce → Settings → Crypto
• A NOWPayments and/or CoinGate merchant account
• Your store timezone set under Admin → Settings (webhook log times use this)

1. Enable crypto at checkout

1. Open Commerce → Settings → Crypto.
2. Check Enable cryptocurrency payments.
3. Checkout display:
   • List each enabled provider separately — shows NOWPayments and CoinGate as two radios (recommended if both are on).
   • Single “Pay with cryptocurrency” — one radio; uses the Default provider only.
4. Save settings.

2. NOWPayments

1. Open the NOWPayments tab → Enable.
2. Paste your API key from account.nowpayments.io → Settings → API keys.
3. Leave Sandbox unchecked for a normal production key. Production keys do not work on the sandbox API host. Only check Sandbox if the key was created on account-sandbox.nowpayments.io.
4. Paste the IPN secret from Instant payment notifications (required for paid webhooks).
5. Copy the webhook URL shown on the tab into NOWPayments IPN settings if asked.
6. Save → click Test connection until it says the API key was accepted → place a test order.

Tip: “Test connection” must use a real authenticated check. Always Save the key before testing or checking out.

3. CoinGate

1. Open the CoinGate tab → Enable.
2. Paste the Auth token from CoinGate (sandbox.coingate.com for sandbox, coingate.com for live). Match the Sandbox checkbox to that site.
3. In CoinGate callback / IPN settings, set Callback format to Form encoding (application/x-www-form-urlencoded) — not JSON.
4. Paste the webhook URL from the LiteShop tab into CoinGate.
5. Callback token: CoinGate does not show this in their dashboard. Leave blank to auto-generate, or invent any secret. LiteShop sends it with each invoice and verifies it on webhooks.
6. Set Receive currency (e.g. EUR, BTC, USDT) → Save → Test connection → test checkout.

4. Webhook log

Under Crypto settings, Recent webhook log shows provider events (errors, paid, etc.).

• Times use your store timezone (Admin → Settings)
• Paging (50 per page) and Clear log are available when entries exist

Troubleshooting

• NOWPayments: Invalid api key — re-paste the key, Save, uncheck Sandbox for a production key, then Test connection again.
• CoinGate: Auth Token is not valid — sandbox token vs live token mismatch.
• Only one crypto radio at checkout — Checkout display is set to Single; switch to List.
• Provider enabled but missing — API credentials not saved (tab shows missing credentials).
• Paid at provider, unpaid in store — fix IPN/callback token and Form encoding (CoinGate); check the webhook log.