zarinpal-mcp

MCP server for Zarinpal payment gateway (Iran). Supports payment creation, verification, refunds, sandbox mode, and transaction listing. Uses Merchant ID authentication in request body.

Tools (8)

| Tool | Description | |------|-------------| | create_payment | Create a payment request | | verify_payment | Verify a completed payment | | get_unverified | List unverified payments | | list_transactions | List payment transactions | | refund | Refund a payment | | create_sandbox_payment | Create a sandbox test payment | | get_fees | Calculate fees for an amount | | get_authority_status | Check payment status by authority |

Quick Start

{
  "mcpServers": {
    "zarinpal": {
      "command": "npx",
      "args": ["-y", "@theyahia/zarinpal-mcp"],
      "env": {
        "ZARINPAL_MERCHANT_ID": "<YOUR_MERCHANT_ID>"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | ZARINPAL_MERCHANT_ID | Yes | Merchant ID from Zarinpal dashboard |

Demo Prompts

• "Create a payment for 100000 IRR with callback to https://mysite.com/pay"
• "Verify payment with authority A000..."
• "List all unverified payments"
• "Refund 50000 IRR for authority A000..."
• "Create a sandbox test payment"

License

MIT