Zarinpal

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