Documentation You are here: start » gateways » coinbase

This is an old revision of the document!


type:
gateway
name:
Coinbase
countrie:
US
support-added:
1.1
auth-net-emulation:
no
supports-3dsecure:
no
supports-multicurrency:
yes
gateway:
http://www.coinbase.com

Coinbase

Subscriptions are not supported with Coinbase at this time. If you intend to sell subscriptions with your FoxyCart store, you will need to make use of another payment gateway.

Setting Up Coinbase for FoxyCart

There are a few advanced settings possible on the Coinbase side, but this is the minimum to get you going:

  1. Create an account with Coinbase (if you already have one, you may wish to start a new wallet for FoxyCart purchases). I highly suggest using two-step verification to better secure your account.
  2. From within Coinbase: Select Settings/API Access. Click the button “+ New API Key”.
  3. In the New API Key window, under the Accounts heading, select which wallet you want purchases to go into.
  4. Under the Permissions heading (for API version 1 if you see multiple versions) select “Merchant” only.
  5. Under the Security Settings heading, leave the Allowed IP Addresses blank.
  6. Click Create.
  7. Your new API key will show up in the API Key list, but it is disabled initially. You must click enable and you will be emailed a code to enable the API Key. Paste in the code and you have an active key.
  8. Note that the key is truncated in the API Key list, click on it to see the full API Key and API Secret.
  9. In a separate browser window open your FoxyCart settings and go to STORE/payment, select “Let customers pay with Coinbase:”, paste in your API Key and Secret Key. Then click “Update Payment Gateway”.
  10. Now back to Coinbase, where you have one final step before you can accept purchases: From your home account page select “Merchants” in the left sidebar. You must set up all of the info in the Profile tab (e.g. company name, logo, contact info and tax ID).
  11. Test, test, test.

Testing

Cheap way to test if you already have Bitcoin: I set up a $1 non-taxable item in my store and bought it with Bitcoin. Very smooth transaction! I'm impressed.

Obtaining a Test Account

Contact coinbase for info. Know more? Feel free to edit this page with info.

Test Card Numbers

Contact coinbase for info. Know more? Feel free to edit this page with info.

Troubleshooting & Interpreting Response Codes

Contact Coinbase for info. Know more? Feel free to edit this page with info.

If you do not configure your Merchants/Profile in Coinbase, you will not be able to complete a FoxyCart purchase. You, or your enduser/customer, will see an error code instructing you to set up your merchant profile.

Important Notes and Caveats

Instant Exchange is a Coinbase feature that allows you to accept Bitcoin, but have it instantly converted to currency (e.g. USD) and deposited to the bank account of your choice. This could significantly reduce your exposure to exchange rate fluctuations, but it comes at a price. As of March 4, 2015 the fees associated with this service is 1% + $0.15 per transaction. Keeping your payments in Bitcoin are free of transaction fees. More info: https://developers.coinbase.com/docs/merchants/payouts

I asked Coinbase about the API Key permissions to set and this was their reply:

The Merchant permission is all you need, and the only one that you should select in order to configure your FoxyCart account.

This will allow the following actions: Create payment buttons and forms, view your basic user information, edit your merchant settings, and generate new receive addresses

You shouldn’t need to restrict the server IP, both because the IP address Foxy uses may actually change, and because there is no risk of this key being used to move funds from your account.

I hope that helps! If you need further assistance, please let me know.

—John @ Coinbase

User Notes and Experiences

If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date. We reserve the right to edit or remove comments that don't add value to this page.

Site Tools