سفارش و خرید از طریق API
چرخهی کامل سفارش: ثبت با idempotency، پرداخت از کیف پول، انجام خودکار، پیگیری وضعیت و لغو.
چرخهی وضعیت
| status | معنی |
|---|---|
pending | ثبت و پرداخت شده، در صف انجام |
processing | در حال انجام |
completed | تحویل شد |
cancelled | لغو یا رد شد؛ مبلغ برگشت |
refunded | مبلغ برگشت داده شد |
failed | ناموفق |
raw_status وضعیت داخلی دقیق Stard را هم برای عیبیابی میدهد.
شیء سفارش
order
{
"object": "order",
"id": "ord_test_gGToQWxqOw89ssiL",
"order_id": null,
"environment": "test",
"status": "pending",
"raw_status": "pending",
"title": "پریمیوم ۳ ماهه (test)",
"product_id": 4518,
"product_tag": null,
"type": "product",
"quantity": 1,
"recipient": null,
"amount": {
"amount": 3788624,
"currency": "IRT"
},
"paid": {
"amount": 3788624,
"currency": "IRT"
},
"failure_reason": null,
"metadata": {
"invoice": "INV-1042"
},
"created_at": "2026-10-01T10:31:49Z",
"updated_at": "2026-10-01T10:31:49Z"
}پول و دقت
- مبلغ همان لحظهی ثبت از سرور محاسبه میشود؛ کلاینت هیچ مبلغی نمیفرستد.
- کسر موجودی اتمیک است؛ دو سفارش همزمان نمیتوانند بیش از موجودی خرج کنند.
- سفارش لغو یا ردشده دقیقاً با همان واحد (تومان یا TON) برمیگردد.
فروش از طریق API
ثبت آگهی فروش (یوزرنیم، گیفت و…) فعلاً فقط از مینیاپ و ربات Stard ممکن است، چون مالکیت آیتم باید در تلگرام تایید شود.
