API عامل IMBA: کاتالوگ پیشپرداخت
API عامل یک رابط HTTP برای برنامههایی است که خودشان پرداخت میکنند — بدون انسان در اپ IMBA Wallet. برای صدور کارت مجازی و خرید eSIM یا گیفتکارت با USDT پیشپرداخت.
ثبت کلید Ed25519، واریز USDT در TRC-20، خرید کاتالوگ زنده (کارت Visa، eSIM، گیفتکارت). عامل جدید از سطح ۰ شروع میکند: فقط کاتالوگ. راهنمای خرید: English playbook · فارسی.
حقایق
| کیست | عاملهای خودمختار. Register فقط هویت است. بدون KYB WaaS. |
|---|---|
| Auth | POST /auth/v1/agent/register سپس assertion → /auth/v1/agent/token. JWT با typ=agent و client_id، EdDSA. JWKS: GET /auth/v1/partner/jwks. |
| پول | دفتر 2401 USDT. Register موجودی نمیدهد. |
| واریز | فقط USDT TRC-20. قبل از هر ارسال POST /api/deposit_address. اسلات بدون واریز ۲۴ ساعت. پس از اولین اعتبار آدرس ثابت میشود. |
| خرید | URLهای خردهفروشی. ext_id لازم است. Stars → 403. |
| سطوح | سطح ۰: واریز + کاتالوگ. Convert در سطح ۰ بسته است — AML: وگرنه کانال پیشپرداخت برای پولشویی از طریق سرویس استفاده میشود. سطح ۱+: اپراتور پس از خرید واقعی کاتالوگ. Convert در سطح ۱ فقط با درخواست جداگانه است، نه همراه با عدد. برداشت بسته است. عامل C2C نمیفرستد؛ انسان میتواند با client_id عامل را شارژ کند. خود عامل سطح را بالا نمیبرد. سیاست سطوح. |
| ممنوع | برداشت، C2C بهعنوان پرداختکننده، Stars، EVM، BTC، /api/partner/*. Convert در سطح ۰ بسته است؛ در سطح ۱ — با درخواست جداگانه. |
| OTP | نه SMS و نه تلگرام. email اختیاری در register یا PATCH وبهوک — نامه به همان آدرس. همیشه notifications (فیلد code میماند). اگر callback_url باشد، فیلد وبهوک otp است. |
| KYT | گزارش پولی آدرس: kyt_quote، kyt_check (tron_usdt / eth / btc). قبل از واریز یا بعد از مسدود شدن نامفهوم. واریز را گیت نمیکند. |
| MCP | Docs: npx -y @imba_wallet/agent-mcp-docs یا /mcp/docs. Spend: npx -y @imba_wallet/agent-mcp با کلید Ed25519 خودتان، یا /mcp/spend. سازمان npm: @imba_wallet. |
| اسناد | api-docs · OpenAPI · well-known · npm docs · راهنمای کامل: English |
MCP
دو سرور Model Context Protocol. سازمان npm برابر @imba_wallet است (زیرخط). اسکوپ @imbawallet روی npm وجود ندارد.
- Docs: سیاست. Remote /mcp/docs.
npx -y @imba_wallet/agent-mcp-docs. - Spend: واریز USDT TRC-20 و خرید کاتالوگ با کلید Ed25519 شما.
npx -y @imba_wallet/agent-mcp. نه JWT کیف پول. نه برداشت، C2C یا convert.
قوانین واریز (اجباری)
- دوباره
deposit_addressرا صدا بزنید — آدرس را از چت یا اجرای قبلی کپی نکنید. - رشته آدرس را با مقصد تراکنش بیتبهبیت مقایسه کنید.
- فقط USDT TRC-20.
- پس از TTL به آدرس قدیمی نفرستید.
- فقط پس از
confirmation_blocksموجودی را خرجشده بدانید.
بخوانید
پرسشهای متداول
میتوان آدرس TRON را ذخیره کرد؟
خیر. تا اولین اعتبار، اسلات پس از ۲۴ ساعت ممکن است به دیگری برسد.
سطح ۰ و سطح ۱: convert چیست؟
هر عامل جدید از سطح ۰ شروع میکند: واریز USDT TRC-20 و خرید کارت، eSIM یا گیفت. Convert در سطح ۰ بسته است — AML: وگرنه کانال پیشپرداخت برای پولشویی از طریق سرویس استفاده میشود. سطح ۱ را اپراتور پس از خرید واقعی کاتالوگ میدهد تا کسانی که فقط میخواهند رمزارز بچرخانند رد شوند. Convert در سطح ۱ فقط با درخواست جداگانه است؛ بالا رفتن عدد convert را روشن نمیکند. برداشت بسته است. عامل C2C نمیفرستد؛ انسان میتواند با client_id عامل را شارژ کند. خود عامل سطح را بالا نمیبرد.
OTP سهبعدی را چگونه میگیرم؟
نه SMS و نه تلگرام. email در register یا PATCH — نامه. همچنین notifications (کد در payload میماند). اگر وبهوک دارید، فیلد otp است.
MCP را چگونه وصل کنم؟
سازمان npm برابر @imba_wallet است، نه @imbawallet. Docs: npx -y @imba_wallet/agent-mcp-docs. Spend: npx -y @imba_wallet/agent-mcp با کلید خودتان. ChatGPT Actions نباید spend را صدا بزند.