Skip to main content

Python SDK for WePay API (third party).

Project description

######################################################################
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.0
^^^^^

* Added subscription calls:

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

* Few bug and spelling fixes.

1.0.0
^^^^^

* Initial release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-wepay-1.3.1.tar.gz (40.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page