Docs
Payment Processors
Coinbase

Coinbase Commerce

This guide will walk through setting up your Coinbase account in CheckoutJoy.

Supported Payment Options

  • One-time payments
  • Multiple payments
  • Subscriptions

How does it work?

Coinbase Commerce is a payment processor that allows taking payments using various crypto currencies like Bitcoin, Ethereum, Litecoin and others.

Anyone with a Coinbase Commerce account can sell products through CheckoutJoy and accept crypto payments into Coinbase Commerce wallets.

When a customer completes a checkout they are taken to a Coinbase payment page which is hosted by Coinbase. The total of the transaction is given in USD, and depending on the currency the customer selects, they will be charged the equivalent of the USD total in the selected currency.

CheckoutJoy waits for confirmation from Coinbase that the funds have successfully been transferred before processing the transaction.

Transaction Status and Product Activation

Because of the nature of crypto payments, some transactions can take up to 30 minutes to complete after completing the checkout. It depends on things like the currency being used, and the status of the currency's network at the time of the transaction. For example payments made with BTC or ETH can take up to 30 minutes to complete. This is something to keep in mind when accepting payments with Coinbase.

At the moment, CheckoutJoy will only process the transaction when confirmation has been received from Coinbase that the funds have settled in your Coinbase wallet (i.e. the Charge Confirmed event).

Pricing your products

Coinbase Commerce does currency conversion on checkout from USD to the various crypto currencies. You can price your products in any currency, if it's something other than USD then CheckoutJoy will convert the total to USD before setting up the payment with Coinbase.

Adding your account details

In the CheckoutJoy dashboard

  1. Navigate to Settings > Payment Methods
  2. Select Coinbase and click on Add

Finding your API Key

  1. Log into your Coinbase account
  2. Navigate to **Settings > Security **
Accept payment with Coinbase Commerce

Finding your Webhook Shared Secret

  1. Log into your Coinbase account
  2. Navigate to **Settings > Notifications **
  3. Click the Show shared secret button

Setting up webhook notifications

CheckoutJoy needs to be notified of any payment events such as successful payment authorizations or refunds in order to manage your customer's access to your products.

To do this you need to add the CheckoutJoy webhook API address to your Coinbase Webhook configuration.

In your Coinbase dashboard:

  • Navigate to Settings > Notifications
  • Select the Add an endpoint button top right
  • Check all the boxes and save your settings
SettingValue
Webhook URLhttps://api.checkoutjoy.com/v1/notify?p=Coinbase (opens in a new tab)