Skip to content

Latest commit

 

History

History
173 lines (137 loc) · 10.6 KB

README_JA.md

File metadata and controls

173 lines (137 loc) · 10.6 KB
Raw

 for JAVA

English Maven Central Javadocs License Gitter

Build Status Coveralls codecov Codacy Badge CodeFactor Maintainability Technical Debt

「Sbpayment for JAVA」は、SB-Payment ServiceのAPIタイプをJAVAを利用して、簡単に使用できます。 サービス仕様書はSBPaymentサイトで確認できるし、こちらでは現在下記の決済機能を提供しています。

  • クレジットカード決済
  • Pay-Easy決済

前提条件

  • Java JDK 8以上
  • Sbpaymentのアカウント情報

インストール

リリースは「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>

モジュール

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

プロジェクトソースからのビルド

ルートディレクトリで ./gradlew build -x integTestを実行してください。 統合テストをしたい場合は、Sbpayment情報を設定する必要があります。

テストプロパティの作成

  • it1.propertiesとit2.propertiesを/configのディレクトリへ作成.
  • it1.propertiesはSBペイメント（API・自動）のアカウント情報を作成。
  • it2.propertiesはSBペイメント（API・指定）のアカウント情報を作成。

※　SBペイメントのアカウント情報は自分のアカウントを利用してください。

プロパティの情報

項目 説明 デフォルト
sbpayment.charset SBペイメントのキャリクタセット Shift_JIS
sbpayment.timeZone SBペイメントのタイムゾーン JST
sbpayment.apiUrl SBペイメントのAPIサビースの接続先
sbpayment.merchantId SBペイメントから取得したマーチャントID
sbpayment.serviceId SBペイメントから取得したサービスID
sbpayment.basicAuthId SBペイメントのベーシック認証ID
sbpayment.basicAuthPassword SBペイメントのベーシック認証パスワード
sbpayment.allowableSecondOnRequest リクエスト時の許容時間(秒) 600
sbpayment.hashKey ハッシュキー
sbpayment.cipherEnabled 3DES 暗号化使用可否 FALSE
sbpayment.desKey 3DES 暗号化キー
sbpayment.desInitKey 3DES 初期化キー

開発サンプル

API

クレジットカード

インターフェース: CreditCardPayment

リクエストID メッソド 説明
ST01-00131-101 authorize 決済要求（トークン、保存カード）
ST01-00111-101 authorize 決済要求（クレジットカード情報）*
ST01-00133-101 reauthorize 再与信要求
ST02-00101-101 commit 確定要求
ST02-00201-101 capture 売上確定要求
ST02-00303-101 cancel 取消要求
ST02-00303-101 refund 返金要求（取消要求と統合）
ST02-00307-101 refund 部分返金要求
MG01-00101-101 lookup 決済結果参照
MG02-00131-101 saveCard クレジットカード情報を保存（トークン）
MG02-00101-101 saveCard クレジットカード情報を保存（クレジットカード情報）*
MG02-00132-101 updateCard クレジットカード情報を更新（トークン）
MG02-00102-101 updateCard クレジットカード情報を更新（クレジットカード情報）*
MG02-00103-101 deleteCard クレジットカード情報を削除
MG02-00104-101 lookupCard クレジットカード情報を参照
  • *決済要求：本サビスは本番環境では使わないでください、実際sbpaymentのAPIから削除されました。

ペイジー

See Interface: PayEasyPayment

リクエストID メッソド 説明
ST01-00101-703 payment 決済要求
NT01-00103-703 receiveDeposit 入金通知受信
successDeposit 入金通知の成功結果を返す
failDeposit 入金通知の失敗結果を返す
NT01-00104-703 receiveExpiredCancel 支払期限切れキャンセル通知信
successExpiredCancel 支払期限切れキャンセル通の成功結果を返す
failExpiredCancel 支払期限切れキャンセル通の失敗結果を返す

サポート

GitHub issues Gitter

サポートはGitHubのIssueシステムとGitterチャットを使用します

貢献

このプロジェクトを手助けしたいですか？プルリクエストを送信してください。

ライセンス

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.