Cryptonly

Official Cryptonly payment provider for Medusa v2.

npm install @cryptonly/medusa-plugin-cryptonly

Cryptonly — Crypto payments for Medusa v2

Accept Bitcoin, Ethereum, stablecoins, and more in your Medusa store.

Website · Documentation · Live demo · Contact

adds crypto payments to Medusa v2 via Cryptonly's hosted checkout.

Customers pay on a secure Cryptonly page and return to your store. You keep pricing in fiat. Payment status updates automatically via signed webhooks - no manual matching, no chargebacks.

Features

Hosted checkout — no crypto UI to build, customers pay on Cryptonly's page
Signed webhooks — payments capture automatically when paid
Fiat pricing — price products in USD/EUR, crypto amounts calculated at checkout
Sandbox mode — test the full flow before going live
0.5% per transaction — no setup fee, no monthly fee

Quick start

npm install @cryptonly/medusa-plugin-cryptonly

1{
resolve: "@medusajs/medusa/payment",
options: {
  providers: [
    {
      resolve: "@cryptonly/medusa-plugin-cryptonly/providers/cryptonly",
      id: "cryptonly",
      options: {
        apiKey: process.env.CRYPTONLY_API_KEY,
        accountId: process.env.CRYPTONLY_ACCOUNT_ID,
        webhookSigningKey: process.env.CRYPTONLY_WEBHOOK_SIGNING_KEY,
        sandbox: process.env.CRYPTONLY_SANDBOX === "true",
        backendUrl: process.env.MEDUSA_BACKEND_URL,
      },
    },
  ],
},
18}

Then enable Cryptonly on a region in Medusa Admin — done.

📘 Full setup (webhooks, storefront, testing): Medusa integration guide

🔑 Get your API keys: merchant.cryptonly.net

Requirements

Medusa v2.8+
Node 20+
Cryptonly merchant account

Support

License

MIT

More in this category

View all

Payments

Braintree

By Lambda Curry

Support payments and 3D Secure via Braintree

Payments

Pay.

By Webbers

Accept credit cards, digital and buy now pay later

Payments

Mollie

By Variable Vic

Accept multi-currency payments easily with Mollie

Features

Hosted checkout — no crypto UI to build, customers pay on Cryptonly's page

Signed webhooks — payments capture automatically when paid

Fiat pricing — price products in USD/EUR, crypto amounts calculated at checkout

Sandbox mode — test the full flow before going live

0.5% per transaction — no setup fee, no monthly fee

Quick start

npm install @cryptonly/medusa-plugin-cryptonly

1{
2  resolve: "@medusajs/medusa/payment",
3  options: {
4    providers: [
5      {
6        resolve: "@cryptonly/medusa-plugin-cryptonly/providers/cryptonly",
7        id: "cryptonly",
8        options: {
9          apiKey: process.env.CRYPTONLY_API_KEY,
10          accountId: process.env.CRYPTONLY_ACCOUNT_ID,
11          webhookSigningKey: process.env.CRYPTONLY_WEBHOOK_SIGNING_KEY,
12          sandbox: process.env.CRYPTONLY_SANDBOX === "true",
13          backendUrl: process.env.MEDUSA_BACKEND_URL,
14        },
15      },
16    ],
17  },
18}

Then enable Cryptonly on a region in Medusa Admin — done.

📘 Full setup (webhooks, storefront, testing): Medusa integration guide