Markdownをコピー
d払い（継続課金）課金ファイル仕様
概要
d払い継続課金では、当サービスから加盟店様へ日次で課金ファイル、申込状況ファイルを送信します。
送信先はショップ管理画面の「メニュー ＞ 継続決済 ＞ docomo継続課金 ＞ 設定」にて設定します。
各ファイルは12:00までに加盟店様へ送信します。
ただしメンテナンスや障害発生時には遅延する可能性があります。
検証環境では12:00以降にファイルが送信されます。
加盟店様からの正常応答が確認できなかった場合は、60秒ごとに5回再送します。
注意事項
結果通知プログラムにおいて、決済結果をHTTPS通信で受け取る場合は、第三者が発行したSSLサーバ証明書が必要です。
弊社で動作保証をしている電子証明書は以下の通りです。
- ベリサイン
- GlobalSign
- 日本ジオトラスト
※上記以外の電子証明書を使用する場合は、必ずテスト環境で疎通確認を行ってください。
日次課金ファイル
ファイル概要
対象データがある場合のみ、ファイル作成前日にドコモで処理された課金データの処理結果を日次でショップID単位に作成します。
ファイル出力対象
日次課金ファイルに出力される決済情報は以下の条件です。
- ファイル作成前日にドコモセンターで確定・変更・取消された課金データ
ファイル情報
日次課金ファイルは、ヘッダ／データ（課金データ件数分）／フッタの3種類のレコード構成です。
出力パラメータ（当サービス ⇒ 加盟店様）
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| fileContents | 必須 | ファイル | 日次課金ファイルを返却します。 ※文字コードはUTF-8 |
■ファイル情報
| 項目 | 内容 |
|---|---|
| ファイル名 | "C_" + ショップID + "_" + 処理日(yyyymmdd) + ランダムの数字※ + ".csv"例： C_9999999999999_2022091663419.csv※ランダムの数字： 0～9223372036854775807の範囲 |
| 区切り文字 | 半角カンマ（,） |
| 改行コード | CRLF |
| ソート順 | オーダーID、課金月の昇順 |
| 囲み文字 | ダブルクォート（"） |
■ヘッダレコード
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| レコード区分 | 必須 | 半角英字2桁 | "HD"固定 |
| ショップID | 必須 | 半角英数13桁 | ショップIDを設定 |
| データレコード件数 | 必須 | 半角数字8桁 | データレコードの件数 |
■データレコード
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| ショップID | 必須 | 半角英数13桁 | |
| オーダーID | 必須 | 半角英数記号27桁 | |
| 課金月 | 必須 | 半角数字6桁 | yyyyMM形式で返却 |
| 取引状態 | 必須 | 半角英字15桁 | SALES：課金済み / CANCEL：キャンセル / INVALID：無効 |
| 利用金額 | 必須 | 半角数字6桁 | |
| 税送料 | 必須 | 半角数字6桁 | |
| キャンセル金額 | 半角数字6桁 | ||
| キャンセル税送料 | 半角数字6桁 | ||
| 取引ID | 必須 | 半角英数32桁 | |
| 取引パスワード | 必須 | 半角英数32桁 | |
| ドコモ課金番号 | 必須 | 半角数字18桁 | |
| ドコモ加盟店注文番号 | 必須 | 半角数字20桁 | |
| 処理期限 | 必須 | 半角数字14桁 | yyyyMMddHHmmss形式 |
| エラーコード | 半角英数3桁 | ||
| エラー詳細コード | 半角英数9桁 | ||
| 処理日時 | 必須 | 半角数字14桁 | yyyyMMddHHmmss形式 |
■フッタレコード
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| レコード区分 | 必須 | 半角英字2桁 | "FT"固定 |
入力パラメータ（加盟店様 ⇒ 当サービス）
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| RecvRes | 必須 | 半角数字1桁 | 受信結果0：受信OK / 1：受信失敗 |
申込状況ファイル
ファイル概要
当月有効な継続課金申込みデータを日次でショップID単位に作成します。
ファイル出力対象
申込状況ファイルに出力される決済情報は以下の条件です。
- 契約中の申込みデータ
- 当月末で解約となる申込みデータ
ファイル情報
申込状況ファイルも、ヘッダ／データ（課金データ件数分）／フッタの3種類のレコード構成です。
出力パラメータ（当サービス ⇒ 加盟店様）
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| fileContents | 必須 | ファイル | 申込状況ファイルを返却します。 ※文字コードはUTF-8 |
■ファイル情報
| 項目 | 内容 |
|---|---|
| ファイル名 | "R_" + ショップID + "_" + 処理日(yyyymmdd) + ランダムの数字※ + ".csv"例： R_9999999999999_2022091663419.csv※ランダムの数字： 0～9223372036854775807の範囲 |
| 区切り文字 | 半角カンマ（,） |
| 改行コード | CRLF |
| ソート順 | オーダーID、課金月の昇順 |
| 囲み文字 | ダブルクォート（"） |
■ヘッダレコード
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| レコード区分 | 必須 | 半角英字2桁 | "HD"固定 |
| ショップID | 必須 | 半角英数13桁 | ショップIDを設定 |
| データレコード件数 | 必須 | 半角数字8桁 | データレコードの件数 |
■データレコード
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| ショップID | 必須 | 半角英数13桁 | |
| オーダーID | 必須 | 半角英数記号27桁 | |
| 取引状態 | 必須 | 半角英字15桁 | REGISTER：契約中 / RUN-CHANGE：変更処理中 / RUN-END：契約終了処理中 / END：契約終了 |
| 利用金額 | 必須 | 半角数字6桁 | |
| 税送料 | 必須 | 半角数字6桁 | |
| 変更利用金額 | 半角数字6桁 | ||
| 変更税送料 | 半角数字6桁 | ||
| ドコモ表示項目1 | 全半角40バイト | ||
| ドコモ表示項目2 | 全半角40バイト | ||
| ドコモ決済番号 | 必須 | 半角数字12桁 | |
| 加盟店自由項目1 | 全半角100バイト | ||
| 加盟店自由項目2 | 全半角100バイト | ||
| 加盟店自由項目3 | 全半角100バイト | ||
| 取引ID | 必須 | 半角英数32桁 | |
| 取引パスワード | 必須 | 半角英数32桁 | |
| ドコモ加盟店注文番号 | 必須 | 半角数字20桁 | |
| ドコモ端末区分 | 必須 | 半角英字2桁 | SP：SPモード |
| Wi-fiテザリング接続 | 必須 | 半角数字1桁 | お客様のWi-fiテザリング接続状況を返却します。0：Wi-fiテザリング接続なし / 1：Wi-fiテザリング接続あり |
| 確定基準日 | 必須 | 半角数字2桁 | |
| 初月無料フラグ | 必須 | 半角数字1桁 | 0：初月有料 / 1：初月無料 |
| 終了月無料フラグ | 半角数字1桁 | 0：終了月有料 / 1：終了月無料 | |
| 継続課金終了日 | 半角数字14桁 | yyyyMMddHHmmss形式 | |
| エラーコード | 半角英数3桁 | ||
| エラー詳細コード | 半角英数9桁 | ||
| 処理日時 | 必須 | 半角数字14桁 | yyyyMMddHHmmss形式 |
■フッタレコード
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| レコード区分 | 必須 | 半角英字2桁 | "FT"固定 |
入力パラメータ（加盟店様 ⇒ 当サービス）
| 項目 | 必須 | 型 | 内容 |
|---|---|---|---|
| RecvRes | 必須 | 半角数字1桁 | 受信結果0：受信OK / 1：受信失敗 |