_{for JAVA}

Sbpayment for JAVA makes it easy to use the API type of SB-Payment Service using JAVA.

Service specifications can be confirmed on the SBPayment site, and it currently offer the following payment features.

• Credit Card
• Pay-Easy

Prerequisites

• Java JDK 8 or higher
• Sbpayment Service Account

Getting Started

Releases are published to maven central

Gradle:

dependencies {
    // creditcard
    implementation 'com.vogle.sbpayment:sbpayment-creditcard:1.+'
    // payeasy
    implementation 'com.vogle.sbpayment:sbpayment-payeasy:1.+'
    // if you use spring boot
    implementation 'com.vogle.sbpayment:sbpayment-spring-boot-starter:1.+'
}

Maven:

<dependencies>
  <!--creditcard-->
  <dependency>
    <groupId>com.vogle.sbpayment</groupId>
    <artifactId>sbpayment-creditcard</artifactId>
    <version>1.0.0</version>
  </dependency>
  <!--payeasy-->
  <dependency>
    <groupId>com.vogle.sbpayment</groupId>
    <artifactId>sbpayment-payeasy</artifactId>
    <version>1.0.0</version>
  </dependency>
  <!--if you use spring boot-->
    <dependency>
      <groupId>com.vogle.sbpayment</groupId>
      <artifactId>sbpayment-spring-boot-starter</artifactId>
      <version>1.0.0</version>
    </dependency>
</dependencies>

Modules

Module	Maven Central	JavaDoc	@since
Client
Credit Card
Pay-Easy
Spring Boot Starter

Building from Source

Execute ./gradlew build -x integTest in the root directory. If you want to integTest, You have to setup Sbpayment information

Setup Sbpayment information

• Create it1.properties and it2.properties in a directory with the path '/ config'.
• it1.properties is Sbpayment information with API-Automatic
• it2.properties is Sbpayment information with API-Specified

※ Use your own account for SB Payment account information.

Properties

Items	Description	Default
sbpayment.charset	Character code of SB-Payment	Shift_JIS
sbpayment.timeZone	Timezone of SB-Payment	JST
sbpayment.apiUrl	API Service URL
sbpayment.merchantId	Merchant ID of SB-Payment
sbpayment.serviceId	Service ID of SB-Payment
sbpayment.basicAuthId	Basic authentication ID
sbpayment.basicAuthPassword	Basic authentication password
sbpayment.allowableSecondOnRequest	Allowable time for request (seconds)	600
sbpayment.hashKey	Hash Key
sbpayment.cipherEnabled	3DES Encryption availability	FALSE
sbpayment.desKey	3DES Encryption key
sbpayment.desInitKey	3DES Initialization key

Development Sample

• Use Spring-Boot: See sbpayment-sample-spring-boot
• General Web Application: See sbpayment-sample-webapp

API

Credit-Card

See Interface: CreditCardPayment

API-Request ID	Method	Description
ST01-00131-101	authorize	Authorize by token or saved card
ST01-00111-101	authorize	Authorize by credit-card*
ST01-00133-101	reauthorize	Reauthorize by tracking information
ST02-00101-101	commit	Commit
ST02-00201-101	capture	Capture payment
ST02-00303-101	cancel	Cancel payment
ST02-00303-101	refund	It was integrated with Cancel
ST02-00307-101	refund	Refund with amount
MG01-00101-101	lookup	Lookup transaction
MG02-00131-101	saveCard	Save card by token
MG02-00101-101	saveCard	Save card by credit-card*
MG02-00132-101	updateCard	Update card by token
MG02-00102-101	updateCard	Update card by credit-card*
MG02-00103-101	deleteCard	Delete card
MG02-00104-101	lookupCard	Lookup card

• *Don't use in production environment, indeed it has been removed from Sbpayment API.

Pay-Easy

See Interface: PayEasyPayment

API-Request ID	Method	Description
ST01-00101-703	payment	Payment by PayEasy
NT01-00103-703	receiveDeposit	Receive a deposit notification
	successDeposit	Return successful result of deposit notification
	failDeposit	Return failure result of deposit notification
NT01-00104-703	receiveExpiredCancel	Receive a expired cancel notice
	successExpiredCancel	Return successful result of cancellation due date expired
	failExpiredCancel	Return failure result of cancellation due date expired

Support

The project uses GitHub’s integrated issue tracking system and Gitter Community

Contributions

Contributions to the project can be done using pull requests. You will be asked to sign a contribution agreement after creating the first one.

License

Copyright 2019 Vogle Labs.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.