English Français العربية

io.github.jpbester/payfast

Registre officiel Finance et paiements

MCP server for PayFast — AI assistants interact with South Africa's payment gateway

Code source Documentation

Que pouvez-vous faire avec io.github.jpbester/payfast ?

  • Transaction management — fetch transaction details, query history, process tokenized charges
  • Subscription management — fetch, pause, unpause, cancel, update, and ad-hoc charge subscriptions
  • Refund processing — create refunds (full or partial) and query refund status
  • Credit card queries — look up credit card transaction details
  • Sandbox support — defaults to sandbox mode for safe testing
  • Secure by design — credentials via environment variables only, sensitive data never logged

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package payfast-mcp
Claude Code 
claude mcp add payfast -e 'PAYFAST_MERCHANT_ID=<PAYFAST_MERCHANT_ID>' -e 'PAYFAST_MERCHANT_KEY=<your payfast_merchant_key>' -e 'PAYFAST_PASSPHRASE=<your payfast_passphrase>' -e 'PAYFAST_ENVIRONMENT=<PAYFAST_ENVIRONMENT>' -- npx -y payfast-mcp@1.0.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "payfast": {
            "command": "npx",
            "args": [
                "-y",
                "payfast-mcp@1.0.1"
            ],
            "env": {
                "PAYFAST_MERCHANT_ID": "<PAYFAST_MERCHANT_ID>",
                "PAYFAST_MERCHANT_KEY": "<your payfast_merchant_key>",
                "PAYFAST_PASSPHRASE": "<your payfast_passphrase>",
                "PAYFAST_ENVIRONMENT": "<PAYFAST_ENVIRONMENT>"
            }
        }
    }
}

Variables d'environnement

  • PAYFAST_MERCHANT_ID obligatoire Your PayFast merchant ID
  • PAYFAST_MERCHANT_KEY obligatoire secret Your PayFast merchant key
  • PAYFAST_PASSPHRASE obligatoire secret Your PayFast API passphrase
  • PAYFAST_ENVIRONMENT PayFast environment: 'sandbox' or 'production' (defaults to sandbox)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. payfast-mcp
  2. Features
  3. Available Tools
  4. Quick Start
  5. Development
  6. License

payfast-mcp

A Model Context Protocol (MCP) server for PayFast, South Africa's leading payment gateway. Enables AI assistants like Claude to securely interact with your PayFast merchant account.

Features

  • Transaction management — fetch transaction details, query history, process tokenized charges
  • Subscription management — fetch, pause, unpause, cancel, update, and ad-hoc charge subscriptions
  • Refund processing — create refunds (full or partial) and query refund status
  • Credit card queries — look up credit card transaction details
  • Sandbox support — defaults to sandbox mode for safe testing
  • Secure by design — credentials via environment variables only, sensitive data never logged

Available Tools

ToolDescriptionRisk
pingTest API connectivityLow
transaction_fetchGet transaction by IDLow
transaction_historyQuery transaction historyLow
transaction_chargeCharge a stored tokenMedium
subscription_fetchGet subscription detailsLow
subscription_pausePause a subscriptionHigh
subscription_unpauseResume a subscriptionMedium
subscription_cancelCancel a subscriptionHigh
subscription_updateUpdate subscription termsHigh
subscription_adhocAd-hoc subscription chargeHigh
refund_createProcess a refundHigh
refund_fetchGet refund detailsLow
creditcard_fetchQuery card transactionLow

High-risk operations require human approval before execution.

Quick Start

Prerequisites
Installation
npm install -g payfast-mcp

Or run directly with npx:

npx payfast-mcp
Configuration

Set the following environment variables:

VariableRequiredDescription
PAYFAST_MERCHANT_IDYesYour PayFast Merchant ID
PAYFAST_MERCHANT_KEYYesYour PayFast Merchant Key
PAYFAST_PASSPHRASEYesYour PayFast API Passphrase
PAYFAST_ENVIRONMENTNosandbox (default) or production

You can also create a .env file in your working directory.

Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "payfast": {
      "command": "npx",
      "args": ["-y", "payfast-mcp"],
      "env": {
        "PAYFAST_MERCHANT_ID": "your-merchant-id",
        "PAYFAST_MERCHANT_KEY": "your-merchant-key",
        "PAYFAST_PASSPHRASE": "your-passphrase",
        "PAYFAST_ENVIRONMENT": "sandbox"
      }
    }
  }
}
Claude Code

Add to your Claude Code settings:

claude mcp add payfast \
  -e PAYFAST_MERCHANT_ID=your-merchant-id \
  -e PAYFAST_MERCHANT_KEY=your-merchant-key \
  -e PAYFAST_PASSPHRASE=your-passphrase \
  -e PAYFAST_ENVIRONMENT=sandbox \
  -- npx -y payfast-mcp
Cursor

Add to your Cursor MCP config (.cursor/mcp.json for project-level, or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "payfast": {
      "command": "npx",
      "args": ["-y", "payfast-mcp"],
      "env": {
        "PAYFAST_MERCHANT_ID": "your-merchant-id",
        "PAYFAST_MERCHANT_KEY": "your-merchant-key",
        "PAYFAST_PASSPHRASE": "your-passphrase",
        "PAYFAST_ENVIRONMENT": "sandbox"
      }
    }
  }
}
Codex

Add via the Codex CLI:

codex mcp add payfast \
  --env PAYFAST_MERCHANT_ID=your-merchant-id \
  --env PAYFAST_MERCHANT_KEY=your-merchant-key \
  --env PAYFAST_PASSPHRASE=your-passphrase \
  --env PAYFAST_ENVIRONMENT=sandbox \
  -- npx -y payfast-mcp

Or add directly to ~/.codex/config.toml:

[mcp_servers.payfast]
command = "npx"
args = ["-y", "payfast-mcp"]

[mcp_servers.payfast.env]
PAYFAST_MERCHANT_ID = "your-merchant-id"
PAYFAST_MERCHANT_KEY = "your-merchant-key"
PAYFAST_PASSPHRASE = "your-passphrase"
PAYFAST_ENVIRONMENT = "sandbox"

Development

# Clone the repo
git clone https://github.com/jpbester/payfast-mcp.git
cd payfast-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run with MCP Inspector
npm run inspect

License

MIT

Questions fréquentes

Qu'est-ce que io.github.jpbester/payfast ?

MCP server for PayFast — AI assistants interact with South Africa's payment gateway

Comment installer io.github.jpbester/payfast ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add payfast -e 'PAYFAST_MERCHANT_ID=<PAYFAST_MERCHANT_ID>' -e 'PAYFAST_MERCHANT_KEY=<your payfast_merchant_key>' -e 'PAYFAST_PASSPHRASE=<your payfast_passphrase>' -e 'PAYFAST_ENVIRONMENT=<PAYFAST_ENVIRONMENT>' -- npx -y payfast-mcp@1.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.jpbester/payfast ?

Oui. Il attend PAYFAST_MERCHANT_ID, PAYFAST_MERCHANT_KEY, PAYFAST_PASSPHRASE, à renseigner dans sa configuration.

io.github.jpbester/payfast est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.jpbester/payfast ?

Il est publié par jpbester. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.