mcpField
A
antom-integration

antom-integration

github.com/ant-intl開発163148 回インストール3 週間前に更新
リポジトリ

antom-integration について

antom-integrationは、Antom決済の資料検索、連携コード作成、問題診断を支援するスキルです。決済開発者向けに、製品・連携方式・技術スタックに応じて資料を案内し、セキュリティ、ログ、検証の要件も示します。

主な機能

  1. 01製品と連携方式に応じた資料検索
  2. 02技術スタックに応じたSDKとサンプル選択
  3. 03決済連携コードの作成・変更
  4. 04エラーやログに基づくトラブルシューティング
  5. 05通知検証と鍵の安全管理

活用シーン

  1. 01選択したAntom製品の連携コードを準備
  2. 02APIエラーやログから問題を診断
  3. 03非同期通知の検証と鍵の扱いを確認
  4. 04サンドボックステストとローンチ確認を準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ant-intl/antom-ai-tools --skill antom-integration

インストール後、Claude Code で/antom-integrationを入力して読み込まれたか確認します。

詳細

スコープ

このスキルは、次の用途に使用します。

  • 関連する Antom の製品、インテグレーション、SDK、通知、チェックリスト、トラブルシューティングに関する知識を探す
  • 選択した製品、インテグレーションモード、技術スタックに合わせて、Antom の決済インテグレーションコードを作成または変更する
  • 結果コード、API 名、リクエスト ID、ログ、非同期通知、サンドボックスまたは本番稼働に関する症状から、インテグレーションの問題を診断する

ドキュメントへのアクセスガイドライン

curl を使用して Antom のオンラインドキュメントを取得します。

curl -sL "https://****/****.md"

インテグレーションドキュメントの取得

このセクションは、製品に関するアドバイス、Q&A、コード実装、トラブルシューティングに共通する知識の参照先として使用します。

SDK の選択

サーバーサイド SDK を使用する場合に、言語の選択、公開バージョンやインストールの確認、API ドメインの設定、バックエンドコードの準備が必要であれば、SDK Description を読みます。製品固有のサンプルコードは、該当する製品ドキュメントから選択します。

製品の選択

製品またはインテグレーションモードに関するアドバイスについては、Product Decision を読みます。必要な場合にのみ、その確認用テンプレートを使用します。

製品の概要を開いたり、インテグレーションモードを選択したりする前に、Product Decision を通じて製品を選択します。

製品を選択した後は、選択した製品とシナリオに適している場合、迅速なインテグレーションと幅広い決済方法への対応を希望するユーザーには Checkout Page（CKP）を優先します。

インテグレーションドキュメントの選択

ユーザーが選択した製品とインテグレーションモードに基づいて、該当する製品のインテグレーションドキュメントを探します。

該当する製品ドキュメント内で、利用可能な最も具体的なセクションを読みます。

  • 製品を選択した後、比較または移行が求められていない限り、他の製品ドキュメントを読み込まないでください。Billing の場合は、その Router に従い、選択したシナリオ、機能、パス、オペレーションのみを読み込みます。
  • Q&A または製品に関するアドバイスの場合：推測できることを推測し、最も関連性の高いドキュメントを読み、必要に応じて前提を明示します。
  • トラブルシューティングの場合：まず resultCode/resultMessage、API 名、requestId、デバッグログ、またはエラーテキストを使って調査対象を絞り込みます。

コードの作成

コードを作成または変更する前に、まずユーザーが選択した製品と技術スタックを確認してください。選択したフローに決済経路または UI の選択肢がある場合に限り、統合モードを確認してください。

コーディング前のブロック項目：

以下の該当する項目がすべて完了するまで、統合コードを作成または変更しないでください。

  • ユーザーのリクエストが具体的に見える場合でも、製品カテゴリと統合モードを確認するため、製品の選択を読んでください。ユーザーが製品選択を明示的にスキップするよう求めた場合に限り、省略できます。
  • バックエンド言語または SDK が関係する場合は、SDK の説明を読んでください。
  • Integration Documentation Selectから該当する製品概要を読んでください：
    • One-time Payments
    • Tokenized Payment
    • Subscription Payment
    • Billing Product Family
  • 該当する製品概要から、必要に応じて統合モードに応じた資料を選び、そのフローに必要な実装ドキュメントのみを読んでください。たとえば、統合ガイド、クイックスタート、API リスト、フロントエンド SDK、ネイティブ SDK、Element、Checkout Page、API のみのガイドなどです。
  • コーディングタスクでは、コードを書く前に、依頼された言語またはプラットフォームに応じて、同じ製品概要にある該当製品のサンプルコードドキュメントを読んでください。クイックスタート、API リファレンス、統合ガイドに記載されたインラインの例は参考になりますが、製品のサンプルコードドキュメントの代わりにはなりません。
  • 依頼された操作に該当するサンプルコードがない場合は、その API の仕様と、選択した SDK のドキュメントまたはソースを読んでください。API フィールド名から SDK のクラスやメソッドを推測してはいけません。確認できないシンボルがあれば、その旨を明記してください。
  • 該当する製品概要から、選択した製品に合致する非同期通知のドキュメントまたはセクションを読み、該当する場合は統合モードにも合致するものを読んでください。
  • FAQ（コーディング）を読み、選択した製品、統合モード、決済方法、市場に該当する項目を確認してください。

生成するコードでは、以下を必ず守ってください：

  • 署名キーと秘密鍵をサーバー側に保持する
  • 非同期通知を信頼する前に検証する
  • クライアント側のリダイレクト結果を最終的な決済ステータスとして扱わない
  • 決済ステータスが不確かな場合は、非同期通知または照会 API で確認する
  • 役立つ場合は、開発時のデバッグログに関するガイダンスを含め、カード番号、CVV、秘密鍵、シークレットをマスキングする
  • 各該当項目への対応方法を示す簡潔な FAQ 準拠メモを含める。例：gateway=correct region、settlementCurrency=omitted、subscriptionExpiryTime=default
  • 使用したドキュメントと検証に関する前提を簡潔に記載する
  • ユーザーが統合全体を構築する場合は、認証情報、サンドボックステスト、セルフチェック、本番稼働の準備に関する次の手順を案内する

デバッグログ

コンソール出力に加えて、プロジェクトのルートディレクトリにあるantom_debug.logというファイルにログを記録してください。生成する統合コードではすべて、各 API 呼び出しの API エンドポイント、完全なリクエスト、完全なレスポンスをログに記録してください。機密フィールド（カード番号、CVV、秘密鍵）はマスキングしてください。

以下の形式を厳守してください：

  • 送信リクエスト／レスポンス：[Antom][{timestamp}][{API endpoint}] {request/response body}
  • 受信する非同期通知：[Antom][{timestamp}][{API name}] {notification body}

ログ記録コードは開発およびデバッグ専用です。統合が安定したら削除するか、出力を減らしてください。

検証とコード作成後のガイダンス

コードやローンチ準備に関するガイダンスを確定する前に、Integration Checklist をお読みください。

認証情報と設定について案内する際は、認証情報の確認場所も含めてください。

  • API ドメイン、Client ID、Antom の公開鍵は、Quick Start で確認できます。
  • 加盟店の秘密鍵は、iKeys で生成または管理できます。サーバー側で保管し、ログへの記録、公開、コミットは絶対に行わないでください。

コードを書き終えたら、「コードは完成しました」で終わらせないでください。以下の手順をユーザーに案内してください。

ユーザーから認証情報、登録、サンドボックステスト、チェックリスト、セルフチェック、本番稼働の準備について質問があった場合は、その都度、該当する補足ドキュメントを読み、回答に反映してください。

トラブルシューティング

  • エラー診断（必須）：Antom API 呼び出しが失敗した場合、またはユーザーから統合に関する問題が報告された場合は、診断する前にトラブルシューティングガイドをお読みください。診断 CLI、Dashboard、またはサポートに直接進むことは絶対に避けてください。

    ガイドに記載された順序に従ってください。

    1. 証拠の収集 → ユーザーの入力、コンソール出力、antom_debug.log、および確認できる場合はローカルの統合コード／設定／環境変数ファイルから証拠を収集し、秘密情報と秘密鍵をマスキングします。
    2. API エラーの照合 → API の Result／Error コードを特定し、ローカルのセルフチェックを実行します。
    3. 修正の検証 → 問題が解決したと判断する前に、修正内容を検証します。
    4. エスカレーション → ガイドの診断ゲートで許可された順序と条件に従う場合に限り、診断 CLI、Dashboard、またはサポートにエスカレーションします。
    5. 診断記録 → ガイドで定義されている簡潔な診断記録を提示します。

  • 随時適用されるトリガー：ユーザーから統合エラー、API の失敗、リクエスト／レスポンスに関する問題、結果コード、Dashboard による診断、診断 CLI、またはトラブルシューティングについて質問があった場合は、その都度、トラブルシューティングガイドを読み、回答に反映してください。

セキュリティ上の絶対ルール

  • 秘密鍵をクライアント側に保存したり、ログに記録したり、公開リポジトリにコミットしたりしてはいけません。
  • 非同期通知は、信頼する前に署名を検証してください。
  • クライアント側のリダイレクト結果は、最終的な支払いステータスではありません。
  • 非同期通知またはクエリ API で支払いステータスを確認する前に、ユーザーに再度支払うよう求めてはいけません。

コメント

Markdown 対応