Accept Bitcoins, Automated
We provide a web-service API for accepting bitcoins and tracking order payments.
How It Works
An access token is required for each request. Here is how to create an order and handle payment notifications:
Handling Payment Notifications
We send payment notifications to the URL you specify. It is important for you to verify the post is from us.
1) Create a string with parameter pairs under "Payment Notification" in alphabetical order, it should look like this: param1=v1params2=v2.... Do not include the signature.
2) Add your access token in front of the string
3) Perform a SHA2 hash function
Creating Additional Access Tokens
We provide you with your primary access token upon signup. Additional access tokens can be created to provide order and payment notifications for individual customers. For example, if you are building a Bitcoin marketplace, an access token can be created for each individual seller. We handle tracking of each order, and forward payments directly to the seller.
Ruby example for creating an order:
How many orders can I create?
Accounts are currently limited to creating 100 new orders per day. Please contact us at firstname.lastname@example.org if you need this limit raised.
Why do you reserve 0.1BTC for each account?
Bitcoin, by design, may include a transaction fee when sending payments, thus we maintain a 0.1BTC reserve per account to cover transaction fees when we forward payments to you. For example, if your account balance is 29.8BTC; we will forward you 29.7BTC. Assuming a 0.005 transaction fee has been added to thetransaction, you final balance on BitcionPAYFLOW will be 0.095BTC. We will only forward you payments if your balance is above the reserved amount.
How do I issue refunds?
You can refund orders the same way you create new orders, except you need to pass in a 'recipient_bitcoin_address' field with the buyer's bitcoin address. We will return a bitcoin address for you to make refund payment to. If you do not make the payment to the given address, w will deduct refund amount from your account balance. You will receive a Payment Notification when we refund BTCs to your buyer, with the 'category' parameter set to 'send' instead of 'receive'.
How long does it take to receive payment notifications?
We post payment notifications as soon as the transaction has populated to us (on average 5 minutes.) Payments are forwarded after 6 network confirmtions. As we do not control the network hash rate, we cannot guarantee how quickly 6 confirmations will be received, but in general this is within 1 hour.
Free, as long as we can cover operational costs and feed ourselves =). Donations are graciously accepted at 17ngyAepVNKy4he2hHGyUTE8yy7ohrToA1
Contact us: email@example.com