Skip to main content

A Python SDK for our WePay API.

Project description

WePay’s API allows you to easily add payments into your application.

For full documentation, see WePay’s developer documentation

Usage

These examples use the simple web.py application framework.

Setup

Import the module:

from wepay import WePay

Instantiate

Create a new WePay instance. With no arguments, it will use the production version of WePay (www.wepay.com). If called with production=False then it will use the staging version (stage.wepay.com) for testing.:

wepay = WePay()

If your user has already authorized your application and you still have the access token, you can instantiate the SDK with the optional access_token parameter. Afterwards, wepay.call() will use the given token for the authorization header.:

wepay = WePay(access_token=USERS_ACCESS_TOKEN)

To set an [API-Version](https://www.wepay.com/developer/reference/versioning) in the header with your call request, use:

wepay = WePay(production=False, access_token=USERS_ACCESS_TOKEN, api_version=API_VERSION)

Get authorized

Create an authorization url and redirect the user to it. The first parameter is where the user will be redirected back to after they finish authorization. The second is your CLIENT_ID which is provided by WePay.:

auth_url = wepay.get_authorization_url(web.ctx.homedomain + '/callback', CLIENT_ID)
web.redirect(auth_url)

Handle the callback

In your method for handling the redirect back to your site (in this case, /callback), you will need to load the GET param code and then call get_token with it. CLIENT_SECRET is provided by WePay. The first parameter of get_token should be the exact same string that was used in get_authorization_url.:

code = web.input(code='')['code']

# make sure the first arg is exactly the same as the first arg
# of get_authorization_url
wepay.get_token(web.ctx.homedomain + '/callback', CLIENT_ID, CLIENT_SECRET, code)

The get_token method will automatically load the access token into the WePay instance so that all future API calls will use that token for authorization. It also returns the entire response from the /v2/oauth2/token call if you need any additional data like the WePay ID.

Make some calls

You are now ready to do anything on behalf of your user. Let’s start by making a new account.:

create_response = wepay.call('/account/create', {
    'name': 'kitty expenses fund',
    'description': 'all the money for my kitty'
})

Now let’s set a picture!:

wepay.call('/account/modify', {
    'account_id': create_response['account_id'],
    'image_uri': 'http://www.placekitten.com/500/500'
})

Redirect them to their account page to see it.:

web.redirect(create_response['account_uri'])

Try it!

These examples are put together into a working web app in wepay-example.py. If you already have web.py installed, you can run it by simply doing python wepay-example.py. If you open the app in your browser you should be redirected to WePay to authorize the app. After you authorize, you should get redirected around a bit and end up on your new account page with a kitty picture.

License

MIT License

Project details


Release history Release notifications

History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

History Node

0.3.0

History Node

0.2.3

History Node

0.2.2

This version
History Node

0.2.1

History Node

0.1.5

History Node

0.1.3

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
wepay-0.2.1.tar.gz (4.9 kB) Copy SHA256 hash SHA256 Source None Apr 17, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page