WePay SDK for Ruby
Check out our developer docs at https://stage.wepay.com/developer for more information, or you may email api@wepay.com if you have any other questions.
This project uses Semantic Versioning for managing backwards-compatibility.
NOTE: Version 0.4.0 is not strictly backwards-compatible with the earlier 0.0.x versions.
NOTE: Due to impending PCI 3.x changes, we will be disabling support for TLS < 1.2 over our API. TLS 1.2 support requires Ruby 2.0.0. As such, while this SDK may function with Ruby 1.9, we no longer support it.
Installation
gem 'wepay', '~> 0.4.0'
And include it in your scripts:
require 'wepay'
Examples
client_id = 'your_client_id'
client_secret = 'your_client_secret'
use_stage = true
wepay = WePay::Client.new(client_id, client_secret, use_stage)
# Get the OAuth 2.0 authorization URL. Send the user to this URL to authorize
# the application, then they will return to your `redirect_uri` with a code as
# a GET parameter.
redirect_uri = "http://myexamplesite.com/wepay"
redirect_to(wepay.oauth2_authorize_url(redirect_uri))
# Once you have the OAuth 2.0 code, you can request an access token.
response = wepay.oauth2_token(code, redirect_uri)
access_token = response['access_token']
# Make a call to the `/user` endpoint (which requires no parameters).
response = wepay.call('/user', access_token)
# You may also open a payment account for the user.
response = wepay.call('/account/create', access_token, {
:name => "test account",
:description => "this is only a test"
})
Testing
Firstly, run bundle install
to download and install the dependencies.
You can run the tests as follows:
make test
API Reference
The API Reference is generated by a tool called YARD. Once it's installed, you can generate updated documentation by running the following command in the root of the repository.
make docs
Contributing
Here's the process for contributing:
- Fork Signer to your GitHub account.
- Clone your GitHub copy of the repository into your local workspace.
- Write code, fix bugs, and add tests with 100% code coverage.
- Commit your changes to your local workspace and push them up to your GitHub copy.
- You submit a GitHub pull request with a description of what the change is.
- The contribution is reviewed. Maybe there will be some banter back-and-forth in the comments.
- If all goes well, your pull request will be accepted and your changes are merged in.
Authors, Copyright & Licensing
- Copyright (c) 2012–2017 WePay
See also the list of contributors who participated in this project.
Licensed for use under the terms of the Apache 2.0 license.