liqpay / sdk-java

LiqPay JAVA sdk

liqpay.ua API SDK for Java

liqpay.ua is payment system associated with PrivatBank.

API Documentation in Ukrainian and in English

WARNING: This SDK is not thread safe. We would be very appreciated for your contribution.

Installation and usage

This library is published at GitHub and can be added as Maven dependency.

Use as Maven dependency

Add to your pom.xml repository and dependency:

<repositories>
        <repository>
            <id>repository</id>
            <url>https://github.com/liqpay/sdk-java/raw/repository</url>
            <snapshots>
                <enabled>true</enabled>
                <updatePolicy>always</updatePolicy>
            </snapshots>
        </repository>
    </repositories>

<dependency>
            <groupId>com.liqpay</groupId>
            <artifactId>liqpay-sdk</artifactId>
            <version>0.8-SNAPSHOT</version>
  </dependency>

Then you can use it as described in API documentation:

// Creation of the HTML-form
Map params = new HashMap();
params.put("amount", "1.50");
params.put("currency", "USD");
params.put("description", "description text");
params.put("order_id", "order_id_1");   
params.put("sandbox", "1"); // enable the testing environment and card will NOT charged. If not set will be used property isCnbSandbox() 
LiqPay liqpay = new LiqPay(PUBLIC_KEY, PRIVATE_KEY);
String html = liqpay.cnb_form(params);      
System.out.println(html);

It is recommended to use some Inversion of Control (IoC) container, like Spring IoC or PicoContainer.

Use proxy

To use LiqPay with proxy you can initialize it like:

import java.net.InetSocketAddress;
import java.net.Proxy;

...

    Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress("proxy.host.com", 8080);
    LiqPay liqpay = new LiqPay(PUBLIC_KEY, PRIVATE_KEY, proxy, "proxyLogin", "some proxy password");

Grails v2.x

In grails-app/conf/BuildConfig.groovy you should add repository and dependency:

grails.project.dependency.resolution = {
...
    repositories {
        grailsPlugins()
        ...
        mavenRepo 'https://github.com/liqpay/sdk-java/raw/repository'
    }
    dependencies {
        ...
        compile 'com.liqpay:liqpay-sdk:0.8-SNAPSHOT'
    }
...
}

Then you can add LiqPay bean in grails-app/conf/spring/resources.groovy:

import com.liqpay.LiqPay

// Place your Spring DSL code here
beans = {
    liqpay(LiqPay, '${com.liqpay.publicKey}', '${com.liqpay.privateKey}') {
        cnbSandbox = false // set true to enable the testing environment. Card is not charged
    }
}

It will create bean with name liqpay of class com.liqpay.LiqPay and pass to it's constructor public and private keys that defined in grails-app/conf/Config.groovy like this:

com.liqpay.publicKey = 'i31219995456'
com.liqpay.privateKey = '5czJZHmsjNJUiV0tqtBvPVaPJNZDyuoAIIYni68G'

Then you can use this liqpay bean with dependency injection in your services or controllers:

class UserController {
    LiqPayApi liqpay // this will inject liqpay bean defined in resources.groovy  

    def balanceReplenishment() {
        Map<String, String> params = [
                "amount"     : '30.5',
                "currency"   : 'UAH',
                "description": 'Balance replenishmenton on example.com',
                "order_id"   : "1",
                'result_url' : g.createLink(action: 'paymentResult', absolute: true).toString()]
        String button = liqpay.cnb_form(params);
        [button: button]
    }
}

And inside grails-app/views/user/balanceReplenishment.gsp you can output this button like this:

    <div>
        ${raw(button)}
    </div>

Changelog

All releases

v0.1 First Mavenized version.

Source

• Just reformatted code.
• Created some basic tests.
• API wasn't changed and this release can't broke compilation.

v0.2 Improved tests

Source

• Refactoring
• More tests coverage
• Parameter params of methods cnb_form() and api() now can by any Map, not only HashMap.
• API wasn't changed and this release can't broke compilation.

v0.3 Some methods deprecated

Source

• Introduced API interface LiqPayApi
• Deprecated fields that should be constant host_checkout and liqpayApiUrl. They was replaced with private constants.
• Deprecated constructor LiqPay(String publicKey, String privateKey, String liqpayApiUrl) because liqpayApiUrl is constant and can't be rewritten.
• Deprecated method cnb_signature because signature is already calculated inside cnb_form(Map).
• Deprecated shorthand method setProxy(String host, Integer port), you should use full setProxy(String host, Integer port, Proxy.Type) instead. In next release v0.5 it will be deprecated too, and you should construct Proxy instance yourself.
• API wasn't changed and this release can't broke compilation.

v0.4 Last release that API compatible with old lib

Source

• This release is recommended if you used original old lib since it shouldn't break compilation.
• Params version and public_key are always set inside cnb_form() and api() methods.
• Old version of cnb_form() accepted public_key parameter that can be differ from publicKeyinitialized in constructor.
• Methods cnb_form() and api() doesn't add public_key and version to instance of params method. I.e. now you can pass unmodifable map and reuse it without side effects.
• API wasn't changed and this release can't broke compilation.

v0.5 Removed deprecated methods

Source

• Removed deprecated method cnb_signature because signature is already calculated inside cnb_form(Map).
• Method api() now returns general Map instead of concrete HashMap.
• Removed deprecated fields liqpayApiUrl and host_checkout. They replaced with constants LiqPayApi.LIQPAY_API_URL and LiqPayApi.LIQPAY_API_CHECKOUT_URL.
• Introduced two new properties proxyLogin and proxyPassword that should be used instead of deprecated method setProxyUser(login, password).
• Introduced method setProxy(Proxy) that should be used instead of shorthand and deprecated setProxy(host, port, Proxy.Type).
• API was changed in this release and can broke compilation.

v0.6 Enhanced usage

Source

• Created constructor LiqPay(String publicKey, String privateKey, Proxy proxy, String proxyLogin, String proxyPassword) that initialize API with proxy
• Defined new property isCnbSanbox() that can globally set sandbox param in cnb_form() instead of specifying it always in params

v0.7-SNAPSHOT

• Changed url form liqpay.com to liqpay.ua

v0.8-SNAPSHOT

Source

• Changed cnb_form method. New form.

sdk-java's Issues

Unable to download artifact from maven repository

Added dependency as described on main page of this repo

<repositories>
    <repository>
        <id>bintray-stokito-maven</id>
        <name>stokito-maven</name>
        <url>https://api.bintray.com/maven/stokito/maven/liqpay-sdk</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.liqpay</groupId>
    <artifactId>liqpay-sdk</artifactId>
    <version>0.6</version>
</dependency>

When building with Maven get error

[ERROR] Failed to execute goal on project portal: Could not resolve dependencies for pro
ject com.site:portal:war:1.2.2-SNAPSHOT: Failed to collect dependencies at com.liqpa
y:liqpay-sdk:jar:0.6: Failed to read artifact descriptor for com.liqpay:liqpay-sdk:jar:0
.6: Could not transfer artifact com.liqpay:liqpay-sdk:pom:0.6 from/to bintray-stokito-ma
ven (https://api.bintray.com/maven/stokito/maven/liqpay-sdk): Not authorized , ReasonPhr
ase:Unauthorized. -> [Help 1]

Credentials shoul be provided to use this repo

On repository artifact is not available for download. Looks like it is not uploaded to repo or was removed. Please check.
https://bintray.com/stokito/maven/liqpay-sdk/

Incorrect LIQPAY_API_CHECKOUT_URL

Overview

Looks like API was changed and now SDK points to wrong checkout URL.
Steps to reproduce:

1. Generate an HTML-form with cnb_form method for valid P2P request.
2. Open the HTML-form in a browser.
3. Push "Pay".
4. Result:

• Expected result: a payment LiqPay page should be rendered. Example:
  
• Actual result: an error page was rendered:
  

A cause is the invalid checkout URL:

String LIQPAY_API_CHECKOUT_URL = "https://www.liqpay.ua/api/3/checkout";

but that should be:

String LIQPAY_API_CHECKOUT_URL = "https://www.liqpay.ua/api/checkout";

Bug (Ukraine language)

Map params = new HashMap();
        params.put("action", "pay");
        params.put("amount", "1.50");
        params.put("currency", "UAH");
        params.put("order_id", UUID.randomUUID().toString());
        params.put("description", "description text");
        params.put("language", "uk");
        params.put("result_url", "http://localhost:8080");
        params.put("sandbox", "1"); // enable the testing environment and card will NOT charged. If not set will be used property isCnbSandbox()
        LiqPay liqpay = new LiqPay("i39087887787970", "eS3eYIE3ztX1rere9GXryMUqaBdfsezewEnroKp");

Generated URL - //static.liqpay.com/buttons/p1uk.radius.png

404 Not Found

Payment description with Cyrillic letters not displayed correctly in browser

Please change LiqPay.java:116
String data = base64_encode(JSONObject.toJSONString(withSandboxParam(withBasicApiParams(params))));
to this (or provide some control over encoding)
String data = base64_encode(JSONObject.toJSONString(withSandboxParam(withBasicApiParams(params))).getBytes("UTF-8"));

Method not supported in Android

DatatypeConverter method not support in Android, related with jwtk/jjwt#18.
Could you please change realisation in https://github.com/liqpay/sdk-java/blob/master/src/main/java/com/liqpay/LiqPayUtil.java#L27

Нова версія релізу (Перехід на новий домен)

11 місяців тому було змінено адресу API з
https://www.liqpay.com/api/
на
https://www.liqpay.ua/api/, В гільці master зміни виконано.

Проблема полягає в тому, що остання версія (v0.6), яку можна підключити через maven цих змін не включає. Таким чином усі запити далі відбуваються за старою адресою із перенаправленням. Із цим все добре, але з 01.07.2018 автоматичне перенаправлення більше не буде відбуватися.

Отже, з'являється питання: чи потрібно самому завантажувати останню версію коду (master) і робити білд. Чи можливо буде створено нову версію релізу (v0.7)?