萨蒂姆支付网关集成

与阿尔及利亚SATIM支付网关系统整合的示范背景协议服务器。 该服务器为通过SATIM-ePAY平台处理CIB/Edhamabia卡付款提供结构化接口. 这个软件包可以让Cursor,Claude等AI助手和Copilot通过标准化接口直接访问您的账户数据.

□ 快开始

□ 目录

1. 安装
2. 配置
3. 付款流量
4. 工具
5. 测试
6. 一体化要求
7. 处理错误
8. 实例
9. 安全考虑

□ 安装

· 先决条件

• 节点.js 18+
• Npm或纱线

QQ 步入设置

1. ** 单位并输入项目目录:**

2. ** 启动项目(如果包.json不存在):**

3. ** ES模块配置软件包.json:**

4. ** 建立附属关系:**

QQ 运行服务器

备选1:与tsx直接执行(建议用于发展)

备选2:汇编并运行

备选3:自动重载的开发模式

□ 配置

QQ 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: