Markdownをコピー
ソフトバンクまとめて支払い（継続決済）課金ファイル仕様
概要
ソフトバンクまとめて支払い（継続決済）では、当サービスから加盟店様へ課金ファイルを送信します。
月初（課金要求）、また課金日当日（課金確定）にソフトバンクセンターで処理された結果をショップID単位で作成します。
送信先は当サービスショップ管理画面の、メニュー「継続決済」＞「ソフトバンク継続課金」＞「設定」にて設定します。
それぞれのファイルは処理当日内に加盟店様へ送信します。ただしメンテナンスや障害発生時には遅延する可能性があります。
加盟店様側からの正常応答が確認できなかった場合は60分おきに5回再送します。
注意事項
結果通知プログラムにおいて、決済結果をHTTPS通信で受け取る場合は、第三者が発行したSSLサーバ証明書が必要です。
弊社で動作保証をしている電子証明書は以下の通りです。
- ベリサイン
- GlobalSign
- 日本ジオトラスト
※上記以外の電子証明書を使用する場合は、必ずテスト環境で疎通確認を行ってください。
課金結果ファイル
ファイル出力対象
課金要求結果ファイルに出力される情報は以下の通りです。
- 月初に、当月の課金対象に対し課金要求を行った結果データ
- 課金要求が成功または失敗の課金データ
課金確定結果ファイルに出力される情報は以下の通りです。
- 課金日当日に、当月の課金要求が成功したデータに対し課金確定を行った結果データ
- 課金確定が成功または失敗の課金データ
ファイル情報
課金確定結果ファイルは、ヘッダ／データ（課金データ件数分）／フッタの3種類のレコード構成です。
出力パラメータ（当サービス ⇒ 加盟店様）
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| fileContents | ✔ | ファイル | 課金要求結果ファイル、または課金確定結果ファイルを返却します。 |
■ファイル情報
| 項目 | 内容 |
|---|---|
| ファイル名 | 【課金要求結果ファイル】 "SB_A_" + ショップID + "_" + 課金要求日(yyyymmdd) + "_" + [0-9] + ".csv"例： SB_A_tshop99999999_20151001_5957685870812785188.csv【課金確定結果ファイル】 "SB_S_" + ショップID + "_" + 課金確定日(yyyymmdd) + "_" + [0-9] + ".csv"例： SB_S_tshop99999999_20151031_150863765215807927.csv |
| 区切り文字 | 半角カンマ（,） |
| 改行コード | CRLF |
| ソート順 | オーダーIDの昇順 |
| 囲み文字 | ダブルクォート（"） |
■ヘッダレコード
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| レコード区分 | ✔ | 半角英字2桁 | "HD"固定 |
| ショップID | ✔ | 半角英数13桁 | ショップID |
| データレコード件数 | ✔ | 半角数字8桁 | データレコードの件数 |
■データレコード
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| ショップID | ✔ | 半角英数13桁 | |
| オーダーID | ✔ | 半角英数記号27桁 | |
| 課金日 | ✔ | 半角数字6桁 | 課金日をyyyyMMdd書式で返却します。 |
| 取引状態 | ✔ | 半角英字15桁 | 取引状態を返却します。AUTH：課金要求済みAUTHFAIL：課金要求失敗SALES：課金済みFAILED：課金失敗 |
| 利用金額 | ✔ | 半角数字6桁 | |
| 税送料 | ✔ | 半角数字6桁 | |
| ソフトバンク処理トラッキングID | 半角数字14桁 | ||
| エラーコード | 半角英数3桁 | ||
| エラー詳細コード | 半角英数9桁 | ||
| 処理日時 | ✔ | 半角数字14桁 | 処理日時をyyyyMMddHHmmss書式で返却します。 |
■フッタレコード
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| レコード区分 | ✔ | 半角英字2桁 | "FT"固定 |
入力パラメータ（加盟店様 ⇒ 当サービス）
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| RecvRes | ✔ | 半角数字1桁 | 受信結果0：受信OK / 1：受信失敗 |