[C002] リンク型システム仕様書（購入要求）

[C002] リンク型システム仕様書（購入要求）

2023/03/30 版

SB ペイメントサービス株式会社

目次

1. はじめに . – 3 –

2. インターフェース概要 ………………………………………………………………………………………………………………….. – 5 –

   1. 提供機能一覧…………………………………………………………………………………………………………………. – 5 –

   2. 利用例…………………………………………………………………………………………………………………………… – 6 –

   3. 画面遷移図 ………………………………………………………………………………………………………………….. – 10 –

   4. 画面の説明 …………………………………………………………………………………………………………………… – 11 –

3. インターフェース仕様 ………………………………………………………………………………………………………………… – 15 –

   1. 要求項目定義……………………………………………………………………………………………………………….. – 15 –

   2. 結果 CGI 項目定義……………………………………………………………………………………………………….. – 17 –

   3. 結果 CGI レスポンス項目定義……………………………………………………………………………………………. – 21 –

   4. 結果（画面返却）項目定義……………………………………………………………………………………………. – 22 –

   5. その他項目定義……………………………………………………………………………………………………………… – 24 –

4. 個別仕様 …………………………………………………………………………………………………………………………….. – 26 –

   1. Alipay 国際決済における購入要求のタグエレメント「free_csv」について………………………………………… – 26 –

   2. オフライン決済における購入要求のタグエレメント「free_csv」について…………………………………………….. – 29 –

   3. LINE Pay における購入要求のタグエレメント「free_csv」について………………………………………………… – 34 –

   4. リクルートかんたん支払いにおける購入要求のタグエレメント「free_csv」について ……………………………….. – 37 –

   5. NP 後払いにおける購入要求のタグエレメント「free_csv」について………………………………………………… – 39 –

   6. PayPay（オンライン決済）における購入要求のタグエレメント「free_csv」について…………………………… – 41 –

   7. クレジットカード決済（本人認証サービス（EMV 3-D セキュア））における購入要求のタグエレメント「free_csv」について…………………………………………………………………………………………………………………………………… – 43 –

5. 特記事項 …………………………………………………………………………………………………………………………….. – 45 –

6. 更新履歴 …………………………………………………………………………………………………………………………….. – 46 –

1. はじめに

   本書の目的

   本書は、SBペイメントサービス株式会社（以下、当社）が提供するオンライン決済ASPにおいて、リンク型の購入要求を記載した文書です。サービスを利用するにあたり、必ずお読みください。なお、オンライン決済ASPの概要、リンク型のシステム基本仕様（関連文書のA001、C001）を理解された前提の文書となります。

   用語の定義

   本書で使用する用語の定義は、総合仕様書（はじめにお読みください）を参照ください。

   関連文書

   文書 ID	文書名	概要
   A001	総合仕様書（はじめにお読みください）	オンライン決済ASPを初めて検討・利用される方 向けに、オンライン決済ASPの概要、課金方式、売上方式、システム接続方式など、サービスの基本概要を記載した文書
   C001	リンク型システム仕様書（基本仕様）	リンク型の概要、I/Fなどシステム接続に必要な内
   C003	リンク型システム仕様書（顧客決済情報登録要求	容を記載した文書
   	API仕様）
   C004	リンク型システム仕様書（継続課金（定期・従量）
   	申込要求API仕様）
   C005	リンク型システム仕様書（エラーコード一覧）
   C006	リンク型システム仕様書（サンプルコード）
   E003	EMV 3-Dセキュア認証仕様書	カード利用者決済情報トークンの概要、I/Fなどシ ステム接続に必要な内容を記載した文書
   G001	リンク型接続支援サイト利用手引き	リンク型のI/Fテストを実施する接続支援サイトで のテストの流れ、利用方法などに関する説明を記載した文書

   本書の取り扱いについて

   • 本書の一部または全部を改版、引用することを禁じます。

   • 本書を複製し、第三者に配布することを禁じます。

   • 本書は当社が所有する知的財産権に基づいた重要な技術情報を含んでいます。本書に基づいて知的財産権の対象物を成したとき、その権利は、当社に帰属するものとします。

   • 本書は、機密情報として規定される情報の一部を構成します。本書の取り扱いについては十分にご注意ください。

     商標について

   • SoftBank および ソフトバンクの名称、ロゴはソフトバンクグループ株式会社の登録商標となります。

   • SB Payment Service および SBペイメントサービスの名称、ロゴは、SBペイメントサービス株式会社の商標です。

   • その他、記載されている会社名、製品名、ロゴ等は、各社の登録商標または商標です。

2. インターフェース概要

   リンク型の購入要求とは、全決済手段の購入に対応した機能で、都度課金、継続課金（簡易）、継続課金（定期・従量）の購入および継続課金（簡易）の解約に使用する要求です。

   A02-1 などの当社から加盟店へリクエストされる通知内容については、元となる A01-1 などのリクエストパラメータ自体が含まれているため、加盟店側で生成したリクエスト内容と相違がないかを正しく確認した上で、レスポンスを返却ください。

   1. 提供機能一覧

      機能 ID	処理名	流れ	説明
      A01-1	購入要求	加盟店 →当社	都度課金／継続課金（簡易）／継続課金（定期・従量） の購入および継続課金（簡易）の解約を行う。
      A02-1	購入結果CGI	当社 →加盟店	購入、解約の結果を通知する。また、エンドユーザーからの入金 情報、払込票の期限切れ情報、継続課金（簡易）の継続が不可能となった情報を、非同期で通知する。
      A02-2	購入結果CGIレスポンス	加盟店 →当社	結果CGIへの応答を返却する。
      A03-1	購入結果（画面返却）	当社 →加盟店	購入要求の購入または解約の結果を通知します。また、エンド ユーザーの画面を加盟店へ返却します。
      A04-1	確定通知	当社 →加盟店	決済が確定したことを非同期で通知する。 （楽天ペイ（オンライン決済）、NP後払いのみ利用）

      利用イメージ

      

   2. 利用例

      エンドユーザーが決済を行う際の画面遷移および通知タイミングは、以下の３種類があります。

      • 当社の提供画面にのみ遷移するパターン

      • 各決済会社の提供画面にも遷移するパターン

      • 非同期による通知も存在するパターン

        1. 当社の提供画面にのみ遷移するパターン

           決済情報入力から決済完了までの全画面を当社側のみで表示し、完結するパターンです。全画面を当社の標準画面にて提供しますので、統一した画面イメージでのサービス提供が可能です。なお、画面のカスタマイズにより、加盟店のデザインで統一することも可能です。希望の場合は、当社営業までお問い合わせください。

           《対象の決済手段》

           クレジットカード決済 ※1	BitCash決済	JCB PREMO決済
           コンビニ決済	Pay-easy決済	総合振込決済
           Apple Pay	NP後払い

           ※1：クレジットカード決済の本人認証サービス（3Dセキュア）では、クレジットカード会社側のパスワード入力画面が入ります。

           

           [A01-1] 購入要求

           [A02-1] 購入結果 CGI

           [A02-2] 購入結果 CGI レスポンス

           [A03-1] 購入結果(画面返却)

           加盟店 当社 決済会社

           画面

           凡例

           決済会社へ遷移なし

           加盟店指定 URL

           購入完了

           購入内容確認

           情報入力

           決済手段選択

           決済会社

           当社

           加盟店

           エンドユーザー

           ※解約の場合も同様の処理シーケンスとなります。

        2. 各決済会社の提供画面にも遷移するパターン

           決済情報入力画面等を各決済会社側で表示するパターンです。各決済会社側に遷移し表示される画面イメージや画面遷移は決済会社により異なります。

           決済会社へ遷移あり	画面 凡例 加盟店 当社 決済会社
           エンドユーザー 加盟店 当社 決済会社 決済手段選択 [A01-1] 購入要求 購入内容確認 リダイレクト 情報入力 購入内容確認 OK [A02-1] 購入結果 CGI [A02-2] 購入結果 CGI レスポンス 購入完了 [A03-1] 購入結果(画面返却) 加盟店指定 URL

           

           

           

           《対象の決済手段》

           銀聯ネット決済	ソフトバンクまとめて支払い（A）	ソフトバンクまとめて支払い（B）
           S!まとめて支払い	d払い（キャリア）	auかんたん決済
           WebMoney決済	NET CASH決済	ウォレット決済サービス（Type-Y）
           Yahoo!ウォレット決済デジコン版	楽天ペイ（オンライン決済）	リクルートかんたん支払い
           Alipay国際決済	ペイパル決済	LINE Pay
           ネットマイル	永久不滅ポイント決済	楽天Edy
           モバイルSuica決済	Tポイントプログラム（オンライン決済）	PayPay（オンライン決済）
           メルペイネット決済	au PAY（ネット支払い）	エポスかんたん決済
           楽天ペイ（オンライン決済）V2

           

           ※解約の場合も同様の処理シーケンスとなります。

           ※PayPay（オンライン決済）は指定売上方式の場合、処理結果通知が非同期、API 型にてされる場合があります。通知の詳細については「D408_API 型システム仕様書（PayPay（オンライン決済））」を参照してください。

           ※PayPay（オンライン決済）は、決済機関の仕様により、シーケンスとして SBPS からA02-01 を実施なくエラー画面の遷

           移が発生した後に、A02-01 が実施されることがあり得ます。

        3. 非同期による通知も存在するパターン

           決済時の処理は、上記（１）、（２）となりますが、加えて非同期にて通知するパターンもあります。なお、楽天ペイ（オンライン決済）においては、決済の確定も非同期となりますので、ご注意ください。非同期の購入結果CGIの通知内容は、本書のインターフェース仕様における補足説明を参照ください。

           機能 ID	通知種別	通知用途	対象決済手段
           A02-1	入金通知	エンドユーザーがコンビニ等で入金した場合
           	キャンセル通知	払込票の期限が切れた場合
           	継続課金不可通知	継続課金（簡易）で課金に失敗した場合	いる決済手段
           A04-1	確定通知	決済情報が確定した場合 ※楽天ペイ ：与信/金額変更/売上処理時 ※NP 後払い：売上/取消返金処理時

           • コンビニ決済

           • Pay-easy決済

           • 総合振込決済

           • リクルートかんたん支払い *

           • コンビニ決済

           • Pay-easy決済

           • リクルートかんたん支払い *

           • 継続課金（簡易）に対応して

           • 楽天ペイ（オンライン決済）

           • NP後払い

           《非同期での通知種別と対象決済手段》

           • リクルートかんたん支払いについては、エンドユーザー支払い方法がコンビニ決済を含む場合に限ります。

             画面

             凡例 加盟店 当社 決済機関

             

             

             

             

             

           • 楽天ペイ（オンライン決済）V2 については、非同期による通知はございません。

             非同期での通知あり ※非同期部分は、（１）を例に記載していますが。（２）の場合でも同様です。		画面 凡例 加盟店 当社 決済機関
             エンドユーザー 加盟店 当社 決済機関 決済手段選択 [A01-1] 購入要求 情報入力 購入内容確認 [A02-1] 購入結果 CGI [A02-2] 購入結果 CGI レスポンス 購入完了 [A03-1] 購入結果(画面返却) 加盟店指定 URL 非同期部分
             	[A02-1] 購入結果 CGI／[A04-1] 確定通知 [A02-2] 購入結果 CGI へのレスポンス

        4. 非同期による通知が 1 リクエストに対して複数回存在するパターン

        決済時の処理は、上記（１）となりますが、加えて１リクエストに対して非同期の通知が複数回発生するパターンもあります。NP後払いにおいては、複数回発生する非同期の通知が全て通知されてから、決済の確定となりますので、ご注意ください。非同期の購入結果CGIの通知内容は、本書のインターフェース仕様における補足説明を参照ください。

        

        

        

        

        

        

        

        《１リクエストに対して非同期での通知が複数回発生する通知種別と対象決済手段》

        機能 ID	通知種別	通知用途	対象決済手段
        A04-1	確定通知	【NP 後払い】 取引登録処理が確定された場合与信処理が確定された場合

        • NP後払い

        非同期での複数回の通知あり	画面 凡例 加盟店 当社 決済機関
        エンドユーザー 加盟店 当社 決済機関 決済手段選択 [A01-1] 購入要求 情報入力 購入内容確認 [A02-1] 購入結果 CGI [A02-2] 購入結果 CGI レスポンス 購入完了 [A03-1] 購入結果(画面返却) 加盟店指定 URL 非同期部分 [A04-1] 確定通知 [A04-1] 確定通知

   3. 画面遷移図

      

      加盟店画面

      金額（税込）の判定

      金額（税込）≦0

      金額（税込）＞0

      ⑥

      購入完了画面（無償）

      支払方法の指定

      １つ指定

      指定なし

      or

      複数指定

      ①

      決済選択画面

      決済手段毎の画面遷

      移となる

      ②

      決済手段毎の画面遷

      移となる

      決済処理

      情報入力

      画面

      購入確認

      画面

      決済会社

      画面

      OK

      NG

      通知レスポンス

      NG

      決済結果通知失敗およびレ

      スポンス NG 受信時は、購入エラー画面へ遷移

      OK

      ④

      購入取消画面 ※注

      ③

      購入完了画面

      取消時

      指定 URL

      完了時

      指定 URL

      再入力可能な場合、結果通知は加盟店

      へ送られず、決済情報入力画面へ遷移。不可能な場合、購入エラー画面へ遷移。

      各画面処理でエラーが発生

      した場合

      ⑤

      購入エラー画面

      ⑦

      システムエラー画面

      エラー時

      指定 URL

      エンドユーザーに表示する画面の遷移図は、以下のとおりです。

      ※注：購入取消画面の導線は 2020 年よりデザイン変更によって消去されております。変更前デザインにて表示されます。

      ・決済会社画面でキャンセルした場合はキャンセル時 URL に遷移します。

      ・こちらの導線が必要な場合は弊社営業窓口までお問い合わせください。

      ※キャンセル、システムエラー、再入力の場合には処理の結果通知は加盟店へ送信されません。

   4. 画面の説明

      購入要求で表示される画面は以下のとおりです。

      決済選択画面（画面遷移番号①）

      

      1. 加盟店から要求があったリクエストの電文チェックを行う。

         ※チェックの詳細についてはリンク型システム仕様書（基本仕様）を参照ください。

      2. 加盟店から要求があった「顧客利用端末タイプ」に合った画面を表示

      ※「PC」で指定された場合は、PC 用の画面を出力します。

      ※「モバイル」で指定された場合は、リクエストヘッダのブラウザタイプを識別し、主要キャリア 3 社の専用画面へ自動で振り分けます。

      《表示項目について》

      表示項目	説明
      決済手段	加盟店から要求があった決済手段を表示します。 ※要求された決済手段に指定が無い場合は、設定されている決済手段全てが表示されます。 ※要求された決済手段に指定がある場合は、指定されている決済手段が表示されます。 ※要求された決済手段が 1 つの場合は、決済選択画面は表示されません。 ※iPhone、Android はオプションとなります。 ※決済手段の表示順は任意で指定可能です。 例：決済手段＝クレジットカード決済、WebMoney 決済、d 払い（キャリア）の場合 name=“pay_method” value=”credit, webmoney, docomo”
      ブラウザの戻るボタン	ブラウザの戻るボタンを押下しても加盟店の画面には戻りません。

      

      購入確認画面（画面遷移番号②）

      

      1. 加盟店から要求があったリクエストの購入内容を表示

      《表示項目について》

      表示項目	説明
      お支払い方法	選択された決済手段
      商品名	加盟店リクエストの「商品名称」 ※リクエスト未設定の場合は表示しません。
      ご購入金額	加盟店リクエストの「金額（税込）」
      ご購入明細	加盟店リクエストの画面表示用の購入明細 ※購入明細が無い場合は、購入明細は表示しません。
      「戻る」ボタン	決済手段毎の画面へ遷移
      「キャンセル」ボタン	購入取消画面へ遷移
      「購入」ボタン	購入処理画面へ遷移 ※決済会社の画面、もしくは購入完了画面へ遷移します。

      購入完了画面（画面遷移番号③）

      

      1. 購入が正常に行われた場合は、購入完了画面を表示

      ※購入が正常に行われた場合は、セッション ID を破棄します。

      《表示項目について》

      表示項目	説明
      「戻る」ボタン	加盟店指定の完了画面へ遷移

      購入取消画面（画面遷移番号④）

      

      1. 購入取消が行われた場合は、購入取消画面を表示

      ※購入取消が行われた場合は、セッションIDを破棄します。

      《表示項目について》

      表示項目	説明
      「戻る」ボタン	加盟店指定のキャンセル画面へ遷移

      購入エラー画面 （画面遷移番号⑤）

      

      1. 購入エラーが発生した場合は、購入エラー画面を表示

      《表示項目について》

      表示項目	説明
      「戻る」ボタン	加盟店指定のエラー画面へ遷移
      決済エラー内容	エラー内容を表示 ※決済手段によって、エラー内容を表示できる場合と、できない場合があります。

      購入完了画面（無償／0 円指定時） （画面遷移番号⑥）

      

      1. 購入が正常に行われた場合は、購入完了画面を表示

      ※購入が正常に行われた場合は、セッションIDを破棄します。

      《表示項目について》

      表示項目	説明
      「戻る」ボタン	加盟店指定の完了画面へ遷移

      システムエラー画面（画面遷移番号⑦）

      

      1. チェック処理などでエラーが発生した場合にエラー画面を表示

      ※PC／携帯の指定チェックでエラーが発生した場合は、

      リクエストヘッダのユーザーエージェントを識別し、主要キャリア 3 社 およびその他キャリア、それぞれの専用画面へ自動で振り分けます。

      《表示項目について》

      表示項目	説明
      「戻る」ボタン	購入要求のエラー時に指定されている URL へ遷移 ※加盟店が特定できない場合、「元の画面へ」ボタンは表示しません。また、表示しない場合、加盟店が特定できないので、画面デザインは、システム共通の画面となります。

      《システムエラー画面の表示理由例》

      画面	表示理由例
      加盟店が特定できる場合
      加盟店 が特定できない場合	（当社側の画面保持情報がクリアされた場合など）

      • 購入要求リクエスト上の購入IDの重複が発生している

      • 購入要求リクエスト上のリクエスト許容時間の超過が発生している

      • 購入要求リクエスト上のチェックサム値が誤っている

      • 購入要求リクエスト上の各パラメータの属性がインターフェースと異なっている

      • 当社が表示する各画面において、エンドユーザーの操作にて画面リフレッシュ操作がされた

      • 購入要求リクエスト上のマーチャントIDが払い出したIDと異なっている

      • 購入要求リクエスト上のサービスIDが払い出したIDと異なっている

      • 当社が表示する各画面において、エンドユーザーの操作にて画面リフレッシュ等の操作が繰り返し操作された

3. インターフェース仕様

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

   

   加盟店画面

   決済手段選択画面

   決済情報入力画面

   購入確認画面

   結果表示画面

   加盟店画面

   本あ部ああ分

   1. 要求項目定義

      機能 ID	A01-1
      処理名	購入要求
      流れ	加盟店→当社

      接続先	サービス開始時ご案内
      送信メソッド	Form POST
      送信文字コード	Shift-JIS, html / text

      （型の凡例X：シングルバイト文字型 M：ダブルバイト混在文字型 9：数値型）※使用できる文字の詳細は、リンク型システム仕様書（基本仕様）を参照ください。

      SEQ	タグエレメント名	項目名	桁数	型	必須	タイプ	設定内容	備考
      1	pay_method	支払方法	1000	X	△	可変	credit：クレジットカード決済 credit3d2：クレジットカード決済（本人認証サービス （EMV 3-D セキュア）） unionpay：銀聯ネット決済 paypay：PayPay（オンライン決済） webcvs：コンビニ決済 payeasy：Pay-easy 決済 banktransfer：総合振込決済 cyberedy：楽天Edy 決済（楽天Edy） mobileedy：楽天Edy 決済（モバイル楽天Edy） suica：モバイル Suica 決済 webmoney：WebMoney 決済 netcash：Net Cash 決済 bitcash：BitCash 決済 prepaid：JCB PREMO 決済 docomo：d 払い（キャリア） auone：au かんたん決済 softbank：S!まとめて支払い yahoowallet2：ウォレット決済サービス（Type-Y） yahoowalletdg： Yahoo! ウォレット決済（ デジコン版） rakuten：楽天ペイ（オンライン決済） rakutenv2：楽天ペイ（オンライン決済）V2 recruit：リクルートかんたん支払い alipay：Alipay 国際決済 paypal：Paypal 決済 netmile：ネットマイル決済 mysoftbank： ソフトバンクまとめて支払い（ Ａ ） softbank2：ソフトバンクまとめて支払い（Ｂ） saisonpoint：永久不滅ポイント linepay：LINE Pay merpay：メルペイネット決済 tpoint：T ポイントプログラム（オンライン決済） applepay：Apple Pay nppostpay：NP 後払い aupay：au PAY（ネット支払い） eposeasypay：エポスかんたん決済	支払方法を指定します。（複数指定可） ※支払方法を選択すると、決済情報入力画面から選択された決済手段の画面へ遷移します。 ※省略時または複数指定時は当社にて決済選択画面を表示します。 ※複数指定時はカンマ区切りでご指定下さい。 ※サービスタイプが「1：取消（月額課金解約）」の場合、必須でご指定ください。 ※「yahoowallet：Yahoo!ウォレット決済」は 2021 年 4 月より 「yahoowallet2：ウォレット決済サービス（Type-Y）」に移管します。また、「yahoowallet：Yahoo!ウォレット決済」は 2020 年 9 月末で新規申込を終了します。
      2	merchant_id	マーチャント ID	5	9	○	固定	加盟店を識別する ID	当社で払い出します。
      3	service_id	サービス ID	3	9	○	固定	加盟店のサービスを識別する ID	当社で払い出します
      4	cust_code	顧客 ID	64	X	○	可変	加盟店にて管理されている顧客 ID	マーチャント ID とサービス ID の組み合わせに対してユニーク（一 意）な値としてください。 決済情報保管時の紐付けキーとなるため、必ず顧客別に払い出し てください。
      5	sps_cust_no	SBPS 顧客 ID	12	9		固定	当社で管理する顧客 ID	当連携モデルの場合は未設定（空文字）です。
      6	sps_payment_no	SBPS 支払方法管理番号	3	9		固定	当社で管理する支払方法管理番号	当連携モデルの場合は未設定（空文字）です。
      7	order_id	購入 ID	38	X	○	可変	加盟店にて管理されている購入 ID	マーチャント ID とサービス ID の組み合わせに対してユニーク（一 意）な値としてください。 ※継続課金（簡易）の解約の場合も一意の ID を設定してくださ い。
      8	item_id	商品 ID	32	X	○	可変	加盟店にて管理されている商品 ID
      9	pay_item_id	外部決済機関商品 ID	32	X		可変		当連携モデルの場合は未設定（空文字）です。
      10	item_name	商品名称	40	M	△	可変	任意の商品名	日本語、英数半角混在可能です。文字数オーバー時は切捨しま す。文字化け時は「？」に置換します。 ※設定されない場合は、購入内容確認画面において商品名の項目自体が表示されません。 NP 後払いの場合は必須項目となります。 Pay-easy 決済では以下の文字種は使用不可です。 *(アスタリスク)、_(アンダーバー)、@(アットマーク)
      11	tax	税額	7	9	△	可変	課金税額	0 円以上を設定してください。 ※総合振込決済のみ必須です。
      12	amount	金額（税込）	7	9	○	可変	税込の課金金額	0 円以上を設定してください。

      13	pay_type	購入タイプ	1	9	○	固定	0：都度課金 1：継続課金（簡易） 2：継続課金（定期・従量）
      14	auto_charge_type	自動課金タイプ	1	9	△	固定	0：自動課金しない 1：自動課金する	購入タイプが「継続課金（簡易）」または「継続課金（定期・従 量）」時のみ指定可で必須となります。 購入タイプが「継続課金（定期・従量）」の場合、「自動課金しな い」のみ指定可です。
      15	service_type	サービスタイプ	1	9	○	固定	0：売上（購入） 1：取消（月額課金解約）	購入タイプが「都度課金」または「継続課金（定期・従量）」の場 合 、「売上（購入）」のみ指定可です。 取消（月額課金解約）は「継続課金（簡易）」のみ指定可能で す。
      16	div_settele	決済区分	1	9	△	固定	0：前払い	購入タイプが「継続課金（簡易）」または「継続課金（定期・従 量）」時のみ、必須項目となります。 購入タイプが「都度課金」の場合、設定なしとなります。
      17	last_charge_month	最終課金月	6	9		固定	YYYYMM	設定月の次月から継続課金を行いません。 購入タイプが「継続課金（簡易）」時のみ指定可です。 「継続課金（定期・従量）」は設定なしとなります。
      18	camp_type	キャンペーンタイプ	1	9	△	固定	0：キャンペーンなし 1：購入月無料	購入タイプが「継続課金（簡易）」時のみ指定可で必須となりま す。 「継続課金（定期・従量）」は設定なしとなります。 ※2022 年 2 月 1 日以降に継続課金（簡易）をお申込みの加盟店様は、クレジットカード決済においては「1:購入月無料」を使用した初月解約時有料の要求が利用できません。(リクエストした場合シ ステムエラー画面に遷移します。)
      19	tracking_id	トラッキング ID	14	X	△	固定	購入時に当社が払出す ID	サービスタイプが「取消（月額課金解約）」時のみ指定可で必須と なります。
      20	terminal_type	顧客利用端末タイプ	1	9		固定	0：PC 1：フィーチャーフォン	省略の場合“0”を適用します。 ※詳細は本書のインターフェース仕様における補足説明をご参照く ださい。
      21	success_url	決済完了時 URL	500	X	○	可変	画面戻り先 URL
      22	cancel_url	決済キャンセル時 URL	500	X	○	可変	画面戻り先 URL
      23	error_url	エラー時 URL	500	X	○	可変	画面戻り先 URL
      24	pagecon_url	決済通知用CGI	500	X	○	可変	結果通知先 URL	SSL 通信が必須となります。 ※使用可能 SSL 証明書については、リンク型システム仕様書（基 本仕様）の利用可能SSL をご参照ください。
      25	free1	自由欄１	20	M		可変		日本語、英数半角混在可能です。文字数オーバー時は切捨しま す。文字化け時は「？」に置換します。
      26	free2	自由欄２	20	M		可変		日本語、英数半角混在可能です。文字数オーバー時は切捨しま す。文字化け時は「？」に置換します。
      27	free3	自由欄３	20	M		可変		日本語、英数半角混在可能です。文字数オーバー時は切捨しま す。文字化け時は「？」に置換します。
      28	free_csv	フリー項目	4000	M		可変	商品名称や住所情報など	詳細は、本書のインターフェース仕様における補足説明をご参照くだ さい。

      29	dtl_rowno	明細行番号	3	9	○	可変	1、2、3、・・・明細の行番号（表示される順序）	1 ずつインクリメントさせてください。 ※明細行最大件数は 999 明細です。
      30	dtl_item_id	明細商品 ID	20	X	△	可変	画面に表示される明細の商品 ID	他明細内の明細商品 ID で、いずれか一つに設定されていた場合 は、必須となります。
      31	dtl_item_name	明細商品名称	40	M	△	可変	画面に表示される明細の商品名	日本語、英数半角混在可能です。文字数オーバー時は切捨しま す。文字化け時は「？」に置換します。 他明細内の明細商品名称で、いずれか一つに設定されていた場合は、必須となります。 NP 後払いの場合は明細を設定する場合には必須項目となります。 Pay-easy 決済では以下の文字種は使用不可です。 *(アスタリスク)、_(アンダーバー)、@(アットマーク)
      32	dtl_item_count	明細数量	6	9	△	可変	画面に表示される明細の購入数量	他明細内の明細数量で、いずれか一つに設定されていた場合は、 必須となります。 NP 後払いの場合は明細を設定する場合には必須項目となります。
      33	dtl_tax	明細税額	8	9		可変	明細小計に対する税額
      34	dtl_amount	明細金額（税込）	8	9	△	可変	画面に表示される明細の小計金額（税込）	他明細内の明細金額（税込）で、いずれか一つに設定されていた 場合は、必須となります。 NP 後払いの場合は明細を設定する場合には必須項目となります。
      35	dtl_free1	明細自由欄 1	3000	M		可変		※当社決済システムへの格納は行わない項目になります。 ご利用の際は、当社営業にご確認下さい。
      36	dtl_free2	明細自由欄 2	3000	M		可変		※当社決済システムへの格納は行わない項目になります。 ご利用の際は、当社営業にご確認下さい。
      37	dtl_free3	明細自由欄 3	3000	M		可変		※当社決済システムへの格納は行わない項目になります。 ご利用の際は、当社営業にご確認下さい。

      複数購入の場合は繰り返し（画面表示用項目）

      複数購入の場合の繰り返しここまで

      38	request_date	リクエスト日時	14	9	○	固定	YYYYMMDDHHMISS	本機能を加盟店がリクエストした日時です。
      39	limit_second	リクエスト許容時間	4	9		可変	当社サーバのタイムスタンプとリクエスト日時の差分許 容時間	省略時は規定値（600）を適用します。
      40	sps_hashcode	チェックサム	40	X	○	固定	電文の値に対するチェックサム	リンク型システム仕様書（基本仕様）をご参照ください。

      

      加盟店画面

      決済手段選択画面

      決済情報入力画面

      購入確認画面

      結果表示画面

      加盟店画面

      本部分

      あああ

   2. 結果 CGI 項目定義

      機能 ID	A02-1
      処理名	購入結果CGI
      流れ	当社→加盟店

      接続先	指定された URL（結果通知用 CGI）
      送信メソッド	HTTP POST
      送信文字コード	Shift-JIS

      SEQ	タグエレメント名	項目名	桁数	型	必須	タイプ	設定内容	備考
      1	pay_method	支払方法	1000	X		可変	リクエスト時の内容
      2	merchant_id	マーチャント ID	5	9	○	固定	〃
      3	service_id	サービス ID	3	9	○	固定	〃
      4	cust_code	顧客 ID	64	X	○	可変	〃
      5	sps_cust_no	SBPS 顧客 ID	12	9		固定	〃
      6	sps_payment_no	SBPS 支払方法管理番号	3	9		固定	〃
      7	order_id	購入 ID	38	X	○	可変	〃
      8	item_id	商品 ID	32	X	○	可変	〃
      9	pay_item_id	外部決済機関商品 ID	32	X		可変	〃
      10	item_name	商品名称	40	M		可変	〃
      11	tax	税額	7	9		可変	〃
      12	amount	金額（税込）	7	9	○	可変	〃
      13	pay_type	購入タイプ	1	9	○	固定	〃
      14	auto_charge_type	自動課金タイプ	1	9	△	固定	〃
      15	service_type	サービスタイプ	1	9	○	固定	〃
      16	div_settele	決済区分	1	9	△	固定	〃
      17	last_charge_month	最終課金月	6	9		固定	〃
      18	camp_type	キャンペーンタイプ	1	9	△	固定	〃
      19	tracking_id	トラッキング ID	14	X		固定	〃
      20	terminal_type	顧客利用端末タイプ	1	9		固定	〃
      21	free1	自由欄１	20	M		可変	〃
      22	free2	自由欄２	20	M		可変	〃
      23	free3	自由欄３	20	M		可変	〃

      （型の凡例X：シングルバイト文字型 M：ダブルバイト混在文字型 9：数値型）※使用できる文字の詳細は、リンク型システム仕様書（基本仕様）を参照ください。

      24	dtl_rowno	明細行番号	2	9	○	可変	〃
      25	dtl_item_id	明細商品 ID	20	X		可変	〃
      26	dtl_item_name	明細商品名称	40	M		可変	〃
      27	dtl_item_count	明細数量	6	9		可変	〃
      28	dtl_tax	明細税額	8	9		可変	〃
      29	dtl_amount	明細金額（税込）	8	9		可変	〃
      30	dtl_free1	明細自由欄 1	3000	M		可変	〃
      31	dtl_free2	明細自由欄 2	3000	M		可変	〃
      32	dtl_free3	明細自由欄 3	3000	M		可変	〃

      複数購入の場合は繰り返し（画面表示用項目）

      33

      request_date

      リクエスト日時

      14

      9

      ○

      固定

      〃

      34	res_pay_method	処理結果 支払方法	20	X	○	可変		購入要求時に選択された支払方法です。
      35	res_result	処理結果ステータス	2	X	○	固定	OK：要求処理 OK NG：要求 NG CR：課金解約された CC：キャリア解約 PY：入金通知 CN：期限切れキャンセル CL：最終課金月による解約	詳細は、次頁の購入結果CGI における処理結果ステータスの種類を参照ください。
      36	res_tracking_id	処理トラッキング ID	14	X	○	固定	購入時に当社が払出す ID
      37	res_sps_cust_no	処理SBPS 顧客 ID	12	9		固定	当社で管理する顧客 ID
      38	res_sps_payment_no	処理SBPS 支払方法管理番号	3	9		固定	当社で管理する支払方法管理番号

      複数購入の場合の繰り返しここまで結果返却時にセットされる項目

      39	res_payinfo_key	顧客決済情報	145	X		可変	顧客決済情報	処理結果ステータスがOK の場合のみ、返却します。 ・クレジットカード決済：カード番号を元にした SBPS 独自の演算によるハッシュ値（頭０補完 16 桁） ・リクルートかんたん支払い：リクルートの注文番号（固定 15 桁） ※ エンドユーザー支払い方法がコンビニ決済の場合は先頭に 「webcvs,」の文字列が入りますので、後日入金通知等を受け取ってください。 ・d 払い（キャリア）：購入タイプが「定期購入」時、ドコモの承諾番号（固定 12 桁） ・ソフトバンクまとめて支払い（Ａ）：決済機関側の注文番号 ・請求書（コンビニ決済／総合振込／Payeasy）：入金種別コード、入金額、入金累計額、メールアドレスがカンマ（,）区切りで連結した英数字 ※請求書の入金種別コードは、1 桁の固定で通知内容は下記のとおりです。 P：速報／C：速報取消／D：確報／G：確報取消 ※収納会社によって存在しない入金種別コードがあります。例：1 万円の速報入金で１万 5 千円の累積額の場合、 P,10000,15000,aaa@aaa.com となります。 ・銀聯ネット決済：銀聯トランザクション ID ・メルペイネット決済：ユーザー確認用取引 ID ・ウォレット決済サービス（Type-Y）：クレカと PayPay 内訳金額がカンマ（,）区切りで連結した数字（500,300：クレカ 500 円、 PayPay300 円の例） ・PayPay（オンライン決済）：PayPay の決済番号 ・エポスかんたん決済 購入の場合 「クレジット利用金額 + “,” + クーポン利用金額 +”,” ポイント利用金額」 ※各項目、不使用の場合は「0」として返却 ・楽天ペイ（オンライン決済）V2：charge_id
      40	res_payment_date	完了処理日時	14	9		可変	YYYYMMDDHHMISS	処理結果ステータス OK の場合、外部決済期間の処理日時となり ます。 処理結果ステータス NG の場合、処理日時が無い場合があります。 処理結果ステータスPY の場合、通知処理日となります。
      41	res_err_code	エラーコード	4	X		可変	エラーコード一覧参照
      42	res_date	レスポンス日時	14	9	○	可変	YYYYMMDDHHMISS	当社がレスポンスした日時です。
      43	limit_second	レスポンス許容時間	4	9	○	可変	当社サーバのタイムスタンプとリクエスト日時の差分許 容時間	省略時は規定値（600）を適用します。
      44	sps_hashcode	チェックサム	40	X	○	固定	電文の値に対するチェックサム	リンク型システム仕様書（基本仕様）をご参照ください。

      購入結果CGIにおける処理結果ステータスの種類

      処理結果ステータスの種類は、以下の7種類です。

      処理結果ステータス	説明
      OK（決済処理 OK）	決済処理が正常に行われた場合に通知します。
      NG（決済処理 NG）	決済処理が決済失敗した場合に通知します。
      CR（継続課金（簡易）解約）	継続課金（簡易）の月次課金処理が失敗した場合に通知します。
      CC（キャリア解約）	携帯の解約、継続商品の解約などにより翌月以降の継続課金（簡易）の課金 が不可となった場合に通知します。
      PY（入金通知）	オフライン決済で入金処理が実施されたことを通知します。
      CN（期限切れ通知）	オフライン決済で払込票の支払期限が過ぎたことを通知します。
      CL（最終課金月解約）	最終課金月を迎えて継続課金（簡易）を停止した場合に通知します。

      処理結果ステータスが通知されるタイミングと発生状況、および各処理結果ステータスに対する加盟店側のサービス提供の判断は、以下のとおりです。

      処理結果ステータス	通知タイミング	発生状況			加盟店側サービス提供
      		都度課金	継続課金 （簡易 ）	オフライン
      OK（決済処理 OK）	都度	○	×	×	サービス提供する
      NG（決済処理 NG）	都度	○	×	×	サービス提供しない

      CR（継続課金（簡易）解約）	月次（月初）	×	○	×	即時サービス提供停止
      CC（キャリア解約）	日次	×	○	×	通知月の月末にサービス提供停止
      PY（入金通知）	入金時	×	×	○	サービス提供する
      CN（期限切れ通知）	入金期限切れ時	×	×	○	サービス提供しない
      CL（最終課金月解約）	月次（月初）	×	○	×	サービス提供が終了していることを確認

      決済手段	処理結果ステータス
      	OK	NG※3	CR	CC	PY	CN	CL
      クレジットカード決済／ 本人認証サービス（EMV 3-Dセキュア）	○	－	○	－	－	－	－
      銀聯ネット決済	○	－	－	－	－	－	－
      PayPay（オンライン決済）	○	－	－	－	－	－	－
      ソフトバンクまとめて支払い（Ａ）	○	○	－	－	－	－	－
      ソフトバンクまとめて支払い（Ｂ）	○	－	－	－	－	－	－
      S!まとめて支払い	○	○	－	－	－	－	－
      d払い（キャリア）	○	○	○	○	－	－	○
      auかんたん決済	○	○	○	－	－	－	○
      WebMoney決済	○	－	－	－	－	－	－
      BitCash決済	○	○	－	－	－	－	－
      NET Cash決済	○	○	－	－	－	－	－
      JCB PREMO決済	○	○	－	－	－	－	－
      ウォレット決済サービス（Type-Y）	○	－	－	－	－	－	－
      Yahoo!ウォレット決済デジコン版	○	○	○	○	－	－	－
      楽天ペイ（オンライン決済）	○	○	－	－	－	－	－
      楽天ペイ（オンライン決済）V2	○	－	－	－	－	－	－
      リクルートかんたん支払い	○	－	○	○	○※2	○※2	○
      Alipay決済	○	－	－	－	－	－	－
      PayPal決済	○	○	－	－	－	－	－
      LINE Pay	○	○	－	－	－	－	－
      メルペイネット決済	○	－	－	－	－	－	－
      ネットマイル決済	○	○	－	－	－	－	－
      永久不滅ポイント決済	○	○	－	－	－	－	－
      楽天Edy決済	○	○	－	－	－	－	－
      モバイルSuica決済	○	－	－	－	－	－	－
      コンビニ決済	○※1	○	－	－	○	○	－
      Pay-easy決済	○※1	○	－	－	○	○	－
      総合振込決済	○※1	－	－	－	○	－	－
      Tポイントプログラム（オンライン決済）	○	○	－	－	－	－	－
      Apple Pay	○	○	－	－	－	－	－
      NP後払い	○	○	－	－	－	－	－
      au PAY（ネット支払い）	○	○	－	－	－	－	－
      エポスかんたん決済	○	○	－	－	－	－	－

      各決済手段の設定される可能性がある処理結果ステータスは、以下のとおりです。

      ※1：申込みが確定したことを通知します。

      ※2：リクルートかんたん支払いについては、エンドユーザー支払い方法がコンビニ決済を含む場合に限ります。

      ※3：決済機関の仕様によっては、購入結果 CGI（A02-1）が実施されずエラー画面に遷移する場合があります。

   3. 結果CGIレスポンス項目定義

      機能 ID	A02-2
      処理名	購入結果CGI レスポンス
      流れ	加盟店→当社

      接続先	購入結果CGI の通知元
      送信メソッド	HTTP POST
      送信文字コード	Shift-JIS, text / csv

      

      加盟店画面

      決済手段選択画面

      決済情報入力画面

      購入確認画面

      結果表示画面

      加盟店画面

      本あ部ああ分

      SEQ	項目名	桁数	型	必須	設定内容	備考
      1	処理結果	2	X	○	OK NG	加盟店側の処理結果です。 ※結果 CGI の「res_result」が NG の場合には必ず OK を返却してく ださい
      2	エラーメッセージ	100	M		加盟店側でエラーとなった時のメッセージ	処理「OK」の時は不要です。

      （型の凡例 X：シングルバイト文字型 M：ダブルバイト混在文字型 9：数値型）※使用できる文字の詳細は、リンク型システム仕様書（基本仕様）を参照ください。

      ※詳細仕様は、リンク型システム仕様書（基本仕様）参照ください。

   4. 結果（画面返却）項目定義

      機能 ID	A03-1
      処理名	購入結果（画面返却）
      流れ	当社→加盟店

      接続先	指定された URL（完了）
      送信メソッド	Form POST
      送信文字コード	Shift-JIS, html / text

      

      加盟店画面

      決済手段選択画面

      決済情報入力画面

      購入確認画面

      結果表示画面

      加盟店画面

      本部分

      あああ

      SEQ	タグエレメント名	項目名	桁数	型	必須	タイプ	設定内容	備考
      1	pay_method	支払方法	1000	X		可変	リクエスト時の内容
      2	merchant_id	マーチャント ID	5	9	○	固定	〃
      3	service_id	サービス ID	3	9	○	固定	〃
      4	cust_code	顧客 ID	64	X	○	可変	〃
      5	sps_cust_no	SBPS 顧客 ID	12	9		固定	〃
      6	sps_payment_no	SBPS 支払方法管理番号	3	9		固定	〃
      7	order_id	購入 ID	38	X	○	可変	〃
      8	item_id	商品 ID	32	X	○	可変	〃
      9	pay_item_id	外部決済機関商品 ID	32	X		可変	〃
      10	item_name	商品名称	40	M		可変	〃
      11	tax	税額	7	9		可変	〃
      12	amount	金額（税込）	7	9	○	可変	〃
      13	pay_type	購入タイプ	1	9	○	固定	〃
      14	auto_charge_type	自動課金タイプ	1	9	△	固定	〃
      15	service_type	サービスタイプ	1	9	○	固定	〃
      16	div_settele	決済区分	1	9	△	固定	〃
      17	last_charge_month	最終課金月	6	9		固定	〃
      18	camp_type	キャンペーンタイプ	1	9	△	固定	〃
      19	tracking_id	トラッキング ID	14	X		固定	〃
      20	terminal_type	顧客利用端末タイプ	1	9		固定	〃
      21	free1	自由欄１	20	M		可変	〃
      22	free2	自由欄２	20	M		可変	〃
      23	free3	自由欄３	20	M		可変	〃

      （型の凡例X：シングルバイト文字型 M：ダブルバイト混在文字型 9：数値型）※使用できる文字の詳細は、リンク型システム仕様書（基本仕様）を参照ください。

      24	dtl_rowno	明細行番号	2	9	○	可変	〃
      25	dtl_item_id	明細商品 ID	20	X		可変	〃
      26	dtl_item_name	明細商品名称	40	M		可変	〃
      27	dtl_item_count	明細数量	6	9		可変	〃
      28	dtl_tax	明細税額	8	9		可変	〃
      29	dtl_amount	明細金額（税込）	8	9		可変	〃
      30	dtl_free1	明細自由欄 1	3000	M		可変	〃
      31	dtl_free2	明細自由欄 2	3000	M		可変	〃
      32	dtl_free3	明細自由欄 3	3000	M		可変	〃

      複数購入の場合は繰り返し（画面表示用項目）

      33

      request_date

      リクエスト日時

      14

      9

      ○

      固定

      〃

      34	res_pay_method	処理結果 支払方法	20	X	○	可変		購入要求時に選択された支払方法です。
      35	res_result	処理結果ステータス	2	X	○	固定	OK：要求処理 OK NG：要求 NG
      36	res_tracking_id	処理トラッキング ID	14	X	○	固定	購入時に当社が払出す ID
      37	res_sps_cust_no	処理SBPS 顧客 ID	12	9		固定	当社で管理する顧客 ID
      38	res_sps_payment_no	処理SBPS 支払方法管理番号	3	9		固定	当社で管理する支払方法管理番号
      39	res_payinfo_key	顧客決済情報	145	X		可変	顧客決済情報	処理結果ステータスがOK の場合のみ、返却します。 ・クレジットカード決済：カード番号を元にした SBPS 独自の演算によるハッシュ値（頭０補完 16 桁） ・リクルートかんたん支払い：リクルートの注文番号（固定 15 桁） ・d 払い（キャリア）：購入タイプが「定期購入」時、ドコモの承諾番号（固定 12 桁） ・ソフトバンクまとめて支払い（Ａ）：決済機関側の注文番号 ・請求書：入金種別コード、入金額、入金累計額、メールアドレスがカンマ（,）区切りで連結した英数字 ※請求書の入金種別コードは、1 桁の固定で通知内容は下記のとおりです。 P：速報／C：速報取消／D：確報／G：確報取消 例：1 万円の速報入金で１万 5 千円の累積額の場合、 P,10000,15000,aaa@aaa.com となります。 ・銀聯ネット決済：銀聯トランザクション ID ・メルペイネット決済：ユーザー確認用取引 ID ・ウォレット決済サービス（Type-Y）：クレカと PayPay 内訳金額がカンマ（,）区切りで連結した数字（500,300：クレカ 500 円、 PayPay300 円の例） ・PayPay（オンライン決済）：PayPay の決済番号 ・楽天ペイ（オンライン決済）V2：charge_id
      40	res_payment_date	完了処理日時	14	9		可変	YYYYMMDDHHMISS	処理結果ステータス OK の場合、外部決済期間の処理日時となり ます。 処理結果ステータス NG の場合、処理日時が無い場合があります。 処理結果ステータスPY の場合、通知処理日となります。
      41	res_err_code	エラーコード	4	X		可変	エラーコード一覧参照

      複数購入の場合の繰り返しここまで結果返却時にセットされる項目

      42	res_date	レスポンス日時	14	9	○	可変	YYYYMMDDHHMISS	当社がレスポンスした日時です。
      43	limit_second	レスポンス許容時間	4	9	○	可変	当社サーバのタイムスタンプとリクエスト日時の差分許 容時間	省略時は規定値（600）を適用します。
      44	sps_hashcode	チェックサム	40	X	○	固定	電文の値に対するチェックサム	リンク型システム仕様書（基本仕様）をご参照ください。

   5. その他項目定義

      確定通知（楽天ペイ（オンライン決済）、NP 後払いのみ）

      ※楽天ペイ（オンライン決済）V2 については確定通知機能はございません。

      機能 ID	A04-1
      処理名	確定通知
      流れ	当社→加盟店

      接続先	指定された URL（結果通知用 CGI)
      送信メソッド	HTTP POST
      送信文字コード	Shift-JIS

      

      加盟店画面

      決済手段選択

      決済情報入力

      画面

      購入確認画面

      結果表示画面

      加盟店画面

      

      本部分

      非同期通知

      （型の凡例X：シングルバイト文字型 M：ダブルバイト混在文字型 9：数値型）※使用できる文字の詳細は、リンク型システム仕様書（基本仕様）を参照ください。

      SEQ	タグエレメント名	項目名	桁数	型	必須	タイプ	設定内容	備考
      1	pay_method	支払方法	1000	X		可変	リクエスト時の内容
      2	merchant_id	マーチャント ID	5	9	○	固定	〃
      3	service_id	サービス ID	3	9	○	固定	〃
      4	cust_code	顧客 ID	64	X	○	可変	〃
      5	sps_cust_no	SBPS 顧客 ID	12	9		固定	〃
      6	sps_payment_no	SBPS 支払方法管理番号	3	9		固定	〃
      7	order_id	購入 ID	38	X	○	可変	〃
      8	item_id	商品 ID	32	X	○	可変	〃
      9	pay_item_id	外部決済機関商品 ID	32	X		可変	〃
      10	item_name	商品名称	40	M		可変	〃
      11	tax	税額	7	9		可変	〃
      12	amount	金額（税込）	7	9	○	可変	〃
      13	pay_type	購入タイプ	1	9	○	固定	〃
      14	auto_charge_type	自動課金タイプ	1	9	△	固定	〃
      15	service_type	サービスタイプ	1	9	○	固定	〃
      16	div_settele	決済区分	1	9	△	固定	〃
      17	last_charge_month	最終課金月	6	9		固定	〃
      18	camp_type	キャンペーンタイプ	1	9	△	固定	〃
      19	tracking_id	トラッキング ID	14	X		固定	〃
      20	terminal_type	顧客利用端末タイプ	1	9		固定	〃
      21	free1	自由欄１	20	M		可変	〃
      22	free2	自由欄２	20	M		可変	〃
      23	free3	自由欄３	20	M		可変	〃

      24	dtl_rowno	明細行番号	2	9	○	可変	〃
      25	dtl_item_id	明細商品 ID	20	X		可変	〃
      26	dtl_item_name	明細商品名称	40	M		可変	〃
      27	dtl_item_count	明細数量	6	9		可変	〃
      28	dtl_tax	明細税額	8	9		可変	〃
      29	dtl_amount	明細金額（税込）	8	9		可変	〃
      30	dtl_free1	明細自由欄 1	3000	M		可変	〃
      31	dtl_free2	明細自由欄 2	3000	M		可変	〃
      32	dtl_free3	明細自由欄 3	3000	M		可変	〃

      複数購入の場合は繰り返し（画面表示用項目）

      33

      request_date

      リクエスト日時

      14

      9

      ○

      固定

      〃

      34	res_pay_method	処理結果 支払方法	20	X	○	可変		購入要求時に選択された支払方法です。
      35	res_result	処理結果ステータス	2	X	○	固定	OK：要求処理 OK NG：要求 NG
      36	res_tracking_id	処理トラッキング ID	14	X	○	固定	購入時に当社が払出す ID
      37	res_sps_cust_no	処理SBPS 顧客 ID	12	9		固定	当社で管理する顧客 ID
      38	res_sps_payment_no	処理SBPS 支払方法管理番号	3	9		固定	当社で管理する支払方法管理番号
      39	res_payinfo_key	顧客決済情報	145	X		可変	楽天ペイ（オンライン決済） R01：与信結果 （定期・従量課金のみ） R02：金額変更結果 R03：売上結果 NP 後払い N01：取引登録結果 N02：与信結果 N03：売上結果 N04：取消結果 N05：返金結果	楽天ペイ（オンライン決済）、NP 後払いでの処理確定について、該当の処理区分値を設定します。

      複数購入の場合の繰り返しここまで結果返却時にセットされる項目

      40	res_payment_date	完了処理日時	14	9		可変	YYYYMMDDHHMISS	処理結果ステータス OK の場合、外部決済期間の処理日時となり ます。 処理結果ステータス NG の場合、処理日時が無い場合があります。 処理結果ステータスPY の場合、通知処理日となります。
      41	res_err_code	エラーコード	4	X		可変	エラーコード一覧参照
      42	res_date	レスポンス日時	14	9	○	可変	YYYYMMDDHHMISS	当社がレスポンスした日時です。
      43	limit_second	レスポンス許容時間	4	9	○	可変	リクエスト時の許容時間	省略時は規定値（600）を適用します。
      44	sps_hashcode	チェックサム	40	X	○	固定	電文の値に対するチェックサム	リンク型システム仕様書（基本仕様）をご参照ください。

      ※楽天ペイ（オンライン決済）

      売上、金額変更、継続課金（定期・従量）購入については別途確定となりますので、本機能を用いて非同期で確定通知を行います。そのためサービス提供は、確定通知の受信後に実施をお願いします。

      ※NP 後払い

      購入、売上、取消、返金については別途確定となりますので、本機能を用いて非同期で確定通知を行います。そのためサービス提供や停止は、確定通知の受信後に実施をお願いします。

      購入は、取引登録結果、および与信結果の通知後に確定となります。

4. 個別仕様

   1. Alipay国際決済における購入要求のタグエレメント「free_csv」について

      リンク型のAlipay国際決済では、Alipayの口座画面に表示する商品名称について、加盟店で特殊な設定が必要となります。購入要求のタグエレメント「item_name」の設定値とは異なりますので、ご注意ください。

      使用方法

      《使用API》

      接続方式	API 種別	データの流れ
      リンク型	購入要求	加盟店→当社

      《設定エレメント》

      （型の凡例X：シングルバイト文字型 M：ダブルバイト混在文字型 9：数値型）※使用できる文字の詳細は、リンク型システム仕様書（基本仕様）を参照ください。

      タグエレメント名	項目名	桁数	型	タイプ	設定内容	備考
      free_csv	自由欄（CSV 形式）	4000	M	可変	以下の設定方法を参照	※base64 エンコード必須になります。

      設定方法

      (1)項目名+(2)接続文字（=半角イコール）+(3)項目値+(4)区切文字（,半角カンマ） …を連結していきます。

      ※エレメントを設定した場合、購入要求のチェックサム生成については変換後の値で文字列連結して、ハッシュ計算した値を設定する必要があります。

      《項目定義》

      設定内容	設定値	説明	桁数	型	備考
      項目名	ITEM_NAME	商品名称	256	M	–

      《設定例》

      1. 設定値とその値を接続文字（半角イコール）で接続させます。

         ITEM_NAME=テスト商品

      2. GBKコードに変換後、base64方式で変換します。

         aXRlbV9uYW1lPaXGpbmlyMnMxrc=

      3. リンク型POST項目のfree_csvに設定して、送信します。

         《バリデーションについて》

         購入要求リクエスト時について、項目全体のバリデーションは実施しますが、各項目別のバリデーションは実施しません（入力画面に遷移した以降は、各項目別にバリデーションを行い、エラーとなった場合はエラー場面に遷移します）。

         以下が、free_csvのバリデーション内容です。

         • 送信された文字列が4000byte以下であること

         • エンコードフォーマットがbase64方式であること

         • デコード後の文字列が2500byte以下であること

           制約

           《制約について》

           free_csvには、以下の制約がありますので、ご注意ください。

         • 文字コードはS-JIS

         • 項目名の大文字小文字は区別する

         • 項目名に接続文字及び区切文字を含めてはいけない

         • 項目値に区切文字を含めてはいけない

         • 項目順序は意識しない

         • 各項目は必須ではない

         • 未定義の項目を設定しても問題はないが、その場合未定義の項目は無視する

         • 入力画面に遷移した以降、エンドユーザーによる変更入力は返却されない

         • 管理画面には、free_csvのデータ値自体は、表示されない

      《free_csv項目内で利用できない文字》

      以下の文字は、全ての項目において利用できません。

      文字	名称	S-JIS コード
      ,	半角カンマ	0x2C
      ‘	半角シングルクォーテーション	0x27
      “	半角ダブルクォーテーション	0x22
      %	半角パーセント	0x25
      |	半角パイプ	0x7C
      &	半角アンパサント	0x26
      <	半角小なり	0x3C
      >	半角大なり	0x3E

      《free_csv項目内の、全角カナ指定項目で利用できる文字》

      以下は、姓（カナ）名（カナ）項目で利用可能な文字です。

      文字	S-JIS コード
      ァアィイゥウェエォオカガキギクグケゲコゴサザシジスズセゼソゾタダチヂッツヅテデトド ナニヌネノハバパヒビピフブプヘベペホボポマミムメモャヤュユョヨラリルレロヮワヰヱヲンヴヵヶー	8340～8396,

      《free_csv項目内の、半角カナ指定項目で利用できる文字》

      以下は、カナ氏名（姓）カナ氏名（名）項目で利用可能な文字です。

      文字	S-JIS コード
      ｰｱｲｳｴｵｦｧｨｩｪｫｬｭｮｯﾀﾁﾂﾃﾄﾅｶｷｸｹｺｻｼｽｾｿﾐﾑﾒﾓﾔﾕﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾖﾗﾘﾙﾚﾛﾜﾝﾞﾟ	0xA6～0xD

      《free_csv項目内の、E-mailアドレス指定項目で利用できる文字》以下は、E-mailアドレス項目で利用可能な文字です。

      文字	名称	S-JIS コード
      ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz	半角英字	0x41～0x5A 0x61～0x7A
      0123456789	半角数字	0x30～0x39
      @	半角アットマーク	0x40
      .	半角ピリオド	0x2E
      _	半角アンダーバー	0x5F
      –	半角ハイフン	0x2D

      留意事項

      《本機能利用時の設定について》

      本機能を利用するには、専用設定が必要になります。利用する際は、担当営業まで連絡ください。

      画面イメージ

      設定した値が商品名として表示されます。

      

   2. オフライン決済における購入要求のタグエレメント「free_csv」について

      オフライン決済（コンビニ決済、Pay-easy決済、総合振込決済）をリンク型で利用する場合、「free_csv」を利用することで以下のことが可能です。

      • 電話番号やメールアドレスなどの決済に必要な情報やを初期入力値として画面に表示

      • 支払期日をトランザクションごとに指定

        使用方法

        《使用API》

        接続方式	API 種別	データの流れ
        リンク型	購入要求	加盟店→当社

        《設定エレメント》

        （型の凡例X：シングルバイト文字型 M：ダブルバイト混在文字型 9：数値型）※使用できる文字の詳細は、リンク型システム仕様書（基本仕様）を参照ください。

        タグエレメント名	項目名	桁数	型	タイプ	設定内容	備考
        free_csv	自由欄（CSV 形式）	4000	M	可変	以下の設定方法を参照	※base64 エンコード必須になります。API 型を併用する場合は 3DES による暗号化が必要になるケースがあります。

        設定方法

        (1)項目名+(2)接続文字（=半角イコール）+(3)項目値+(4)区切文字（,半角カンマ） …を連結していきます。

        《項目定義》

        設定内容	設定値	説明	桁数	型	決済手段別の必須入力項目※１			備考
        					コンビニ決済	Pay-easy 決済	総合振込決済
        項目名	LAST_NAME	姓	20	Ｍ	○	○	○	全角
        	FIRST_NAME	名	20	Ｍ	○	○	○	全角
        	LAST_NAME_KANA	姓（カナ）	20	Ｍ	–	–	○	全角カナ
        	FIRST_NAME_KANA	名（カナ）	20	Ｍ	–	–	–	全角カナ
        	FIRST_ZIP	郵便番号（3 桁）	3	９	–	–	○	–
        	SECOND_ZIP	郵便番号（4 桁）	4	９	–	–	○	–
        	ADD1	都道府県	50	Ｍ	–	–	○	–
        	ADD2	市区町村・番地	50	Ｍ	–	–	○	–
        	ADD3	マンション・ビル名等	100※4	Ｍ	–	–	–	–
        	TEL	電話番号（ハイフン無し）	11	９	○	○	○	–
        	MAIL	E-mail アドレス	128	Ｘ	○	○	○	半角英数※3
        	BILL_DATE※5	支払期日（YYYYMMDD）	8	９	○	○	–	半角数字
        	BILL_DATE_TIME※	支払期日時間（YYYYMMDDHHMI）	12	９	○	○	–	半角数字
        接続文字	=	半角イコール	–	–	–	–	–	–
        項目値	各項目に順ずる	項目値毎バリデーション無し	–	–	–	–	–	–
        区切文字	,	半角カンマ	–	–	–	–	–	–

        ※1：連携時の必須項目ではなく、連携後の決済情報入力画面での必須項目です。

        ※2：本節「free_csv項目内の、全角カナ指定項目で利用できる文字」を参照ください。

        ※3：本節「E-mailアドレス指定項目で利用できる文字」を参照ください。

        ※4：決済手段が総合振込の場合は、200バイトとなります。後述の印刷用制約にて、デリミタを使用する場合は、各項目で100バイト以下かつデリミタ含めた合計値が200バイト以下である必要があります。

        ※5：BILL_DATEならびにBILL_DATE_TIMEについては、指定可能な決済手段・収納会社が限定され対象外の決済手段については指定しても使われません。指定可否については、各決済手段のサービス仕様書を確認ください。

        《設定例》

        1. 設定値とその値を接続文字（半角イコール）で接続させ、区切文字（半角カンマ）で連結します。

           LAST_NAME=鈴木,FIRST_NAME=太郎,MAIL=test@ps.softbank.co.jp,・・・

        2. base64方式で変換します。 TEFTVF9OQU1FPZfpltgsRklSU1RfTkFNRT2RvphZLE1BSUw9dGVzdEBwc・・・

        3. リンク型POST項目のfree_csvに設定して、送信します。

           ※API型を併用している場合は、（1）の後に3DES暗号化をし、（2）のエンコードが必要となります。詳細は、API型システム仕様書（基本仕様）を参照ください。

           《バリデーションについて》

           購入要求リクエスト時について、項目全体のバリデーションは実施しますが、各項目別のバリデーションは実施しません（入力画面に遷移した以降は、各項目別にバリデーションを行い、エラーとなった場合はエラー場面に遷移します）。

           以下が、free_csvのバリデーション内容です。

           • 送信された文字列が4000byte以下であること

           • エンコードフォーマットがbase64方式であること

           • デコード後の文字列が2500byte以下であること

             制約

             《制約について》

             free_csvには、以下の制約がありますので、ご注意ください。

           • 文字コードはS-JIS

           • 項目名の大文字小文字は区別する

           • 項目名に接続文字及び区切文字を含めてはいけない

           • 項目値に区切文字を含めてはいけない

           • 項目順序は意識しない

           • 各項目は必須ではない

           • 未定義の項目を設定しても問題はないが、その場合未定義の項目は無視する

           • 入力画面に遷移した以降、エンドユーザーによる変更入力は返却されない

           • 管理画面には、free_csvのデータ値自体は、表示されない

             《free_csv項目内で利用できない文字について》

             以下の文字は、全ての項目において利用できない文字です。

             文字	名称	S-JIS コード
             ,	半角カンマ	0x2C
             ‘	半角シングルクォーテーション	0x27
             “	半角ダブルクォーテーション	0x22
             %	半角パーセント	0x25
             |	半角パイプ	0x7C
             &	半角アンパサント	0x26
             <	半角小なり	0x3C
             >	半角大なり	0x3E
             ｡｢｣､･ｦｧｨｩｪｫｬｭｮｯｰｱｲｳｴｵｶｷｸｹｺｻｼｽ ｾｿﾀﾁﾂﾃﾄﾅﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾐﾑﾒﾓﾔﾕﾖﾗﾘﾙﾚ ﾛﾜﾝﾞﾟ	半角カタカナ	0xA1～0xDF

             《free_csv項目内の、全角カナ指定項目で利用できる文字》以下は、姓(カナ) 名(カナ)項目で利用可能な文字です。

             文字	S-JIS コード
             ァアィイゥウェエォオカガキギクグケゲコゴサザシジスズセゼソゾタダチヂッツヅテデトド	8340～8396,
             ナニヌネノハバパヒビピフブプヘベペホボポマミムメモャヤュユョヨラリルレロヮワヰヱヲ	815B
             ンヴヵヶー

             《free_csv 項目内の、E-mail アドレス指定項目で利用できる文字》以下は、E-mail アドレス項目で利用可能な文字です。

             文字	名称	S-JIS コード
             ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz	半角英字	0x41～0x5A 0x61～0x7A
             0123456789	半角数字	0x30～0x39
             @	半角アットマーク	0x40
             .	半角ピリオド	0x2E
             _	半角アンダーバー	0x5F
             –	半角ハイフン	0x2D

             画面イメージ

             《連携時の画面イメージ》

             

             コンビニ決済の場合は、以下の決済画面イメージとなります。

             《紙払込票における制約》

             紙払込票での受付の場合、ADD2とADD3が一行に連結されますが、ADD3にデリミタを用いることで会社名・部署名を分け改行を入れて印刷することが可能です。

             例： 住所 東京都港区東新橋１－９－２汐留住友ビル２５Ｆ会社名 SBペイメントサービス株式会社

             部署名 サービス本部サービス部

             上記のように印刷したい場合、free_csvを以下のように設定します。

             • ADD1=東京都

             • ADD2=港区東新橋１－９－２

             • ADD3=汐留住友ビル２５Ｆ□□□SBペイメントサービス株式会社□□□サービス本部サービス部

        ※□=全角スペース

        ※ADD3は200バイトまでとなりますが、デリミタを用いて建物名、会社名、部署名に分けた場合は、建物名100バイト、会社名60バイト、部署名100バイトとなります。

        ※紙払込票の場合は、ADD1、ADD2、ADD3には半角文字は使用できません。

        

        ADD3=

        サービス本部サービス部

        ＳＢペイメントサービス株式会社

        汐留住友ビル２５Ｆ

        ADD2=港区東新橋１－９－２

        ADD1=東京都

        紙払込票における制約の例の画面イメージです。

        ※上記入力画面において、「会社名」、「部署名」の入力欄を分けて表示させるためには別途画面カスタマイズサービスへの

        申込みが必要となります。申込みしない場合は「マンション・ビル名など」の入力欄にそのまま表示されます。

        東京都

        港区東新橋 1－９－２汐留住友ビル２５Ｆ

        SB ペイメントサービス株式会社

        サービス本部サービス部

        鈴木 太郎 様

        

        宛名印字部分

   3. LINE Payにおける購入要求のタグエレメント「free_csv」について

      リンク型のLINE Payでは、LINE Pay画面において表示する商品画像URLをFreeCSV項目として連携が可能です。ま た、連携項目によりchannel web login画面の省略やLINE Payの処理中画面における文字言語の指定などが可能です。

      使用方法

      《使用API》

      接続方式	API 種別	データの流れ
      リンク型	購入要求	加盟店→当社

      《設定エレメント》

      （型の凡例X：シングルバイト文字型 M：ダブルバイト混在文字型 9：数値型）※使用できる文字の詳細は、リンク型システム仕様書（基本仕様）を参照ください。

      タグエレメント名	項目名	桁数	型	タイプ	設定内容	備考
      free_csv	自由欄（CSV 形式）	4000	M	可変	以下の設定方法を参照	※base64 エンコード必須になります。API 型を併用する場合は 3DES による暗号化が必要になるケースがあります。

      設定方法

      (1)項目名+(2)接続文字（=半角イコール）+(3)項目値+(4)区切文字（,半角カンマ） …を連結していきます。

      設定内容	設定値	説明	桁数	型	備考	例
      項目名	PRODUCT_IMAGE_URL	商品画像 URL	500	Ｍ	LINE Pay アプリ画面にて表示する商品 画像 URL※1	https://stbfep.sps- system.com/material/spsdummy/i mg/button/bt_linepay.jpg
      	LINE_MEMBER_ID	LINE 会員 ID	50	Ｍ	決済を行うLINE 会員mid※2	LINEmid1234
      	DELIVERY_PLACE_PHONE	受取人連絡先	100	Ｍ	LINEPay 内部の Risk Management で参照	0368892130
      	LANG_CD	決済待ち画面言語コード	7	Ｘ	決済待画面の言語コード※3	ja
      	CHECK_CONFIRM_URL_BROWS ER	決済承認後遷移先 URL ブラウザチェック実施可否	5	Ｘ	confirmUrl 遷移時の browser チェック 可否※4 true：チェックを実施する／ false：チェックを実施しない	false
      接続文字	=	半角イコール	–	–	–	–
      項目値	各項目に順ずる	項目値毎バリデーション無し	–	–	–	–
      区切文字	,	半角カンマ	–	–	–	–

      《項目定義》

      ※1：商品画像URLの設定がない場合は、アプリにて商品画像の表示はありません。

      ※2：LINE会員IDの連携がある場合、画面遷移時のchannel web login画面が省略されます。

      ※3：決済待ち画面言語コードは以下の６種の言語に対応しています。

      • ja : 日本語

      • ko : 韓国語

      • en : 英語

      • zh -Hans : 中国語 (簡体字 )

      • zh -Hant : 中国語 (繁体字 )

      • th : タイ語

      ※4：設定のない場合は初期値としてfalseの設定となります。

      《設定例》

      1. 設定方法に則って連結文字を作成します。

         PRODUCT_IMAGE_URL=https://stbfep.sps- system.com/material/spsdummy/img/button/bt_linepay.jpg,LANG_CD=ko

      2. 作成された連携文字をbase64方式にてエンコードします。

         UFJPRFVDVF9JTUFHRV9VUkw9aHR0cHM6Ly9zdGJmZXAuc3BzLXN5c3RlbS5jb20vbWF0ZXJpYWw

         vc3BzZHVtbXkvaW1nL2J1dHRvbi9idF9saW5lcGF5LmpwZyxMQU5HX0NEPWtv

      3. リンク型POST項目のfree_csvにセットし、送信します。

         ※API型を併用している場合は、（1）の後に3DES暗号化をし、（2）のエンコードが必要となります。詳細は、API型システム仕様書（基本仕様）を参照ください。

         《バリデーションについて》

         購入要求リクエスト時について、項目全体のバリデーションは実施しますが、各項目別のバリデーションは実施しません（入力画面に遷移した以降は、各項目別にバリデーションを行い、エラーとなった場合はエラー場面に遷移します）。

         以下が、free_csvのバリデーション内容です。

         • 送信された文字列が4000byte以下であること

         • エンコードフォーマットがbase64方式であること

         • デコード後の文字列が2500byte以下であること

           制約

           《制約について》

           free_csvには、以下の制約がありますので、ご注意ください。

         • 文字コードはS-JIS

         • 項目名の大文字小文字は区別する

         • 項目名に接続文字及び区切文字を含めてはいけない

         • 項目値に区切文字を含めてはいけない

         • 項目順序は意識しない

         • 各項目は必須ではない

         • 未定義の項目を設定しても問題はないが、その場合未定義の項目は無視する

         • 入力画面に遷移した以降、エンドユーザーによる変更入力は返却されない

         • 管理画面には、free_csvのデータ値自体は、表示されない

      《free_csv項目内で利用できない文字》

      以下の文字は、全ての項目において利用できません。

      文字	名称	S-JIS コード
      ,	半角カンマ	0x2C
      ‘	半角シングルクォーテーション	0x27
      “	半角ダブルクォーテーション	0x22
      %	半角パーセント	0x25
      |	半角パイプ	0x7C
      &	半角アンパサント	0x26
      <	半角小なり	0x3C
      >	半角大なり	0x3E
      ｡｢｣､･ｦｧｨｩｪｫｬｭｮｯｰｱｲｳｴｵｶｷｸｹｺｻｼｽ ｾｿﾀﾁﾂﾃﾄﾅﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾐﾑﾒﾓﾔﾕﾖﾗﾘﾙﾚ ﾛﾜﾝﾞﾟ	半角カタカナ	0xA1～0xDF

      画面イメージ

      上記例で送信された場合の画面イメージです。

      《PCブラウザ画面（LINE Pay処理中画面）》

      

      《LINE Payアプリ画面》

      

   4. リクルートかんたん支払いにおける購入要求のタグエレメント「free_csv」について

      リクルートかんたん支払いをリンク型で利用する場合、「free_csv」を利用することで以下のことが可能です。

      • 支払期日をトランザクションごとに指定

        使用方法

        《使用API》

        接続方式	API 種別	データの流れ
        リンク型	購入要求	加盟店→当社

        《設定エレメント》

        （型の凡例X：シングルバイト文字型 M：ダブルバイト混在文字型 9：数値型）※使用できる文字の詳細は、リンク型システム仕様書（基本仕様）を参照ください。

        タグエレメント名	項目名	桁数	型	タイプ	設定内容	備考
        free_csv	自由欄（CSV 形式）	4000	M	可変	以下の設定方法を参照	※base64 エンコード必須になります。API 型を併用する場合は 3DES による暗号化が必要になるケースがあります。

        設定方法

        (1)項目名+(2)接続文字（=半角イコール）+(3)項目値+(4)区切文字（,半角カンマ） …を連結していきます。

        《項目定義》

        設定内容	設定値	説明	桁数	型	備考
        項目名	BILL_DATE※	支払期日（YYYYMMDD）	8	９	半角数字
        	BILL_DATE_TIME※	支払期日時間（YYYYMMDDHHMI）	12	９	半角数字

        ※：BILL_DATEならびにBILL_DATE_TIMEについては、指定可能な決済手段・収納会社が限定され対象外の決済手段については指定しても使われません。指定可否については、各決済手段のサービス仕様書を確認ください。

        エンドユーザー支払い方法がコンビニ決済を含む場合に限ります。

        《設定例》

        1. 設定値とその値を接続文字（半角イコール）で接続させ、区切文字（半角カンマ）で連結します。

           BILL_DATE =20170201

        2. base64方式で変換します。 TEFTVF9OQU1FPZfpltgsRklSU1RfTkFNRT2RvphZLE1BSUw9dGVzdEBwc・・・

        3. リンク型POST項目のfree_csvに設定して、送信します。

           《バリデーションについて》

           購入要求リクエスト時について、項目全体のバリデーションは実施しますが、各項目別のバリデーションは実施しません（入力画面に遷移した以降は、各項目別にバリデーションを行い、エラーとなった場合はエラー場面に遷移します）。

           以下が、free_csvのバリデーション内容です。

           • 送信された文字列が4000byte以下であること

           • エンコードフォーマットがbase64方式であること

           • デコード後の文字列が2500byte以下であること

             制約

             《制約について》

             free_csvには、以下の制約がありますので、ご注意ください。

           • 文字コードはS-JIS

           • 項目名の大文字小文字は区別する

           • 項目名に接続文字及び区切文字を含めてはいけない

           • 項目値に区切文字を含めてはいけない

           • 項目順序は意識しない

           • 各項目は必須ではない

           • 未定義の項目を設定しても問題はないが、その場合未定義の項目は無視する

           • 入力画面に遷移した以降、エンドユーザーによる変更入力は返却されない

           • 管理画面には、free_csvのデータ値自体は、表示されない

   5. NP後払いにおける購入要求のタグエレメント「free_csv」について

      リンク型のNP後払いでは、注文日やお客様情報をFreeCSV項目として連携する必要があります。

      使用方法

      《使用API》

      接続方式	API 種別	データの流れ
      リンク型	購入要求	加盟店→当社

      《設定エレメント》

      （型の凡例X：シングルバイト文字型 M：ダブルバイト混在文字型 9：数値型）※使用できる文字の詳細は、リンク型システム仕様書（基本仕様）を参照ください。

      タグエレメント名	項目名	桁数	型	タイプ	設定内容	備考
      free_csv	自由欄（CSV 形式）	4000	M	可変	以下の設定方法を参照	※base64 エンコード必須になります。API 型を併用する場合は 3DES による暗号化が必要になるケースがあります。

      設定方法

      (1)項目名+(2)接続文字（=半角イコール）+(3)項目値+(4)区切文字（,半角カンマ） …を連結していきます。

      《項目定義》

      設定内容	設定値	説明	桁数	型	備考
      項目名	NP_ORDER_DATE	加盟店注文日	8	9	YYYYMMDD
      	NP_COMPANY_NAME	購入者会社名	60	Ｍ	全角文字のみを設定してください。
      	NP_DEPARTMENT	購入者部署名	60	Ｍ	全角文字のみを設定してください。
      	NP_CUSTOMER_NAME	購入者氏名	42	Ｍ	全角文字のみを設定してください。
      	NP_CUSTOMER_NAME_KANA	購入者氏名(カナ)	50	Ｍ	全角カナのみを設定してください。
      	NP_ZIP	購入者郵便番号	7	9
      	NP_ADDRESS	購入者住所	110	Ｍ	全角文字のみを設定してください。
      	NP_TEL	購入者電話番号	11	9
      	NP_EMAIL	購入者メールアドレス	100	X
      	NP_DEST_COMPANY_NAME	配送先会社名	60	Ｍ	全角文字のみを設定してください。
      	NP_DEST_DEPARTMENT	配送先部署名	60	Ｍ	全角文字のみを設定してください。
      	NP_DEST_CUSTOMER_NAME	配送先氏名	42	Ｍ	全角文字のみを設定してください。 配送先郵便番号、配送先住所、配送先電話番号のいずれかが設定されている 場合のみ必須です。
      	NP_DEST_CUSTOMER_NAME_KA NA	配送先氏名(カナ)	50	Ｍ	全角カナのみを設定してください。
      	NP_DEST_ZIP	配送先郵便番号	7	9	配送先氏名、配送先住所、配送先電話番号のいずれかが設定されている場合 のみ必須です。
      	NP_DEST_ADDRESS	配送先住所	110	Ｍ	全角文字のみを設定してください。 配送先氏名、配送先郵便番号、配送先電話番号のいずれかが設定されている 場合のみ必須です。
      	NP_DEST_TEL	配送先電話番号	11	9	配送先氏名、配送先郵便番号、配送先住所のいずれかが設定されている場合 のみ必須です。

      《設定例》

      1. 設定値とその値を接続文字（半角イコール）で接続させ、区切文字（半角カンマ）で連結します。

         NP_ORDER_DATE=20180901,NP_COMPANY_NAME=会社名・・・

      2. 3DES暗号化を行い、base64方式で変換します。 1BNK6NDjiRdhEN0p5rajgyp2tjEC5EEnpvbBGYO+F6fckdWWXllvDYGQ1Jq・・・

      3. リンク型POST項目のfree_csvに設定して、送信します。

         《バリデーションについて》

         購入要求リクエスト時について、項目全体のバリデーションは実施しますが、各項目別のバリデーションは実施しません（入力画面に遷移した以降は、各項目別にバリデーションを行い、エラーとなった場合はエラー場面に遷移します）。

         以下が、free_csvのバリデーション内容です。

         • 送信された文字列が4000byte以下であること

         • エンコードフォーマットがbase64方式であること

         • デコード後の文字列が2500byte以下であること

           制約

           《制約について》

           free_csvには、以下の制約がありますので、ご注意ください。

         • 文字コードはS-JIS

         • 項目名の大文字小文字は区別する

         • 項目名に接続文字及び区切文字を含めてはいけない

         • 項目値に区切文字を含めてはいけない

         • 項目順序は意識しない

         • 以下の項目は必須項目

           購入者氏名、購入者郵便番号、購入者住所、購入者電話番号、購入者メールアドレスまた、以下の項目はいずれかを入力した場合は全ての項目を設定する必要がある

           配送先氏名、配送先郵便番号、配送先住所、配送先電話番号

         • 未定義の項目を設定しても問題はないが、その場合未定義の項目は無視する

         • 入力画面に遷移した以降、エンドユーザーによる変更入力は返却されない

         • 管理画面には、free_csvのデータ値自体は、表示されない

      《free_csv項目内で利用できない文字》

      以下の文字は、全ての項目において利用できません。

      文字	名称	S-JIS コード
      ,	半角カンマ	0x2C
      ‘	半角シングルクォーテーション	0x27
      “	半角ダブルクォーテーション	0x22
      %	半角パーセント	0x25
      |	半角パイプ	0x7C
      &	半角アンパサント	0x26
      <	半角小なり	0x3C
      >	半角大なり	0x3E
      ｡｢｣､･ｦｧｨｩｪｫｬｭｮｯｰｱｲｳｴｵｶｷｸｹｺｻｼｽ ｾｿﾀﾁﾂﾃﾄﾅﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾐﾑﾒﾓﾔﾕﾖﾗﾘﾙﾚ ﾛﾜﾝﾞﾟ	半角カタカナ	0xA1～0xDF

   6. PayPay（オンライン決済）における購入要求のタグエレメント「free_csv」について

      リンク型のPayPay（オンライン決済）では、指定売りのみ与信の有効期限を設定できます。有効期限は、加盟店様が決済機関へ申し込まれた期限より短いものにしてください。

      使用方法

      《使用API》

      接続方式	API 種別	データの流れ
      リンク型	購入要求	加盟店→当社

      《設定エレメント》

      （型の凡例X：シングルバイト文字型 M：ダブルバイト混在文字型 9：数値型）※使用できる文字の詳細は、リンク型システム仕様書（基本仕様）を参照ください。

      タグエレメント名	項目名	桁数	型	タイプ	設定内容	備考
      free_csv	自由欄（CSV 形式）	4000	M	可変	以下の設定方法を参照	※base64 エンコード必須になります。API 型を併用する場合は 3DES による暗号化が必要になるケースがあります。

      設定方法

      (1)項目名+(2)接続文字（=半角イコール）+(3)項目値+(4)区切文字（,半角カンマ） …を連結していきます。

      《項目定義》

      設定内容	設定値	説明	桁数	型	備考
      項目名	PAYPAY_EXPIRED_DATETIME	与信有効期限	20	9	Epoctime で設定
      	ORDER_DESCRIPTION	取引説明	255	M
      	TRANSITION_TYPE	遷移種別 1 ： アプリから遷移(WebLink) ／ 2 ： アプリから遷移 (DeepLink)	1	9	加盟店アプリのWebView 設定がWebLink（Universal Links/App Links）の 場合、設定値を「１」にしてください。（推奨） 加盟店アプリの WebView 設定が DeepLink（Custom URL Scheme）の場合、設定値を「２」にしてください。 ※欄外の注意事項もご確認ください。

      注意事項：TRANSITION_TYPEについて

      本項目についてはサービス説明資料「加盟店アプリ、PayPay アプリ連動について」もご確認ください。

      PayPay（オンライン決済）において、ユーザー導線における外部ブラウザの起動を回避する目的で設置されている項目となります。ご利用の際には以下にご留意ください。

      「2：アプリから遷移(DeepLink)」を設定した場合には、ユーザーのスマホにPayPayアプリがインストールされてない場合、決済が完了できません。

      設定値「1：アプリから遷移(WebLink)」であればユーザーのスマホにPayPayアプリがインストールされていない場合でも

      Webベースでの決済が可能のため、設定値は「1：アプリから遷移(WebLink)」が推奨となります。

      「1：アプリから遷移(WebLink)」で解決出来ない問題等が発生した場合のみのご利用をお願いします。

      《設定例》

      1. 設定値とその値を接続文字（半角イコール）で接続させ、区切文字（半角カンマ）で連結します。

         PAYPAY_EXPIRED_DATETIME=1582862260,ORDER_DESCRIPTION=あいうえお

      2. 3DES暗号化を行い、base64方式で変換します。 1BNK6NDjiRdhEN0p5rajgyp2tjEC5EEnpvbBGYO+F6fckdWWXllvDYGQ1Jq・・・

      3. リンク型POST項目のfree_csvに設定して、送信します。

         《バリデーションについて》

         購入要求リクエスト時について、項目全体のバリデーションは実施しますが、各項目別のバリデーションは実施しません（入力画面に遷移した以降は、各項目別にバリデーションを行い、エラーとなった場合はエラー場面に遷移します）。

         以下が、free_csvのバリデーション内容です。

         • 送信された文字列が4000byte以下であること

         • エンコードフォーマットがbase64方式であること

         • デコード後の文字列が2500byte以下であること

           制約

           《制約について》

           free_csvには、以下の制約がありますので、ご注意ください。

         • 文字コードはS-JIS

         • 項目名の大文字小文字は区別する

         • 項目名に接続文字及び区切文字を含めてはいけない

         • 項目値に区切文字を含めてはいけない

         • 項目順序は意識しない

         • 各項目は必須ではない

         • 未定義の項目を設定しても問題はないが、その場合未定義の項目は無視する

         • 入力画面に遷移した以降、エンドユーザーによる変更入力は返却されない

         • 管理画面には、free_csvのデータ値自体は、表示されない

      《free_csv項目内で利用できない文字》

      以下の文字は、全ての項目において利用できません。

      文字	名称	S-JIS コード
      ,	半角カンマ	0x2C
      ‘	半角シングルクォーテーション	0x27
      “	半角ダブルクォーテーション	0x22
      %	半角パーセント	0x25
      |	半角パイプ	0x7C
      &	半角アンパサント	0x26
      <	半角小なり	0x3C
      >	半角大なり	0x3E
      ｡｢｣､･ｦｧｨｩｪｫｬｭｮｯｰｱｲｳｴｵｶｷｸｹｺｻｼｽ ｾｿﾀﾁﾂﾃﾄﾅﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾐﾑﾒﾓﾔﾕﾖﾗﾘﾙﾚ ﾛﾜﾝﾞﾟ	半角カタカナ	0xA1～0xDF

   7. クレジットカード決済（本人認証サービス（EMV 3-Dセキュア））における購入要求のタグエレメント「free_csv」について

      リンク型のクレジットカード決済（本人認証サービス（EMV 3-Dセキュア））で本人認証に必要な設定ができます。

      使用方法

      《使用API》

      接続方式	API 種別	データの流れ
      リンク型	購入要求	加盟店→当社

      《設定エレメント》

      （型の凡例X：シングルバイト文字型 M：ダブルバイト混在文字型 9：数値型）※使用できる文字の詳細は、リンク型システム仕様書（基本仕様）を参照ください。

      タグエレメント名	項目名	桁数	型	タイプ	設定内容	備考
      free_csv	自由欄（CSV 形式）	4000	M	可変	以下の設定方法を参照	※base64 エンコード必須になります。API 型を併用する場合は 3DES による暗号化が必要になるケースがあります。

      設定方法

      (1)項目名+(2)接続文字（=半角イコール）+(3)項目値+(4)区切文字（,半角カンマ） …を連結していきます。

      《項目定義》

      設定内容	設定値	説明	桁数	型	備考
      項目名	TDS2INFO_TOKEN	カード利用者の決済情報のトークン		X	詳細は「E003_EMV 3-D セキュア認証仕様書」を参照ください。
      	TDS2INFO_TOKEN_KEY	カード利用者の決済情報のトークンキー		X

      《設定例》

      1. 設定値とその値を接続文字（半角イコール）で接続させ、区切文字（半角カンマ）で連結します。

         TDS2INFO_TOKEN=123456789abc,TDS2INFO_TOKEN_KEY=asdefg123

      2. 3DES暗号化を行い、base64方式で変換します。 1BNK6NDjiRdhEN0p5rajgyp2tjEC5EEnpvbBGYO+F6fckdWWXllvDYGQ1Jq・・・

      3. リンク型POST項目のfree_csvに設定して、送信します。

         《バリデーションについて》

         購入要求リクエスト時について、項目全体のバリデーションは実施しますが、各項目別のバリデーションは実施しません（入力画面に遷移した以降は、各項目別にバリデーションを行い、エラーとなった場合はエラー場面に遷移します）。

         以下が、free_csvのバリデーション内容です。

         • 送信された文字列が4000byte以下であること

         • エンコードフォーマットがbase64方式であること

         • デコード後の文字列が2500byte以下であること

           制約

           《制約について》

           free_csvには、以下の制約がありますので、ご注意ください。

         • 文字コードはS-JIS

         • 項目名の大文字小文字は区別する

         • 項目名に接続文字及び区切文字を含めてはいけない

         • 項目値に区切文字を含めてはいけない

         • 項目順序は意識しない

         • 各項目は必須ではない

         • 未定義の項目を設定しても問題はないが、その場合未定義の項目は無視する

         • 入力画面に遷移した以降、エンドユーザーによる変更入力は返却されない

         • 管理画面には、free_csvのデータ値自体は、表示されない

      《free_csv項目内で利用できない文字》

      以下の文字は、全ての項目において利用できません。

      文字	名称	S-JIS コード
      ,	半角カンマ	0x2C
      ‘	半角シングルクォーテーション	0x27
      “	半角ダブルクォーテーション	0x22
      %	半角パーセント	0x25
      |	半角パイプ	0x7C
      &	半角アンパサント	0x26
      <	半角小なり	0x3C
      >	半角大なり	0x3E
      ｡｢｣､･ｦｧｨｩｪｫｬｭｮｯｰｱｲｳｴｵｶｷｸｹｺｻｼｽ ｾｿﾀﾁﾂﾃﾄﾅﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾐﾑﾒﾓﾔﾕﾖﾗﾘﾙﾚ ﾛﾜﾝﾞﾟ	半角カタカナ	0xA1～0xDF

5. 特記事項

   リンク型における Apple Pay 決済について

   当社のリンク型における Apple Pay 決済は Apple Pay on the Web を利用しております。動作環境や制約につきましては、以下を参照ください。

   https://developer.apple.com/documentation/apple_pay_on_the_web

6. 更新履歴