Edit: Offline while working on accounts, distributed microtransactions and off-chain 100% uptime.Instructions on how to use the bbb billing interface:
1) Register an account,
bitcoinbankbook.com.
2) Add atleast one address by pressing the 'Add' button in the 'Menu'.
3) Browse here:
bitcoinbankbook.com/id?mail=your@mail.com,
after replacing the mail with the address used to register and copy your id.
4) Now you can redirect your customers to the following URLs:
Manual payments:
bitcoinbankbook.com/bill?id=<id>&meta=<meta>&price=<price> <id> | the id retrieved in step 3), this will never change.
|
<meta> | your unique identifier for this bill so you know what was paid for. This HAS to be unique.
|
<price> | the optional amount of BTC to be billed, without this parameter the bill becomes a donation of any amount.
|
If you are logged into the GWT GUI you will see the 'Transactions' dialog refresh
in real-time with your
<meta> as the transaction comes in!
You will also receive an email once the transaction has one confirmation.
Automated payments:
bitcoinbankbook.com/bill?id=<id>&meta=<meta>&url=<url>&price=<price> <url> is the callback where you want us to inform you about billings; confirmations and errors,
"successful" billings will call the
<url> twice or more with these appended parameters:
<url>?|&tx=<tx>&amount=<amount>&meta=<meta>&auth=<auth>&confirm=0,1... <tx> | the bitcoin transaction id.
|
<amount> | the amount of BTC received. Might not be same as price!
|
<auth> | the lowercase HEX SHA-1 hash of your password salted with the <id>, <meta> and <confirm> and hashed again.
|
/* Pseudo code to verify <auth>
*/
String auth = SHA(SHA("<yourplaintextpass>") + "<id>" + "<meta>" + "<confirm>");
If you reply with a URL on the first callback request (confirm=0) in the response data (any string that starts with "http" will trigger this) we will try to redirect your customer to that URL upon successful billing (meta refresh after 5 seconds) with meta=
<meta> appended to the parameters.
If you receive the following parameters on your callback
<url>, it means we already have that meta string in our database:
<url>?|&
meta=<meta>&error=meta+not+unique One last thing: if you use this please leave a comment here so I can send you a PM before updates go live.
-----
TODO:
QR code generator.calculator and timer.pay with bbb account.