Start free
English

Shopify crypto payments: how to accept them with Unheld

Unheld has no native Shopify plugin. It does not need one to take a payment: you add a payment link to your Shopify site, next to your checkout if you have one, and the customer pays on a hosted page.

Unheld does not replace any checkout you already have on Shopify. A crypto payment through Unheld is a separate payment on a hosted page, so Shopify does not see it and does not mark an order as paid by itself. What follows is the path that works today, and what you have to do yourself because there is no plugin to do it for you.

Shopify is a hosted platform, so you work with the places it lets you add a link, a button or a block of your own HTML, such as a product page, a page of its own or an email.

The steps, in order

  1. Create a checkout button in your Unheld dashboard

    Choose the amount, the coin and the network, and where the customer should land after paying. The button is a hosted link, not a script, so nothing on your Shopify site holds a secret key.

  2. Copy the payment link

    The dashboard shows the button's payment link. Each press from a new network address creates an invoice from the button's saved settings; pressing it again from the same address while that invoice is open returns the same invoice.

  3. Put the link on your Shopify site

    Add it anywhere Shopify lets you place a link or a block of HTML: a button on a page, a product page, a menu link. It sits beside any checkout you already have; it never replaces it.

  4. Decide how you will know an order is paid

    Unheld sends a signed webhook when an invoice is paid, and the payment shows in your dashboard and, if you have linked it, in Telegram. Shopify receives none of that, so you either mark the order paid by hand or have your own code receive the webhook. To tell which order a payment belongs to, first declare a reference field on the button, then pass your value in the link. It comes back in the webhook, but it is supplied by the visitor's browser, and a repeat press from the same address returns the invoice that already exists, with its first reference. Treat it as a reference to check, not as proof of who paid or of which order.

  5. Test on a testnet first

    Unheld lists test networks whose coins cost nothing. Create a button on one, pay it from a test wallet, and watch the payment arrive before a real customer does.

Read next

Common questions

Is there an Unheld plugin for Shopify?

No. There is no native Shopify plugin, and this guide does not pretend otherwise. What exists today is a payment link and a hosted payment page that you place on your Shopify site, plus signed webhooks if you can receive them.

Does this replace the checkout I already use on Shopify?

No. Any checkout you already have keeps working. The crypto payment is an extra option for customers who want it, made on a hosted Unheld page and paid straight to a wallet you control.

Will Shopify mark the order as paid automatically?

Not by itself, because Shopify does not see the payment. You mark the order paid after the payment shows in your dashboard, or you send Unheld's signed webhook to something you run yourself that does it for you.

Does Unheld hold the money while the customer pays?

No. The payment goes straight to an address from a wallet only you control. Unheld watches the chain and tells you it arrived; it never holds the funds.

Which coins can my Shopify customers pay with?

The coin and network you choose when you create the button, from those Unheld lists on its supported currencies page. For more than one coin, create a button for each. Pick a stablecoin if you want the price to stay put between invoice and payment.

Next

Pricing

Start free