Payment Pages

Accept bitcoin via a hosted checkout page on coinbase.com

Sample page

View example payment page

Sample code

When you create a payment page, it will give you code like this example.

<a href="https://www.coinbase.com/checkouts/2b30a03995ec62f15bdc54e8428caa87" target="_blank" rel="noreferrer noopener">Donate Bitcoins</a>

Any bitcoin sent using the sample page will be donated to the charity depicted.

Features

  • Send users to a hosted payment page on coinbase.com to collect bitcoin payments.
  • Customize the payment page with your logo and contact information.
  • Prices can be shown in bitcoin or your local currency.
  • Notifications can be sent to your website when an order is placed.
  • Bitcoins can be automatically cashed out daily to any bank account.
  • Allows first time users to purchase bitcoin if they don’t own any.
  • Create pages dynamically via the Coinbase API.

How to Create a Payment Page

Payment pages can be generated via our page generator (shown below) or the Coinbase API.

The page generator is the easiest way to get started:

The only required paramaters are a name and price. Once a page is generated, you’ll be given a sample link to copy and paste into your website. You are of course welcome to modify the link in any way, such as changing the text or using a button as the link target.

Payment pages are just regular links and also work well in emails, Twitter, Craigslist posts, or environments where you are unable to include javascript.

Advanced Options

Generating Payment Pages through the API

Payment pages are very similar to payment buttons and are stored in the same way underneath by Coinbase. This means you can use the Checkouts API to also generate payment pages.

Once you get a code parameter returned from the API you can use it to contruct a link to a payment page with the following format: https://www.coinbase.com/checkouts/CODE

Setting a Custom Attribute

If you’d like to change the custom attribute after a page is created, you can do so by including custom=YOUR_CUSTOM_PARAM on the end of the URL. This will be included to order’s metadata field.

For example:

https://www.coinbase.com/checkouts/4d4b84bbad4508b64b61d372ea394dad?custom=1234

This will update the generated order and get passed through in the callback to your site. This is a good way to use the same page but pass through a different custom parameter on each order.

The URL parameter can also be abbreviated as c=1234 if you’d like to keep it shorter.

Redirect URLs

When a user leaves your site to visit a payment page, it’s often useful to redirect them back to a specific url. You can customize three types of redirect URLs:

Type Description
Success URL Users will be redirected to this url after successfully completing an order or payment. You may want to provide the user with an updated account status on this page, or an indication that their payment was successful.
Cancellation URL Users will be redirected to this url if we are unable to confirm their payment or they click cancel.
Info URL Users will be redirected to this url if they want to learn more about how to pay with bitcoin on your website.

All redirect urls are optional. If a redirect URL is left blank, Coinbase will redirect the user to your general website url (usually your homepage) or failing that, the Coinbase homepage.

You can set redirect URL’s from the merchant settings page.

Redirect_urls

When redirecting to a success or cancel page, we will also include URL params. These can be useful to help determine the user or order in question via the custom param if you want to customize the page.

However, it’s important to note that you should never mark an order as paid in your records based on a redirect url. This url can be easily guessed by malicious users. Only notifications should be used to update your records.