توسعه‌دهندگان

SDK roadmap

SDK باید از API contract پایدار پیروی کند: ابتدا lifecycle و errors، سپس helper libraries.

نمای کلی

Roadmap برای SDK و نمونه‌های integration در PHP، JavaScript، Python و CRM/ERP scenarios.

اولویت‌ها

نمونه‌های اول payment sessions و webhook verification را پوشش می‌دهند؛ سپس helpers برای fiscal queue و reconciliation اضافه می‌شوند.

سازگاری

SDK نباید provider errors را پنهان کند: integrator باید retries، idempotency و terminal statuses را ببیند.

نحوه استفاده از این صفحه

SDK roadmap به هماهنگ شدن سناریوی پرداخت میان مالک کسب‌وکار، تیم توسعه و عملیات کمک می‌کند. پیش از راه‌اندازی باید کانال فروش، مسیر provider، مسئول webhook، بررسی وضعیت و پشتیبانی مشتری پس از پرداخت مشخص شود.

پرسش‌های متداول

Why should the API contract come before SDKs?

An SDK should follow a stable contract. If statuses, errors and webhook payloads still change, the library becomes a compatibility risk for integrators.

Which SDKs and examples should come first?

PHP/Laravel for websites and CRM, Node.js for webhook verification and Python/FastAPI for internal APIs are the most practical first examples. CMS examples should use the same server-side contract.