Skip to main content
Coinbase Payments

Coinbase Payments

Accept crypto payments via Coinbase Commerce

npm install @pinelab/vendure-plugin-coinbase
Latest version1.4.0
Compatibility>=2.2.0
Last publishedJun 4, 2025
Pinelab
PinelabWebshops for mission-driven brands and wholesalers

Official documentation here

Accept crypto payments via Coinbase Commerce in Vendure.

Getting started

Add the plugin to your vendure-config.ts:

2. Set API key in Vendure

  1. Start your server
  2. Go to the Admin UI > Settings > Payment methods and add a payment method with handler coinbase-payment-handler
  3. Set your Coinbase API key. You can find your API key at https://beta.commerce.coinbase.com/settings/security
  4. Set your desired storefront redirectUrl, something like https://storefront/order/. Your customer will be redirected to this page + order code: https://storefront/order/897HH7HG7
  5. Save the payment method

3. Set webhook in Coinbase

  1. Go to https://beta.commerce.coinbase.com/settings/notifications
  2. Add a new webhook with endpoint https://<your-vendure-server>/payments/coinbase

4. Storefront usage

You can now call the mutation createCoinbasePaymentIntent to get a redirectUrl to the Coinbase hosted checkout page. You can redirect your customer to this URL, so your customer can continue making a payment on the Coinbase platform. After payment the customer will be redirected to https://storefront/order/897HH7HG7

Notes

  • Orders are NOT transitioned to PaymentSettled directly after Coinbase redirects the customer to the confirmation page, because crypto transactions can take some time to confirm. You should notify your customer with a message that the order will be handled when their transaction is confirmed. This can take a few minutes.

  • Refunds are not supported. If you want to refund a payment done via Coinbase you need to manually do so. This plugin will not do refunds via Coinbase.