com.lookfirst.wepay

Class WePayApi

java.lang.Object

com.lookfirst.wepay.WePayApi

public class WePayApi
extends Object

Implements a way to communicate with the WePayApi. https://www.wepay.com/developer/reference

Author:

Jon Scott Stevens, Jeff Schnitzer

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	WePayApi.DataProviderImpl For unit testing.
static class	WePayApi.Scope Scope fields Passed into Wepay::getAuthorizationUri as array https://stage.wepay.com/developer/reference/permissions

Field Summary

Fields

Modifier and Type	Field and Description
static com.fasterxml.jackson.databind.ObjectMapper	MAPPER

Constructor Summary

Constructors

Constructor and Description
WePayApi(WePayKey key)
WePayApi(WePayKey key, DataProvider provider) For unit testing.

Method Summary

Methods

Modifier and Type	Method and Description
<T> T	execute(String token, WePayRequest<T> req) Make API calls against authenticated user.
String	getAuthorizationUri(List<WePayApi.Scope> scopes, String redirectUri, String state) Generate URI used during oAuth authorization Redirect your user to this URI where they can grant your application permission to make API calls
String	getAuthorizationUri(List<WePayApi.Scope> scopes, String redirectUri, String state, String userName, String userEmail) Generate URI used during oAuth authorization Redirect your user to this URI where they can grant your application permission to make API calls
Token	getToken(String code, String redirectUrl) Exchange a temporary access code for a (semi-)permanent access token

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MAPPER

public static final com.fasterxml.jackson.databind.ObjectMapper MAPPER

Constructor Detail

WePayApi

public WePayApi(WePayKey key)

WePayApi

public WePayApi(WePayKey key,
        DataProvider provider)

For unit testing.

Method Detail

getAuthorizationUri

public String getAuthorizationUri(List<WePayApi.Scope> scopes,
                         String redirectUri,
                         String state)

Generate URI used during oAuth authorization Redirect your user to this URI where they can grant your application permission to make API calls

Parameters:

scopes - List of scope fields for which your application wants access

redirectUri - Where user goes after logging in at WePay (domain must match application settings)

state - The opaque value the client application uses to maintain state.

Returns:

string URI to which you must redirect your user to grant access to your application

See Also:

https://www.wepay.com/developer/reference/oauth2

getAuthorizationUri

public String getAuthorizationUri(List<WePayApi.Scope> scopes,
                         String redirectUri,
                         String state,
                         String userName,
                         String userEmail)

Generate URI used during oAuth authorization Redirect your user to this URI where they can grant your application permission to make API calls

Parameters:

scopes - List of scope fields for which your application wants access

redirectUri - Where user goes after logging in at WePay (domain must match application settings)

userName - user_name,user_email which will be pre-filled on login form, state to be returned in querystring of redirect_uri

Returns:

string URI to which you must redirect your user to grant access to your application

See Also:

https://www.wepay.com/developer/reference/oauth2

getToken

public Token getToken(String code,
             String redirectUrl)
               throws IOException,
                      WePayException

Exchange a temporary access code for a (semi-)permanent access token

Parameters:

code - 'code' field from query string passed to your redirect_uri page

redirectUrl - Where user went after logging in at WePay (must match value from getAuthorizationUri)

Returns:

json {"user_id":"123456","access_token":"1337h4x0rzabcd12345","token_type":"BEARER"}

Throws:

IOException

WePayException

execute

public <T> T execute(String token,
            WePayRequest<T> req)
          throws IOException,
                 WePayException

Make API calls against authenticated user. Turn up logging to trace level to see the request / response.

Throws:

IOException

WePayException