# مستندات زرین‌پال (ZarinPal Docs)

دستیارتان مستندات رسمی درگاه پرداخت زرین‌پال را جستجو می‌کند، صفحه‌ها را می‌خواند و کدهای خطا را توضیح می‌دهد

- نوع: سرور MCP
- دسته: پرداخت و بانک
- منبع: رسمی
- سازنده: ZarinPal (https://www.zarinpal.com)
- آخرین بررسی: 2026-10-06
- صفحه: https://mcpfarsi.ir/servers/zarinpal-docs/
- وب‌سایت سرویس: https://www.zarinpal.com/docs/

## نصب

- نشانی سرور (http): https://www.zarinpal.com/docs/mcp
- بدون نصب: از راه روتر MCP (https://mcp.mcpfarsi.ir/mcp، ورود با OAuth)؛ راهنما: https://mcpfarsi.ir/start/

## API مستندات زرین‌پال

- REST API روتر MCP همین ابزار را برای اسکریپت و برنامه هم اجرا می‌کند: `GET https://mcpfarsi.ir/api/v1/tools?q=` قابلیت‌ها و آرگومان‌هایشان را برمی‌گرداند و `POST https://mcpfarsi.ir/api/v1/call` یکی را اجرا می‌کند. شناسهٔ سرور: `zarinpal-docs`.
- اول ابزار را در داشبورد به ابزارهای خودتان اضافه کنید، بعد کلید API را در https://mcpfarsi.ir/dashboard/?tab=access بسازید و با `Authorization: Bearer <کلید>` بفرستید. هر اجرای موفق از سقف طرح کم می‌شود (https://mcpfarsi.ir/pricing/).

```sh
curl "https://mcpfarsi.ir/api/v1/tools?q=zarinpal-docs&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST "https://mcpfarsi.ir/api/v1/call" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"server": "zarinpal-docs", "tool": "search_docs", "arguments": {}}'
```

## ابزارها

- `search_docs`: جستجو در مستندات زرین‌پال
- `get_doc`: خواندن کامل یک صفحه از مستندات
- `list_docs`: فهرست صفحه‌های مستندات
- `get_error_code`: توضیح معنی کدهای وضعیت API پرداخت

## نمونه سؤال‌ها

- کد خطای منفی ۵۱ زرین‌پال یعنی چه و چطور باید با آن برخورد کنم؟
- طبق مستندات زرین‌پال، درخواست تأیید پرداخت چه فیلدهایی دارد؟

## توضیحات

این سرور رسمی زرین‌پال، مستندات فارسی درگاه پرداخت را مستقیم در اختیار دستیار هوش مصنوعی شما می‌گذارد. به کار برنامه‌نویس‌هایی می‌آید که پرداخت زرین‌پال را به سایت یا برنامه خود اضافه می‌کنند: وقتی Claude یا Cursor کد پرداخت می‌نویسد، به‌جای حدس زدن نام فیلدها و کدهای خطا، متن به‌روز مستندات را می‌خواند.

- فقط مستندات است و هیچ تراکنشی انجام نمی‌دهد؛ کلید API یا حساب لازم ندارد.
- برای رعایت نکته‌های امنیتی در کد پرداخت، آن را کنار مهارت «اتصال به درگاه پرداخت» نصب کنید.
