Medusa logo

Accept crypto payments on Medusa

Medusa v2 payment provider; payments are captured by the verified webhook.

Requires: Medusa 2.5+, region currency USD, EUR or GBP

Download Medusa· 50 KBstablora-medusa-1.0.0.zip · sha256 28509036f3bb8c6d…
Create a free account
0.5% per payment

No monthly, setup or minimum fee.

16 coins, 13 networks

USDT, USDC, BTC, ETH, SOL, TRX and more.

Locked price

The coin amount is fixed when the buyer picks a coin; every order gets its own address.

Verified before paid

Signed webhook plus a server-side status check.

How to set up Medusa

  1. 1Download the ZIP, run npm install && npm run build && npm pack, and install the package in your Medusa app.
  2. 2Add the provider to the Payment Module in medusa-config.ts with your API key and webhook secret (see the README).
  3. 3In Stablora add the webhook endpoint https://your-medusa.com/hooks/payment/stablora_stablora, then enable the provider in your regions.
  4. 4In the storefront, redirect the customer to payment_session.data.checkout_url.
Webhook URL for Stablora
https://your-medusa.com/hooks/payment/stablora_stablora

Try it first with a test key and free testnet coins — see the testing guide. The full guide is the README.md inside the download.

Coins your customers can pay with

USDTUSDCBTCETHSOLTRXBNBPOLAVAXLTCDOGEXMRSHIBPEPEBONKWIF

Balances stay separate per network and asset. Optional automatic conversion to USDT or USDC on EVM networks (+0.25%). Pricing and network fees.

Questions about Medusa and Stablora

Is the Medusa plugin free?

Yes. The Medusa plugin is free to download. Stablora charges 0.5% per incoming payment and nothing else — no monthly or setup fee.

Which coins can customers pay with?

USDT on TRON, Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche and Solana; USDC on the same EVM networks, Base and Solana; plus BTC, ETH, SOL, TRX, BNB, POL, AVAX, LTC, DOGE, XMR and the meme coins SHIB, PEPE, BONK and WIF. They choose the coin and network on the Stablora payment page; the amount is locked when they choose it.

When is an order marked paid?

Only after Stablora confirms the payment on the blockchain and the Medusa side verifies the signed webhook and re-checks the payment status with the API. A browser redirect alone never marks anything paid.

Can I test it before taking real payments?

Yes. A test API key (qk_test_…) works on public testnets with free faucet coins, so you can run the whole flow before switching to a live key. See the testing guide.

Where does the money go?

Into your Stablora balance, per network and asset. You withdraw to your own wallet from the dashboard, manually or automatically, and can have coins converted to USDT or USDC on supported networks.

Related integrations

All 35 integrations