Developer/接続方式/リンク型/リンク型 継続課金(定期・従量)申込要求

リンク型 継続課金(定期・従量)申込要求

提供機能のインターフェース項目定義は以下のとおりです。

機能 IDD01-1
処理名継続課金(定期・従量)申込要求
流れ加盟店→当社
接続先サービス開始時ご案内
送信メソッドForm POST
送信文字コードShift-JIS, html / text

(型の凡例 X:シングルバイト文字型 M:ダブルバイト混在文字型 9:数値型)
※使用できる文字の詳細は、基本仕様 使用可能なデータ型の定義 を参照ください。

SEQ タグエレメント名 項目名 桁数 必須 タイプ 設定内容 備考
1pay_method支払方法1000X可変docomo:d 払い(キャリア・ウォレット)
auone:au かんたん決済
softbank2:ソフトバンクまとめて支払いB
rakuten: 楽天ペイ(オンライン決済)
rakutenv2:楽天ペイ V2(オンライン決済)
recruit:リクルートかんたん支払い
paypay:PayPay(オンライン決済)
省略された場合は ASP 画面にて選択、複数指定時はカンマ区切りで指定
支払方法を指定します。(複数指定可)
※サービスタイプが
「1:解約」または「2:再申込」または「3:特殊連携」
の場合、必須指定
※複数指定時はカンマ区切りでご指定ください。
2merchant_idマーチャント ID59固定加盟店を識別する ID当社で指定します。
3service_idサービス ID39固定加盟店のサービスを識別する ID当社で指定します。
4cust_code顧客 ID64X可変加盟店にて管理されている顧客 IDマーチャント ID とサービス ID の組み合わせに対してユニーク(一意)な値としてください。
決済情報保管時の紐付けキーとなるため、必ず顧客別に払い出してください。
5order_id購入 ID38X可変加盟店にて管理されている購入 IDマーチャントID とサービスID の組み合わせに対してユニーク(一意)な値としてください。
6item_id商品 ID32X可変加盟店にて管理されている商品 ID 
7item_name商品名称40M  可変任意の商品名日本語、英数半角混在可能です。
文字数オーバー時は切捨します。文字化け時は「?」に置換します。
※設定されない場合は、確認画面において商品名の項目自体が表示されません。
8service_typeサービスタイプ19固定0:申込
1:解約
2:再申込
3:特殊連携
4:ユーザーアカウントリンク
「2:再申込」は au かんたん決済のみ指定可能
「3:特殊連携」「4:ユーザーアカウントリンク」は PayPay(オンライン決済)のみ指定可能
「4:ユーザーアカウントリンク」を設定すると、PayPay アプリがインストールされたスマートフォンから継続課金(定期・従量)の申込を頂く際、PayPay アプリが自動的に立ち上がり、アプリでの申込となります
※「3:特殊連携」はサービス提供開始前のためご利用になれません
9tracking_idトラッキング ID14X可変申込時に SBPS が払出す IDサービスタイプが「1:解約」または「2:再申込」時のみ指定可で、必須
10terminal_type顧客利用端末タイプ19  固定0:PC 1:モバイル省略の場合”0″を適用します。
※詳細は基本仕様 要求の端末タイプの設定をご参照ください。 
11success_url登録完了時 URL500X可変画面戻り先 URL  
12cancel_url登録キャンセル時 URL500X可変画面戻り先 URL  
13error_url登録エラー時 URL500X可変画面戻り先 URL  
14pagecon_url登録通知先 CGI500X可変結果通知先 URLSSL 通信必須
15free1自由欄120M  可変  日本語、英数半角混在可能です。
文字数オーバー時は切捨します。文字化け時は「?」に置換します。
16free2自由欄220M  可変  日本語、英数半角混在可能です。
文字数オーバー時は切捨します。文字化け時は「?」に置換します。
17free3自由欄320M  可変  日本語、英数半角混在可能です。
文字数オーバー時は切捨します。文字化け時は「?」に置換します。
18request_dateリクエスト日時149固定YYYYMMDDHHMISS本機能を加盟店がリクエストした日時です。
19limit_secondリクエスト許容時間49  可変リクエスト有効期限秒数を設定省略時は規定値(600)を適用します。
20sps_hashcodeチェックサム40X固定電文の値に対するチェックサム基本仕様 チェックサム値の生成方法について
をご参照ください。
機能 IDD02-1
処理名継続課金(定期・従量)申込結果 CGI
流れ当社→加盟店
接続先指定された URL(結果通知用 CGI)
送信メソッドForm POST
送信文字コードShift-JIS

(型の凡例 X:シングルバイト文字型 M:ダブルバイト混在文字型 9:数値型)
※使用できる文字の詳細は、基本仕様 使用可能なデータ型の定義 を参照ください。

SEQ タグエレメント名 項目名 桁数 必須 タイプ 設定内容 備考
1pay_method支払方法1000X  可変リクエスト時の内容  
2merchant_idマーチャント ID59固定  
3service_idサービス ID39固定  
4cust_code顧客 ID64X可変  
5order_id購入 ID38X可変  
6item_id商品 ID32X可変  
7item_name商品名称40M  可変  
8service_typeサービスタイプ19固定  
9tracking_idトラッキング ID14X  固定  
10terminal_type顧客利用端末タイプ19  固定  
11free1自由欄120M  可変  
12free2自由欄220M  可変  
13free3自由欄320M  可変  
14request_dateリクエスト日時149固定  
結果返却時にセットされる項目
15res_pay_method処理結果 支払方法20X可変  申込時に選択された支払方法です。
16res_result処理結果ステータス2X固定OK:要求処理 OK
NG:要求 NG
  
17res_tracking_id処理トラッキング ID14X固定申込時に当社が払出すID  
18res_payinfo_key顧客決済情報32X  可変顧客決済情報処理結果ステータスが OK の場合のみ、返却します。
au かんたん支払い:OpenID の MD5 値
d 払い(キャリア・ウォレット):OpenID の MD5 値
ソフトバンクまとめて支払い:中間 ID の MD5 値
楽天ペイ(オンライン決済):中間 ID の MD5 値
楽天ペイ(オンライン決済)V2:OpenID の MD5 値
リクルートかんたん支払い:認証番号の MD5 値
PayPay(オンライン決済):userAuthorizationId の MD5 値
19res_payment_date完了処理日時149  可変YYYYMMDDHHMISS処理結果ステータス OK の場合、外部決済期間の処理日時となります。
処理結果ステータス NG の場合、処理日時が無い場合があります。
20res_err_codeエラーコード4X  可変エラーコード一覧参照  
21res_dateレスポンス日時149可変YYYYMMDDHHMISS当社がレスポンスした日時です。
22limit_secondレスポンス許容時間49可変リクエスト時の許容時間省略時は規定値(600)を適用します。
23sps_hashcodeチェックサム40X固定電文の値に対する
チェックサム
基本仕様 チェックサム値の生成方法について
をご参照ください。
機能 IDD02-2
処理名継続課金(定期・従量)申込結果 CGI
流れレスポンス加盟店→当社
接続先継続課金(定期・従量)申込結果 CGI の通知元
送信メソッドHTTP POST
送信文字コードShift-JIS, text / csv

(型の凡例 X:シングルバイト文字型 M:ダブルバイト混在文字型 9:数値型)
※使用できる文字の詳細は、基本仕様 使用可能なデータ型の定義 を参照ください。

SEQ項目名桁数必須設定内容備考
1処理結果2XOK/NG加盟店様側での処理結果
※結果 CGI の「res_result」が NG の場合には必ず OK を返却してください
2エラーメッセージ100M 加盟店様側でエラーと
なった時のメッセージ
処理「OK」の時は不要
※詳細仕様は、リンク型 基本仕様を参照ください。
機能 IDD03-1
処理名継続課金(定期・従量)申込結果(画面返却)
流れ当社→加盟店
接続先指定された URL(完了)
送信メソッドForm POST
送信文字コードShift-JIS, html / text

(型の凡例 X:シングルバイト文字型 M:ダブルバイト混在文字型 9:数値型)
※使用できる文字の詳細は、基本仕様 使用可能なデータ型の定義 を参照ください。

SEQ タグエレメント名 項目名 桁数 必須 タイプ 設定内容 備考
1pay_method支払方法1000X  可変リクエスト時の内容  
2merchant_idマーチャント ID59固定  
3service_idサービス ID39固定  
4cust_code顧客 ID64X可変  
5order_id購入 ID38X可変  
6item_id商品 ID32X可変  
7item_name商品名称40M  可変  
8service_typeサービスタイプ19固定  
9tracking_idトラッキング ID14X  固定  
10terminal_type顧客利用端末タイプ19  固定  
11free1自由欄120M  可変  
12free2自由欄220M  可変  
13free3自由欄320M  可変  
14request_dateリクエスト日時149固定  
結果返却時にセットされる項目
15res_pay_method処理結果 支払方法20X可変  申込時に選択された支払方法です。
16res_result処理結果ステータス2X固定OK:要求処理 OK
NG:要求 NG
  
17res_tracking_id処理トラッキング ID14X固定申込時に当社が払出すID  
18res_payinfo_key顧客決済情報32X  可変顧客決済情報処理結果ステータスが OK の場合のみ、返却します。
au かんたん支払い:OpenID の MD5 値
d 払い(キャリア・ウォレット):OpenID の MD5 値
ソフトバンクまとめて支払い:中間 ID の MD5 値
楽天ペイ(オンライン決済):中間 ID の MD5 値
楽天ペイ(オンライン決済)V2:OpenID の MD5 値
リクルートかんたん支払い:認証番号の MD5 値
PayPay(オンライン決済):userAuthorizationId の MD5 値
19res_payment_date完了処理日時149  可変YYYYMMDDHHMISS処理結果ステータス OK の場合、外部決済期間の処理日時となります。
処理結果ステータス NG の場合、処理日時が無い場合があります。
20res_err_codeエラーコード4X  可変エラーコード一覧参照  
21res_dateレスポンス日時149可変YYYYMMDDHHMISS当社がレスポンスした日時です。
22limit_secondレスポンス許容時間49可変リクエスト時の許容時間省略時は規定値(600)を適用します。
23sps_hashcodeチェックサム40X固定電文の値に対する
チェックサム
基本仕様 チェックサム値の生成方法について
をご参照ください。
このページは役に立ちましたか?