← جزئیات سرویس

مستندات پرداخت ایران

زرین‌پال: ایجاد، تأیید و وضعیت پرداخت (ریال) با پشتیبانی Sandbox.

معرفی

زرین‌پال: ایجاد، تأیید و وضعیت پرداخت (ریال) با پشتیبانی Sandbox.

احراز هویت

صدور API Key از پنل کاربری در نسخه‌های بعدی فعال می‌شود. تست عمومی از صفحه جزئیات بدون کلید و با محدودیت نرخ انجام می‌شود.

Endpoint تست

POST /Mcp/ExecuteTool
Content-Type: application/json

{ "slug": "payment-iran", "tool": "TOOL_NAME", "arguments": { } }

Tools

payment_gateway_info

بدون فراخوانی شبکه

Parameters (Input Schema)
{"type":"object","properties":{"sandbox":{"type":"string","description":"true/false"}},"required":[]}
Response (Output Schema)
{"type":"object"}
payment_create

amount ریال + callbackUrl → authority و paymentUrl

Parameters (Input Schema)
{"type":"object","properties":{"amount":{"type":"integer","description":"ریال"},"callbackUrl":{"type":"string","description":"URL بازگشت"},"description":{"type":"string","description":"توضیح"},"email":{"type":"string","description":"ایمیل"},"mobile":{"type":"string","description":"موبایل"},"merchantId":{"type":"string","description":"مرچنت"},"sandbox":{"type":"string","description":"true تست"}},"required":["amount","callbackUrl"]}
Response (Output Schema)
{"type":"object"}
payment_verify

authority + amount

Parameters (Input Schema)
{"type":"object","properties":{"authority":{"type":"string","description":"Authority"},"amount":{"type":"integer","description":"ریال"},"merchantId":{"type":"string","description":"مرچنت"},"sandbox":{"type":"string","description":"true تست"}},"required":["authority","amount"]}
Response (Output Schema)
{"type":"object"}
payment_status

معادل verify

Parameters (Input Schema)
{"type":"object","properties":{"authority":{"type":"string","description":"Authority"},"amount":{"type":"integer","description":"ریال"}},"required":["authority","amount"]}
Response (Output Schema)
{"type":"object"}

Error Codes

  • INVALID_ARGUMENT
  • NOT_FOUND
  • FORBIDDEN
  • SERVICE_UNAVAILABLE
  • TIMEOUT
  • INTERNAL_ERROR

Pricing / Rate Limits

نیاز به Credential — محدودیت دقیق از تنظیمات پلتفرم اعمال می‌شود.