Skip to content

vogle/sbpayment-java

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

 for JAVA

Japanese Maven Central Javadocs License Gitter

Build Status Coveralls codecov Codacy Badge CodeFactor Maintainability Technical Debt

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 Maven Central Javadocs @since v1.0
Credit Card Maven Central Javadocs @since v1.0
Pay-Easy Maven Central Javadocs @since v1.0
Spring Boot Starter Maven Central Javadocs @since v1.0

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

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

GitHub issues Gitter

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

License FOSSA Status

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.