Official shurjoPay Java plugin for merchants or service providers to connect with shurjoPay Payment Gateway v2.1 developed and maintained by ShurjoMukhi Limited.

This plugin can be used with any java application or framework (e.g. Spring). Also it makes easy for developers to integrate with shurjoPay v2.1 with calling three methods only:

1. makePayment: create and send payment request
2. verifyPayment: verify payment status at shurjoPay
3. paymentStatus: Check payment details and status

Also reduces many of the things that you had to do manually:

• Handles http requests and errors.
• JSON serialization and deserialization.
• Authentication during initiating and verifying of payments.

This document is intended for the technical personnel of merchants and service providers who wants to integrate our online payment gateway using java plugin provided by shurjoMukhi Limited.

To integrate the shurjoPay Payment Gateway in your Java project do the following tasks sequentially.

Maven

<dependency>
    <groupId>bd.com.shurjomukhi</groupId>
    <artifactId>sp-plugin-java</artifactId>
    <version>0.1.0</version>
</dependency>

Gradle

implementation 'bd.com.shurjomukhi:sp-plugin-java:0.1.0'

Download Jar
Go to Maven central and download the latest version.

Attention: shurjoMukhi offers separate plugin to integrate with any Spring Application.

Properties file contains four fields SP_USER, SP_PASS, SHURJOPAY_API, SP_CALLBACK to configure shurjoPay. Configure logging using these params SPLOG_PATH, SPLOG_FILE.

#merchant username and password provided by shurjoPay author
SP_USER = <merchant_username>
SP_PASS = <merchant_password>

#shurjoPay API's base path for sandbox
SHURJOPAY_API = https://sandbox.shurjopayment.com/api

#callback URL is used for cancel payment or success payment
SP_CALLBACK = https://sandbox.shurjopayment.com/response

#shurjoPay plug-in log file location
SPLOG_PATH= /var/log
SPLOG_FILE = sp-java-plugin.log

• See and copy this ready shurjopay.properties.
• Add logback-classic dependency in your application to get log messages generated by this plugin to track shurjoPay errors only (optional).

   // Initialize shurjopay
   Shurjopay shurjopay = new Shurjopay();

   // Prepare payment request to initiate payment
   PaymentReq request = new PaymentReq();
   request.setPrefix("sp");
   request.setAmount(10.00);
   request.setCustomerOrderId("sp315689");
   request.setCurrency("BDT");
   request.setCustomerName("Dummy");
   request.setCustomerAddress("Dhaka");
   request.setCustomerPhone("01766666666");
   request.setCustomerCity("Dhaka");
   request.setCustomerPostCode("1212");
   request.setCustomerEmail("[email protected]");

   // Calls first method to initiate a payment
   shurjopay.makePayment(request);

• Returns PaymentRes corresponding this JSON

   shurjopay.verifyPayment(:=spTxnId)

• Returns VerifiedPayment corresponding this JSON

Run the JUnit test to see shurjopay plugin in action. These tests will run on selenium browser and will provide the complete experience. Just download source and run the command mvnw.cmd test in Windows and ./mvnw test in Linux from plugin root path.

1. Spring example application and Java example application showing usage of the java plugin.
2. Sample applications and projects in many different languages and frameworks showing shurjopay integration.
3. shurjoPay Postman site illustrating the request and response flow using the sandbox system.
4. shurjopay Plugins home page on github

This code is under the MIT open source License.