python-wepay 1.3.0

Python SDK for WePay API (third party).

######################################################################
python-wepay
######################################################################

**Python WePay SDK (third party)**

.. image:: https://travis-ci.org/lehins/python-wepay.svg?branch=master
:target: https://travis-ci.org/lehins/python-wepay

.. image:: https://coveralls.io/repos/lehins/python-wepay/badge.png?branch=master
:target: https://coveralls.io/r/lehins/python-wepay?branch=master

--------
Features
--------

* Make API calls in a very natural pythonic way, ex:
::

>>> api = WePay(production=False, access_token='STAGE_243...')
>>> response = api.credit_card.create(client_id, cc_number, ..., original_ip='127...')
>>> api.credit_card.authorize(client_id, client_secret, response['credit_card_id'])

* Validation of all required and optional parameters to each one of the calls.
* Very easy construction of batch calls, simply by passing `batch_mode=True` to
a call, ex:
::

>>> calls = []
>>> calls.append(api.credit_card.authorize(client_id, client_secret, response['credit_card_id'],
... batch_mode=True, batch_reference_id='ref_id_1234'))
>>> # append more calls ...
>>> response = api.batch.create(client_id, client_secret, calls)


-----
About
-----

This package started as a part of `Django WePay Application
<https://github.com/lehins/django-wepay>`_, but I soon realized it could be
useful to other developers in Python community that do not use `Django
<https://djangoproject.com>`_. Originally it meant to be an extension of an
official `Python WePay SDK <https://github.com/wepay/Python-SDK>`_, but instead
it became a replacement with full compatibilty with official WePay version.

------
Status
------

Production.

Requirements
------------

* Registered Application with WePay `production <https://wepay.com>`_ site or
it's `development <https://stage.wepay>`_ clone.
* `six <https://pypi.python.org/pypi/six>`_.
* `requests <http://docs.python-requests.org/en/latest/>`_ (optional):
* `mock <https://pypi.python.org/pypi/mock>`_ (optional, for tests only)

------------
Installation
------------
::

pip install python-wepay


-------------
Documentation
-------------

http://python-wepay.readthedocs.org/en/latest/index.html



---------------
Release History
---------------

1.3.0
^^^^^
* Python 3 compatible
* Calls are made using `requests <http://docs.python-requests.org/en/latest/>`_
library by default (if installed), falls back to `urllib
<https://docs.python.org/3/library/urllib.html#module-urllib>`_ if `requests`
are not installed or if :class:`WePay<wepay.api.WePay>` is initialized with
`use_requests=False`.
* :exc:`WePayConnectionError<wepay.exceptions.WePayConnectionError>` is raised
in case there is a problem connecting to WePay server, ex. timeout.
* Addition of a full test suit.
* Minor:

* 'original_ip' and 'original_device' params are now optional in
`/credit_card/create`.
* `silent` mode is more flexible.
* Moved `SubscriptionPlan` and `SubscriptionCharge` to their own modules.
* Moved `WePayWarning` over to `exceptions` module.

1.2.0
^^^^^
* New API version 2014-01-08 changes are reflected in this SDK version:

* implemented ``/user/register`` and ``user/resend_confirmation`` calls.
* added ``/account/get_update_uri`` and ``/account/get_reserve_details``
* depricated ``/account/add_bank``, ``/account/balance``, ``/account/get_tax``
and ``/account/set_tax`` calls.

* restructured SDK in such a way that all API objects are separate classes, so
as an example, if we have a WePay instance ``api = WePay()`` and we want to
make a `/account/find` call, it will look like this ``api.account.find()``
instead of ``api.account_find()`` (notice **.** instead of **_**), although in
this version both are equivalent, latter one is depricated and will be removed
in version 1.3. Despite these changes lookup calls will be the same, ex.
``api.account(12345)``.

* Added flexibility to use different API version per call basis. So it is now
possible to make a depricated call like this: ``api.account.balance(1234,
api_version='2011-01-15')``

* added ``batch_reference_id`` keyword argument to each call that accepts
``batch_mode``


1.1.2
^^^^^
* Added required arguments to ``/credit_card/create`` call:

* original_ip
* original_device

1.1
^^^

* Added subscription calls:

* ``/subscription_plan``
* ``/subscription``
* ``/subscription_charge``

* Few bug and spelling fixes.

1.0
^^^

Initial release