Medusa v2 payment provider

The crypto payment gateway for Medusa

A payment provider module for Medusa v2. Customers pay on a hosted page with a live confirmation count, and the order is marked paid by a signed webhook when the transfer settles on-chain.

Get the packageCreate a free account

$ npm install @oxialink/medusa-payment

Medusa v2Free & MIT licensedTypeScript, typed end to end

Coins your store can accept

₮USDT_TONUSDT TON₮USDT_TRC20USDT TRC20₮USDT_BEP20USDT BEP20$USDC_SOLANAUSDC SOLANA₿BTCBTCΞETHETHTTONTONBBNBBNBTTRXTRXŁLTCLTCÐDOGEDOGEDDASHDASH

Built like a payment plugin should be

One API key, 14 coins

A single set of credentials covers USDT on five networks, BTC, ETH, TON and more.

Signed webhooks

Orders complete only after a byte-exact HMAC-verified callback with replay protection.

Hosted checkout

Customers pay on a page with a QR code, wallet deeplinks and a live confirmation count.

Stablecoins in seconds

USDT on TON and Solana settles while the customer is still on the page.

Honest edge cases

Underpayments are flagged for review; expired invoices resolve automatically.

No chargebacks

Crypto is final. No disputes, no rolling reserves, no frozen payouts.

Setup

Accept crypto payments in minutes

  1. 1

    Install the package

    npm install @oxialink/medusa-payment in your Medusa project. It ships its own types and needs no build step of yours.

  2. 2

    Register one provider per coin

    Add the module to the payment providers array in medusa-config.ts, once for each coin you accept, each with its own wallet API key. The key pins the coin, so your customers pick from the payment options Medusa already shows.

  3. 3

    Enable it on your region

    Turn the providers on in Medusa Admin, redirect the customer to data.pay_url after the session is created, and point your Oxialink webhook at the callback URL.

Also available: WooCommerce, Shopify, WHMCS and SDKs for Node, PHP and Laravel.

FAQ

Common questions

Install @oxialink/medusa-payment, register it in the payment providers array in medusa-config.ts with a wallet API key for each coin you accept, and enable the providers on your region. Customers are redirected to a hosted payment page, and a signed webhook marks the order paid when the transfer settles on-chain.

14 coins across 9 networks: USDT on TON, Tron, BSC, Solana and Ethereum, USDC, Bitcoin, Ethereum, Litecoin, Dogecoin, Dash, BNB, TRX and Toncoin.

Oxialink watches the blockchain and sends a cryptographically signed webhook when the payment reaches confirmation depth. The plugin verifies the signature byte-exactly and updates the order automatically.

The plugin is free. Oxialink accounts are free with no KYC to start, and a payment costs 0.2% on Premium or 0.5% free, plus one flat per-coin network fee published at oxialink.com/fees.

Add crypto to your store today

Free plugin, free account, first payment in minutes.

Download the plugin