مستندات زرین‌پال در دستیار هوش مصنوعی: کد پرداخت درست بنویسید

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

این سرور چیست و به چه کسی کمک می‌کند؟

سرور MCP یک اتصال بین دستیار هوش مصنوعی و یک سرویس است. این سرور رسمی زرین‌پال است و مستندات رسمی درگاه پرداخت را در اختیار دستیار می‌گذارد.

این ابزار به کار برنامه‌نویس‌هایی می‌آید که پرداخت زرین‌پال را به سایت یا برنامه خود اضافه می‌کنند. اگر از دستیار کمک می‌گیرید تا کد پرداخت بنویسید، دیگر لازم نیست نام فیلدها را از حافظه یا حدس بزنید. دستیار متن به‌روز مستندات را می‌خواند و همان را به شما نشان می‌دهد.

نکته مهم این است که این سرور فقط مستندات را در اختیار دستیار می‌گذارد. خود کد پرداخت را هنوز باید شما یا دستیار شما بنویسید و آزمایش کنید. این سرور جای آزمایش روی حساب واقعی را نمی‌گیرد.

این سرور چه کارهایی می‌کند؟

سرور چهار قابلیت دارد. هر کدام کار مشخصی را روی مستندات انجام می‌دهد و همه فقط مستندات را می‌خوانند:

• search_docs: در مستندات زرین‌پال جستجو می‌کند. برای پیدا کردن صفحه‌ای که درباره موضوع خاصی است، مفید است.
• get_doc: یک صفحه از مستندات را کامل می‌خواند. وقتی جزئیات یک درخواست را لازم دارید، این قابلیت متن کامل را می‌آورد.
• list_docs: فهرست صفحه‌های مستندات را نشان می‌دهد. اگر نمی‌دانید دنبال کدام صفحه بگردید، از این قابلیت شروع کنید.
• get_error_code: معنی کدهای وضعیت API پرداخت را توضیح می‌دهد. وقتی پرداخت با یک کد وضعیت برمی‌گردد، این قابلیت معنی آن کد را توضیح می‌دهد.

نمونه سؤال‌هایی که می‌توانید بپرسید

بعد از اتصال، سؤال‌های خود را ساده و مشخص بپرسید. دو نمونه:

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

می‌توانید بعد از پاسخ بپرسید: «این را در کد من اعمال کن» یا «صفحه کامل را بخوان و مهم‌ترین نکته‌ها را بگو». دستیار با همین سرور به سراغ متن دقیق صفحه می‌رود.

یک جریان ساده

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

نمونه سؤال‌ها را کلمه به کلمه کپی نکنید. هر سؤال را با نام برنامه، زبان کدنویسی و کاری که می‌خواهید انجام دهید بنویسید تا پاسخ دقیق‌تر شود. اگر پاسخ با متن صفحه جور درنمی‌آید، صفحه کامل را بخواهید و آن بخش را با پاسخ مقایسه کنید.

چطور وصل شوید؟

اگر برنامه شما اتصال سفارشی می‌خواهد، سرور از نوع HTTP است و با نشانی زیر وصل می‌شود:

https://www.zarinpal.com/docs/mcp

مراحل دقیق اتصال در هر برنامه با بقیه برنامه‌ها فرق دارد. برای جزئیات، راهنمای همان برنامه را ببینید.

محدودیت‌ها و نکته‌های مهم

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

جمع‌بندی

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