fudong1127 / coinkite-real-time-invoice

Open Source Bitcoin Checkout and Invoice System

Bitcoin Checkout and Invoice System

This is a Google App Engine demo project, showing a Bitcoin (or Litecoin or BlackCoin) checkout and invoicing system with live quotes.

It produces nice-looking QR and BIP32-compliant payment links for the amount, and has the customary time-limit, with animated count down, to indicate the exchange rate quote timeout.

Most important of all, real-time sensing of completed payment is demonstrated: Once the payer sends a transaction to the pubkey, the invoice immediately clears and thanks the payer.

Other features:

• Support all fiat currencies rates from Coinkite, plus all cryptos.
• QR codes rendered directly into the page's HTML as SVG objects (faster, resolution independent).
• Bootstrap v3 for responsive design: works on iPhones and desktops.
• Demonstrates the Coinkite python API library (ckapi) on GAE.
• Open source, so run with it!

Learn more about Coinkite's API here and visit the Coinkite Main Site to open your account today!

The Demo

https://ck-rt-invoice.appspot.com

See a live Bitcoin Invoice demo here. (The data shown is placeholder, so don't try to pay it!)

Litecoin and Blackcoin examples can be reached from the site home page.

Example Invoice

Responsive Layout

Making a New Invoice

How To Run Locally

Clone this repo:

git clone [email protected]:coinkite/coinkite-real-time-invoice.git

Then update the submodules:

git submodule update

Get an API key for your Coinkite account. It should have recv, read and events permissions and access to the related accounts. Edit settings.py to insert your API key for it to use.

Then run Google AppEngine... (this can also be done via their GUI).

dev_appserver.py app.yaml
open http://localhost:8080

Usage

Go to /make to see a list of invoices and their status. You may also create new invoices on that page, simply by specifying an amount and currency type.

Invoices are presented at /invoice/<token> where token is a random code. This is the URL you would give out to your customers via email or whatever.

Code Layout

• static/ Static assets: CSS and Javascript files.
• templates/ HTML templates (Jinja2) format
• app.yaml AppEngine configuration
• index.yaml GAE indexing
• lib/ Python modules, loaded as submodules with symlinks
• main.py Mainline code.
• models.py Database models (one -- an invoice)
• settings.py Coinkite API keys.

Confirmations

This system works on zero-confirmation (in BTC), which isn't appropriate for real money. It should have different messaging for zero and one confirmations and fully-confirmed amounts. Of course, you want to acknowledge the payment on zero confirmation, but you shouldn't ship any goods without at least one confirmation.

More about Coinkite

Join The Most Powerful Bitcoin Platform

Coinkite is the leading bitcoin wallet with multi-signature, bank-grade security, developer's API and hardcore privacy.

Get Your Account Today!