Image 1 of 1

Coinbase Payments

Product information

By Pinelab

Accept crypto payments via Coinbase Commerce

npm install @pinelab/vendure-plugin-coinbase
Support by
Support languages
Integration type
Compatible with
Latest version
Last published
Jun 25, 2024
Downloads in past month

Vendure Coinbase plugin

Official documentation here

Accept crypto payments via Coinbase Commerce in Vendure.

Getting started

Add the plugin to your vendure-config.ts:

import { CoinbasePlugin } from "@pinelab/vendure-plugin-coinbase"

plugins: [

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
  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
  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


  • 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.

Get started

Create your first commerce experience with Vendure in less than 2 minutes

Vendure is a registered trademark. Our trademark policy ensures that our brand and products are protected. Feel free to reach out if you have any questions about our trademarks.


Get the latest product news and announcements delivered directly to your inbox.

© Copyright 2022 - 2024, Vendure GmbH. All rights reserved.