This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description
New usage: from bitpay_client import BitPay.API
©2014 BITPAY, INC.

Permission is hereby granted to any person obtaining a copy of this
software and associated documentation for use and/or modification in
association with the bitpay.com service.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Bitcoin Python payment library using the bitpay.com service.

Installation
------------

Varies depending on what python webserver framework you are using
(SimpleHTTPServer, Flask, Bottle, Django, etc.). Most of the calls will
run as-is from a script, but bpVerifyNotification will require updating
depending on your framework. You can integrate these functions into your
custom shopping cart implementation.

Configuration
-------------

Note: Python 2.7 and its built in libraries are required for use of this
code library.

1. Create an API key at bitpay.com by clicking My Account > API Access
Keys > Add New API Key.
2. In the bp\_options.py file, configure the options specific to your
implementation.

Usage
-----

1. In your shopping cart code, call bpCreateInvoice() with the
appropriate orderID, price, posData and options.
2. The library will attempt to POST the new invoice information via curl
to the BitPay network. If successful, you will receive an invoice in
the return response. Any errors in this process will return an array
with a single element: 'error' and the exception msg.
3. You may use the bpLog function manually to log any information you
would like to track or automatically by setting the useLogging option
to true in the bp\_options file. The log file could potentially get
very large, depending on usage, so monitor closely or only use during
debugging.
4. Responses from the BitPay network are JSON. You can use the new
decodeResponse() function to convert these to an associative array,
if needed.

Troubleshooting
---------------

The official BitPay API documentation should always be your first
reference for development: https://bitpay.com/downloads/bitpayApi.pdf

1. Verify that your "notificationURL" for the invoice is "https://"
(not "http://")
2. Ensure a valid SSL certificate is installed on your server. Also
ensure your root CA cert is updated. If your CA cert is not current,
you will see curl SSL verification errors.
3. Verify that your callback handler at the "notificationURL" is
properly receiving POSTs. You can verify this by POSTing your own
messages to the server from a tool like Chrome Postman.
4. Verify that the POST data received is properly parsed and that the
logic that updates the order status on the merchants web server is
correct.
5. Verify that the merchants web server is not blocking POSTs from
servers it may not recognize. Double check this on the firewall as
well, if one is being used.
6. Use the logging functionality to log errors during development. If
you contact BitPay support, they will ask to see the log file to help
diagnose any problems.
7. Check the version of this Python library agains the official
repository to ensure you are using the latest version. Your issue
might have been addressed in a newer version of the library.
8. If all else fails, send an email describing your issue *in detail* to
support@bitpay.com
9. To manually test the library, update the options file with your API
key and do the following:

.. raw:: html

<pre>
$ python
>>> import bp_lib
>>> bp_lib.bpCreateInvoice(123, 1, 'fish')
</pre>

After a brief pause, you should get a JSON response that looks
something like:

.. raw:: html

<pre>
{'status': 'new', 'invoiceTime': 1393950046292, 'currentTime': 1393950046520, 'url': 'https://bitpay.com/invoice?id=aASDF2jh4ashkASDfh234' 'price': 1, 'btcPrice': '1.0000', 'currency': 'BTC', 'posData': '{"posData": "fish", "hash": "ASDfkjha452345ASDFaaskjhasdlfkflkajsdf"}', 'expirationTime': 1393950946292, 'id': 'aASDF2jh4ashkASDfh234'}
</pre>

Change Log
----------

Version 1.1 - Added new HTTP header for version tracking

Version 1 - Initial version
Release History

Release History

0.1.1

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
bitpay-client-0.1.1.linux-x86_64.tar.gz (11.0 kB) Copy SHA256 Checksum SHA256 any Dumb Binary Jul 2, 2014
bitpay-client-0.1.1.tar.gz (7.4 kB) Copy SHA256 Checksum SHA256 Source Jul 2, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting