UPDATE: On March 5th, 2018, Coinbase announced that they are retiring the Coinbase Merchant Tools product in favor of their newly launched Coinbase Commerce. You can read the full announcement and changeover schedule here. In order to maintain focus on strengthening and improving the core of the MemberMouse platform, we have decided to end support of our Coinbase integration as of May 31, 2018. This is the date that Coinbase has set as the deadline to migrate over to Coinbase Commerce. 

From the information we have gathered from Coinbase, it appears that MemberMouse customers who have already integrated with Coinbase will not be affected. However, we encourage you to review any subscription accounts that pay you through Coinbase and transfer them to an alternate payment processor. The most straightforward method of doing this is to use the Payment Options dialog box and email a purchase link to the member. (You can find a complete listing of the payment methods MemberMouse supports here.)



MemberMouse integrates with Coinbase, which is an international digital wallet that allows you to accept Bitcoin currency on your site. There are 2 different types of Coinbase integrations, Wallet Required and Wallet Ignored.

Coinbase (Wallet Required) works like a traditional card-not-on-file solution (much like PayPal) but customers can use Bitcoins to pay. Coinbase (Wallet Ignored) allows customers to purchase recurring products directly from any Bitcoin wallet without needing to have a Coinbase account/wallet. Payments will still be handled behind the scenes by Coinbase, and you, the merchant, will still receive payments into your Coinbase wallet, so you'll need to create a Coinbase API key and secret key.


Setting Up A CoinBase Account


  1. Sign up for a Coinbase account at https://coinbase.com/signup.

  2. Once your account has been approved, you will need to complete your merchant profile, which can be found here. https://coinbase.com/merchant_profiles

  3. Next, you will need to set up an API Key. Click 'Settings' in the left hand menu from your Coinbase Dashboard:



  4. Click API in the top nav:



  5. If you have not already created one, you will need a new API Key.

  6. After verifying your account access, you will see the screen below:



  7. Select 'Show' next to the API v1 permissions (legacy) link:



  8. Select/Set the following options in this screen:

    Accounts: 'BTC Wallet (Primary)' - The primary account you are using on Coinbase.
    Permissions: Select orders, recurring payments, buttons, and merchant.
    Notifications: You can ignore this field.
    Security Settings: You can ignore these.

  9. Click Create.

  10. You will see the API Key has been created, but not enabled:




  11. Click Enable. You will have to verify your email address in order to enable the API:




  12. Once the API is enabled, it will look like this:




  13. Now click the API key link, and a popup will give you your API Key and Secret:




  14. Now, you will need to copy that API Key and API Secret to be used later


How To Configure Coinbase (Wallet Required)


  1. From the MemberMouse menu, click Payment Settings and then click on the Payment Methods tab.

  2. Scroll down to the Offsite Payment Methods section and check the box next to Coinbase (Wallet Required):



  3. Paste the API Key and API Secret in from your Coinbase account settings.

  4. To configure the Notification URL, go to https://coinbase.com/merchant_settings.

  5. Click 'Show API v1 callback settings':




  6. Enter the Notification URL listed on your site into the Callback URL area:




  7. Test the link.  You should see this popup message:




  8. Click Save Changes.  Remember, MemberMouse will handle directing customers to the correct confirmation page, so just use the exact URL listed on your site as the callback URL.

  9. Click Save Payment Methods.


How To Configure Coinbase (Wallet Ignored)


This version of the Coinbase gateway allows customers to purchase recurring products directly from any Bitcoin wallet without needing to
have a Coinbase account/wallet. Payments will still be handled behind the scenes by Coinbase, and you,the merchant, will still receive payments into your Coinbase wallet.

  1. From the MemberMouse menu, click Payment Settings and then click on the Payment Methods tab.

  2. Scroll down to the Offsite Payment Methods section and check the box next to Coinbase (Wallet Ignored):



  3. Paste the API Key and API Secret in from your Coinbase account settings.

  4. Since Bitcoin is a push (not pull) technology, when paying by straight Bitcoin a customer must initiate their payment for a recurring
    subscription each time that it is due.  There are 3 reminder emails to configure in order to remind customers to make their payment:




    Number Of Days NoticeThis setting controls how many days before their expiry date they will
    be notified by email (with a wallet address to send to) that their
    payment is due. To send no reminder, set this to 0.
    Subject Of NotificationThis will be the subject of the notification email. You can use the
    [MM_Member_Data]    , [MM_Order_Data] and [MM_Employee_Data] SmartTags.
    Content Of NotificationThis will be the text/content of the notification email. You can use the
    [MM_Member_Data], [MM_Order_Data] and [MM_Employee_Data] SmartTags here
    as well, and you MUST use the [MM_Bitcoin_Payment_Details] SmartTag which will
    output the wallet ID and amount that the user should send.

  5. Once you have configured all 3 notifications, you can click Save Payment Settings.