Satim支払いゲートウェイの統合

AlgeriaのSATIM支払いゲートウェイシステムと統合するためのモデルコンテキストプロトコル(MCP)サーバー。 サーバは、SATIM-ePAYプラットフォームを介してCIB/Edhabiaカード決済を処理するための構造インターフェイスを提供します。 このパッケージは、Cursor、Claude、CopilotなどのAIアシスタントが、標準化されたインターフェイスでアカウントデータを直接アクセスできるようにします。

クイックスタート

コンテンツの表

1. 取付け
2. 構成
3. 支払の流れ
4. ツール
5. テスト
6. 統合要件
7. エラー処理
8. 事例
9. セキュリティの考慮事項

インストール

前提条件

• Node.js 18 +
• npmかヤーン

##ステップバイステップセットアップ

1.プロジェクトディレクトリのクローンと入力:

2.プロジェクトを初期化(package.jsonが存在しない場合):

3.ESモジュール用のpackage.jsonの設定:

4.依存関係のインストール:

サーバーの実行

###Option 1: tsx で直接実行 (開発のために推奨)

####Option 2:コンパイルと実行

####Option 3:自動リロードによる開発モード

設定

MCP クライアント構成

MCP クライアント (Claude Desktop のような) でこのサーバーを使用するには、設定を追加します

Obviously you should have already an account created and working to get credentials from here : https://cibweb.dz/fr/login

Satim Payment Gateway Integration

A Model Context Protocol (MCP) server for integrating with the SATIM payment gateway system in Algeria. The server provides a structured interface for processing CIB/Edhahabia card payments through the SATIM-ePAY platform. This package enables AI assistants like Cursor, Claude, and Copilot to directly access your account data through a standardized interface.

Quick Start

# Clone the repository
git clone https://github.com/zakblacki/Satim-Payment-Gateway-Integration.git
cd satim-payment-gateway-integration

# Install dependencies
npm install

# Run the server
npx tsx satim-mcp-server.ts
or
npm run dev

# Demo 
Launch index.html

Table of Contents

1. Installation
2. Configuration
3. Payment Flow
4. Tools
5. Testing
6. Integration Requirements
7. Error Handling
8. Examples
9. Security Considerations

Installation

Prerequisites

• Node.js 18+
• npm or yarn

Step-by-Step Setup

1. Clone and enter the project directory:

git clone https://github.com/zakblacki/Satim-Payment-Gateway-Integration.git
cd satim-payment-gateway-integration

2. Initialize the project (if package.json doesn’t exist):

npm init -y

3. Configure package.json for ES modules:

npm pkg set type=module

4. Install dependencies:

# Core dependencies
npm install @modelcontextprotocol/sdk axios

# Development dependencies
npm install --save-dev typescript @types/node tsx

Running the Server

Option 1: Direct execution with tsx (Recommended for development)

npx tsx satim-mcp-server.ts

Option 2: Compile and run

# Compile TypeScript
npm run build

# Run compiled JavaScript
npm start

Option 3: Development mode with auto-reload

npm run dev

Configuration

MCP Client Configuration

To use this server with an MCP client (like Claude Desktop), add to your configuration:

{
  "mcpServers": {
      "satim-payment": {
       "command": "npx",
       "args": ["@devqxi/satim-payment-gateway-mcp"],
       "env": {
        "SATIM_USERNAME": "your_test_username",
        "SATIM_PASSWORD": "your_test_password",
        "NODE_ENV": "development"
      }
    }
  }
}

Initial Setup

Before using any payment tools, configure your SATIM credentials: