Show Posts
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. |
Code:
/* 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:
calculator and timer.
pay with bbb account.
