# e-SCOTT Smart for Developers

> SP.LINKS Inc. が提供する決済インターフェイス「e-SCOTT Smart」の導入・利用に必要な情報をまとめた、開発者向けドキュメントサイトです。各決済手段の接続仕様、API仕様、サンプルコードなどを掲載しています。

## はじめに

- [e-SCOTT Smartとは](https://developer.splinks.co.jp/readme-first/readme-first): e-SCOTT Smart の概要を説明しています。加盟店が e-SCOTT と接続する方法として、「オンライン（API）」「ファイル（SFTP/FTP）」「加盟店管理画面」の3つを案内しています。
- [本サイトの利用について](https://developer.splinks.co.jp/readme-first/readme-first): サイト全体の構成と利用上の注意点を説明しています。共通仕様、クレジットカード決済、マルチペイメント、ソリューション支援（MCPサーバー）、更新履歴、レスポンスコード、はじめに関連の各ドキュメントを案内しています。

## 共通仕様

- [サービスの概要](https://developer.splinks.co.jp/common-specification/common-specification): テスト環境と本番環境の違い、取引の基本フロー（Master電文・Process電文）、プロセスIDやマーチャントIDなどの用語、電文フォーマット仕様（key=value を & で連結した POST 電文）を説明しています。
- [接続方式](https://developer.splinks.co.jp/common-specification/common-specification): HTTPS/TLS1.2、UTF-8、POSTメソッドによる接続仕様、AESによる暗号化・復号の手順、SSL証明書の要件（Security Communication Root CA2）、接続元IPアドレス制限を説明しています。
- [留意事項](https://developer.splinks.co.jp/common-specification/common-specification): 取引データの保持期間や、エンドユーザが利用できる端末に関する制限をまとめています。
- [参考資料](https://developer.splinks.co.jp/common-specification/common-specification): 電文送信サンプルプログラム（Java、PHP、VB.NET）、AES暗号化・復号サンプル（Java）、POSTによるリダイレクトサンプル（HTML）を掲載しています。

## クレジットカード決済

- [クレジットカード決済とは](https://developer.splinks.co.jp/credit-card-payment/credit-card-payment): クレジットカード決済の概要を説明しています。利用可能なインターフェイス（オンライン、バッチ、ファイル伝送、加盟店管理画面）、課金方式（都度課金・継続課金）、取引区分（Master電文・Process電文・売上障害取消電文・会員情報登録電文）を案内しています。
- [インターフェイス概要](https://developer.splinks.co.jp/credit-card-payment/credit-card-payment): トークン決済機能、リンク型画面決済（三者間）機能、カード情報保持機能、利用可能なバッチ処理（売上データ送信、洗替処理、支払明細データ返戻）、3Dセキュア、認証アシストサービスを説明しています。
- [インターフェイス詳細](https://developer.splinks.co.jp/credit-card-payment/credit-card-payment): クレジットカード決済のAPI一覧（1Check、1Auth、1Gathering、1Capture、1Change、1Delete、1Search、1ReAuth、1Recover、4MemAdd、4MemChg、4MemInval、4MemRef、4MemRefM、4MemRefMulti、4MemRefToken、4MemUnInval、4MemDel）、処理フロー、API仕様（接続先URL、Master電文・Process電文・売上障害取消電文・会員情報登録電文・POST電文の項目定義）、コード定義（取引ステータス、会員ステータス、支払区分、認証結果など）、各種一覧を掲載しています。
- [APPENDIX](https://developer.splinks.co.jp/credit-card-payment/credit-card-payment): タイムアウト推奨値（90秒）、会員ステータスと後続処理結果の一覧、会員ID自動採番機能を掲載しています。

## トークン決済

- [トークン決済とは](https://developer.splinks.co.jp/credit-card-payment/token-payment): トークン決済の概要を説明しています。エンドユーザが入力したカード情報をトークン（カード情報の代わりになるID）に置き換え、カード情報が加盟店システムを通過せずにオーソリ処理を行うサービスです。カード決済認証項目トークンについても説明しています。
- [インターフェイス概要](https://developer.splinks.co.jp/credit-card-payment/token-payment): トークン決済およびカード決済認証項目トークン発行で利用可能なインターフェイスと処理区分を説明しています。
- [インターフェイス詳細](https://developer.splinks.co.jp/credit-card-payment/token-payment): トークン発行API一覧（spsvButton、spsvCardInfoScreen、spsvCreateToken、spsvCreateTokenNa）、処理フロー（ポップアップ型・カスタマイズ型・トークンステータス参照）、API仕様（接続先URL、API取得電文項目定義、Process電文項目定義）、実装手順（サンプルコード付き）、コード定義（トークンステータス）を掲載しています。
- [APPENDIX](https://developer.splinks.co.jp/credit-card-payment/token-payment): カード情報入力画面（ポップアップ型）のカスタマイズオプション機能を説明しています。

## EMV3Dセキュア

- [EMV3Dセキュアとは](https://developer.splinks.co.jp/credit-card-payment/emv-3d-secure): EMV3Dセキュアサービスの概要を説明しています。オンラインにおけるカード不正利用を防ぐ本人認証サービスで、JCB（J/Secure）、VISA（Visa Secure）、MasterCard（Mastercard ID Check）、AMEX（SafeKey）、Diners（ProtectBuy）に対応しています。
- [インターフェイス概要](https://developer.splinks.co.jp/credit-card-payment/emv-3d-secure): EMV3Dセキュアサービスで利用できるインターフェイス（オンライン、加盟店管理画面）を説明しています。
- [インターフェイス詳細](https://developer.splinks.co.jp/credit-card-payment/emv-3d-secure): API一覧（3Secure、1Check、1Auth、1Gathering、3Search、4MemAdd、4MemChg）、処理フロー、API仕様（接続先URL、3Dセキュア認証電文・Master電文・Process電文・会員情報登録電文の項目定義）、コード定義（ECI、トランザクションステータス、3Dセキュア認証結果コード）、留意事項を掲載しています。
- [APPENDIX](https://developer.splinks.co.jp/credit-card-payment/emv-3d-secure): オーソリ送信判定オプション、3Dセキュア認証項目保持機能を説明しています。

## マルチペイメント

- [ID決済とは](https://developer.splinks.co.jp/payment-specification/id-payment): ID決済の概要を説明しています。エンドユーザが ID決済事業者のアカウントで認証し、チャージ残高や登録済みクレジットカードで支払える決済サービスで、PayPay、楽天ペイ、メルペイ、d払い、au PAY、Alipay+、BitCash、atone、PayPal、Paidy など複数の決済手段を一括で導入できます。
- [インターフェイス概要](https://developer.splinks.co.jp/payment-specification/id-payment): ID決済で利用できるインターフェイスや課金方式（都度課金・継続課金・随時課金）、売上方式（即時売上・出荷売上）を説明しています。利用可能なインターフェイスは「オンライン」と「加盟店管理画面」です。
- [インターフェイス詳細](https://developer.splinks.co.jp/payment-specification/id-payment): ID決済のAPI一覧（18Auth、18RecStart、18RecAuth、18Search、18Refund、18RecSearch、18RecCancel、18Capture、18Change、18Cancel）、処理フロー、API仕様（接続先URL、Master電文・Process電文・POST電文の項目定義）、コード定義（取引ステータス、決済手段、サブ決済手段、支払方式、商品種別、商品カテゴリ、解約方式、商品受取場所、性別、本人確認ステータス、過去利用決済など）、各種一覧（即時売上・出荷売上の課金方式対応表、POST電文の送信有無、Process電文の処理期限、一部返金機能対応表）、留意事項を掲載しています。
- [APPENDIX](https://developer.splinks.co.jp/payment-specification/id-payment): ID決済の状態遷移図を掲載しています。都度課金（即時売上・出荷売上）と継続課金/随時課金（即時売上・出荷売上）の4パターンを収録しています。

## ソリューション支援

- [MCPサーバーとは](https://developer.splinks.co.jp/solution-support/mcp-server): e-SCOTT の機能を AI エージェントと対話可能な MCP ツールとして提供するサービスの概要を説明しています。
- [サービス詳細](https://developer.splinks.co.jp/solution-support/mcp-server): MCPサーバーで利用可能な機能の一覧と接続情報を掲載しています。現在はナレッジ検索（ドキュメント・仕様情報の検索）を提供しており、接続先 URL（https://knowledge-mcp.e-scott.jp/mcp）と接続設定サンプルを収録しています。
- [留意事項](https://developer.splinks.co.jp/solution-support/mcp-server): MCPサーバー利用時の注意事項をまとめています。AIモデルによる回答の正確性は本サービスの提供範囲外であること、出力内容は利用者の責任において判断することを案内しています。

## Appendix

- [更新履歴](https://developer.splinks.co.jp/appendix/update-history): 本サイト公開後の更新履歴を一覧で確認できます。
- [レスポンスコード](https://developer.splinks.co.jp/appendix/response-code): 各決済サービスで利用するレスポンスコード・エラーコードの一覧です。クレジットカード決済のレスポンスコード（OK、K01〜K99、KBXなど）と、ID決済の各決済事業者（共通、WeChat Pay、Alipay、楽天ペイ、PayPay、メルペイ、d払い、au PAY、Alipay+、BitCash、atone、PayPal、Paidy）ごとのエラーコード・内容・対処方法を掲載しています。