# 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）を掲載しています。

## 決済別仕様

- [ID決済とは](https://developer.splinks.co.jp/payment-specification/id-payment): ID決済の概要を説明しています。エンドユーザーが ID決済事業者のアカウントで認証し、チャージ残高や登録済みクレジットカードで支払える決済サービスで、PayPay など複数の決済手段を一括で導入できます。
- [インターフェイス概要](https://developer.splinks.co.jp/payment-specification/id-payment): ID決済で利用できるインターフェイスや課金方式、売上方式を説明しています。利用可能なインターフェイスは「オンライン」と「加盟店管理画面」で、対応する組み合わせは各種一覧で確認できます。
- [API一覧](https://developer.splinks.co.jp/payment-specification/id-payment): ID決済で利用する API の一覧です。18Auth（支払）、18RecStart（継続課金契約）、18RecAuth（継続課金支払）、18Search（同期）、18Refund（返金）、18RecSearch（継続課金同期）、18RecCancel（継続課金解約）、18Capture（売上確定）、18Change（金額変更）、18Cancel（与信取消）を掲載しています。
- [処理フロー](https://developer.splinks.co.jp/payment-specification/id-payment): ID決済の各 API における処理フローを、加盟店、e-SCOTT、ID決済事業者、エンドユーザー間の通信シーケンスとして説明しています。18Auth、18RecStart、18RecAuth、18Search、18Refund、18RecSearch、18RecCancel、18Capture、18Change、18Cancel、18Change（PayPay 増額時）、同期処理の全12処理を収録しています。
- [API仕様](https://developer.splinks.co.jp/payment-specification/id-payment): ID決済 API の接続先 URL、Master電文、Process電文、POST電文の項目定義に加え、POST電文の再送や処理通番の自動採番規定などの留意事項をまとめています。
- [コード定義](https://developer.splinks.co.jp/payment-specification/id-payment): ID決済で使用する取引ステータス、決済手段、サブ決済手段、支払方式、商品種別、商品カテゴリ、解約方式、商品受取場所、性別、本人確認ステータス、過去利用決済などのコード値一覧を掲載しています。
- [各種一覧](https://developer.splinks.co.jp/payment-specification/id-payment): ID決済に関する各種一覧です。即時売上と出荷売上それぞれの課金方式対応表、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): 本サイト公開後の更新履歴を一覧で確認できます。
- [レスポンスコード（ID決済）](https://developer.splinks.co.jp/appendix/response-code): ID決済で利用するレスポンスコードの一覧です。レスポンスコードを顧客向け画面に表示しないことという留意事項に加え、OK（許可応答）、K01〜K99（各種精査エラー・障害）、KBX（該当取引なし）などのコード値、内容、対処方法を掲載しています。