JarCasting
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.propertiesandit2.propertiesin a directory with the path '/ config'. it1.propertiesis Sbpayment information with API-Automaticit2.propertiesis 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.
