Difference between revisions of "Merchant Howto"

From Bitcoin Wiki
Jump to: navigation, search
(See Also: Add an entry for marketing.)
Line 34: Line 34:
* [[Converter|Bitcoin Javascript Converter]] displays a price in BTCs after converting from USDs.
* [[Converter|Bitcoin Javascript Converter]] displays a price in BTCs after converting from USDs.
* [[How to accept Bitcoin, for small businesses]]
* [[How to accept Bitcoin, for small businesses]]
* [[Marketing]]
* [[Promotional graphics]], buttons and logos
* [[Promotional graphics]], buttons and logos

Revision as of 04:03, 25 April 2011

This page is intended as a guide to assist merchants learn how to accept bitcoins for payment.


  1. Download a bitcoin client
  2. When a customer wants to buy something issue them with a bitcoin address
    • You can do this by clicking "New.." next to your address in the bitcoin client and sending that address to the customer
  3. When payment comes in from that address send the goods to your customer. Depending on your risk tolerance and the value of the purchase, you may wish to wait until the payment shows enough confirmations to protect against double spending.
  4. To issue a refund, obtain from the customer the bitcoin address where the refund payment should be sent. The refund address will likely be different from the address used when the customer sent payment, especially if an EWallet was used by the customer.


You can use an existing shopping cart interface or utilize the Bitcoin client's JSON-RPC API to automatically accept payments.

Setup a system that:

  1. When a customers orders something on your website it records
    • Bitcoin address that payment should be sent to
    • Order details (delivery address etc.)
    • Payment amount
  2. When payment arrives, checks that they have paid the correct amount (and refunds the from address otherwise) and informs you
    • You dispach the goods to the customer and mark the order as fulfilled
    • If you cannot dispach the goods you mark the order as denied and the system sends the customer a refund
  3. Pays money made to your bitcoin address

Common Errors

It has been observed several times that businesses try to funnel all orders through the same bitcoin address, and ask people to send some BTC, then send email describing the timing and the amount of the transaction to 'claim' it. This is not secure, since anyone can see the transaction details using a tool such as Block Explorer, or by inspecting the block chain database directly, and then try to claim someone else's transaction as theirs. Do not do this - give each customer a unique bitcoin address, as suggested in the manual section of this page.

Listing your business on the Bitcoin Trade page

Anyone can add and update a listing on the trade page. Just register if you haven't and add to the appropriate category. If you'ld like assistance, perhaps someone in the #bitcoin-marketing IRC channel would be willing to assist.

See Also