This Java library contains classes that allows you to do payments and call other methods of YooMoney public API.
The library uses:
- OkHttp 3.10.0
- Google GSON 2.8.4
To use the library in your project write this code to your build.gradle:
buildscript {
repositories {
jcenter()
}
}
dependencies {
compile 'com.yoo.money.api:yoomoney-sdk-java:7.2.23'
}To be able to use the library you: the first thing you need to do is to register your application and get your unique client id. To do that please follow the steps described on this page (also available in Russian).
All API methods are represented as classes in package com.yoo.money.api.methods.
Some methods require an unique id to get the response. To get it use API method instance-id passing your client id.
Once obtained instance id can be used to perform those methods.
Do NOT request instance id every time you need to call an API method. Obtain it once, store it safely and reuse it in future requests.
To perform request from com.yoo.money.api.methods package you will need to use ApiClient. For your convenience
there is default implementation of the ApiClient called DefaultApiClient. It is suitable for most cases. So the
very first thing you need to do, is to create ApiClient.
The minimal implementation will look like this:
ApiClient client = new DefaultApiClient.Builder()
.setClientId("your_client_id_here")
.create();If you want to perform a method that requires user's authentication you need request access token. The easiest way to
do this is to get AuthorizationData from a client:
AuthorizationParameters parameters = new AuthorizationParameters.Builder()
...
.create();
AuthorizationData data = client.createAuthorizationData(parameters);Provided AuthorizationParameters allows you to set request parameters as described here. When created
AuthorizationData will have URL and POST parameters for OAuth2 authorization.
To get the result from redirect uri you may want to use AuthorizationCodeResponse.parse(redirectUri) method. If
successful the instance of AuthorizationCodeResponse will contain temporary authorization code that must be
immediately exchanged for an access token:
// parse redirect uri from web browser
AuthorizationCodeResponse response = AuthorizationCodeResponse.parse(redirectUri);
if (response.error == null) {
// try to get OAuth2 access token
Token token = client.execute(new Token.Request(response.code, client.getClientId(), myRedirectUri, myClientSecret));
if (token.error == null) {
... // store token.accessToken safely for future uses
// and authorize client to perform methods that require user's authentication
client.setAccessToken(token.accessToken);
} else {
handleAuthorizationError(token.error);
}
} else {
handleAuthorizationError(response.error);
}Now you can perform any request with authorized client. For instance, if you want to get InstanceId you can do it like
this:
InstanceId instanceId = client.execute(new InstanceId.Request(clientId));
// do something with instance id- YooMoney API (in English, in Russian)
- YooMoney Java SDK on Bintray
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent