Python wrapper for PAYMILL API(beta)
## Getting started
- If you are not familiar with PAYMILL, start with the [documentation](https://www.paymill.com/en-gb/documentation-3/).
- Install the latest release.
- Check the API [reference](https://www.paymill.com/en-gb/documentation-3/reference/api-reference/).
- Check the tests.
You can either choose to install the package from PyPi executing following line:
pip install paymill-wrapper
Or you can check out the project, and install it locally. Navigate to the root directory and execute following line:
pip install . -r requirements.txt
## What's new
We have released version 1.1.0 which is coded directly to the PAYMILL API v2.1 and is Py2&3 compatible.This version is no longer backwards compatible with the pymill fork from https://github.com/kliment/pymill. If you need to be PAYMILL API v2.0 compatible please use https://github.com/paymill/paymill-python/tree/v0.1.2.
Initialize the library by providing your api key:
paymill_context = paymill.PaymillContext('<YOUR PRIVATE API KEY>')
PaymillContext loads the context of PAYMILL for a single account, by providing a merchants private key. It creates 8 services, which represents the PAYMILL API:
These services should not be created directly. They have to be obtained by the context's accessors.
### Using services
In all cases, you'll use the predefined service classes to access the PAYMILL API.
To fetch a service instance, call *service name* accessor from paymill_context, like
client_service = paymill_context.get_client_service()
Every service instance provides basic methods for CRUD functionality.
### Creating objects
Every service provides instance factory methods for creation. They are very different for every service, because every object can be created in a different way. The common pattern is
For example: client can be created with two optional parameters: *email* and *description*. So we have four possible methods to create the client:
#creates a client without email and description
#creates a client with email
#creates a client with description
client_service.create(description='CRM Id: fake_34212')
#creates a client with email and description
client_service.create(firstname.lastname@example.org', description='CRM Id: fake_34212')
### Retrieving objects
You can retrieve an object by using the get() method with with the instance itself:
This method throws an PMError if there is no client under the given id.
### Retrieving lists
To retrieve a list you may simply use the list() method:
clients = client_service.list()
You may provide a filter and order to list method:
clients = client_service.list(
This will load only clients with email email@example.com, order descending by creation date.
### Updating objects
In order to update an object simply call a service's update() method:
### Deleting objects
You may delete objects by calling the service's delete() method with an object instance.
* Disable httplib debugging by default
* http_debugging_enabled otional parameter added to PaymillContext
* Bug fixing
* ChecksumService added
* FilterList added
* PyPi release fixed
* Some names regarding package installation changed
* Official PyPi release
* Support for Py3
* FilterList added for filter combination
* Bug fixing & code improvements
* New implementation from scratch that conforms to PAYMILL API v2.1
Copyright 2014 PAYMILL GmbH.
MIT License (enclosed)
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.