نخستین پرسش هر توسعه‌دهنده درباره یک سرویس زیرساختی این است: از لحظه گرفتن کلید دسترسی تا اولین نتیجه واقعی چقدر راه است؟ در زربان سازمانی این مسیر سه گام دارد و در پایان آن، واریز کاربر به سامانه شما اعلام می‌شود.
این راهنما هر گام را با درخواست واقعی نشان می‌دهد. نام نقاط پایانی، پارامترها و رویدادها همان است که در مستندات آمده است.
خلاصه مطلب: در گام اول کلید دسترسی را از داشبورد برمی‌دارید. در گام دوم برای کاربر حساب می‌سازید و آدرس واریز او را می‌گیرید. در گام سوم نشانی وب‌هوک خودتان را ثبت می‌کنید تا زربان رویداد واریز را بلادرنگ بفرستد. در هیچ‌یک از این گام‌ها به دانش قرارداد هوشمند نیاز ندارید.
گام اول: کلید دسترسی بگیرید
تیم زربان سازمان شما را می‌سازد. پس از آن وارد داشبورد می‌شوید و کلید دسترسی را از بخش کلیدها برمی‌دارید. همه درخواست‌های بعدی با همین کلید احراز می‌شوند.
داشبورد برای هر عضو تیم نقش جداگانه تعریف می‌کند. بنابراین توسعه‌دهنده به کلیدها و وب‌هوک‌ها دسترسی دارد و تیم مالی حساب‌ها و تراکنش‌ها را می‌بیند.
گام دوم: حساب و آدرس واریز بسازید
برای هر کاربر یک حساب می‌سازید. شناسه کاربر در سامانه خودتان را هم در همین درخواست می‌فرستید تا بعداً حساب را با همان شناسه پیدا کنید:
POST /accounts
{ "entityId": "PLN", "externalId": "user_8412" }
سپس آدرس واریز همان حساب را برای رمزارز و شبکه دلخواه می‌گیرید:
GET /accounts/1234/coindepositaddress?symbol=USDT&network=tron
این آدرس به همان کاربر اختصاص دارد. آن را در اپلیکیشن خودتان به کاربر نشان می‌دهید.
گام سوم: وب‌هوک را وصل کنید
نشانی وب‌هوک1 را در داشبورد ثبت می‌کنید و رویدادهای دلخواه را انتخاب می‌کنید. از آن پس، هر بار که واریزی برسد، زربان درخواستی به نشانی شما می‌فرستد:
POST https://your-app.ir/webhooks
{ "name": "WebhookTransactionCoinDeposit" }
سامانه شما با دریافت این رویداد موجودی کاربر را به‌روز می‌کند. زربان هر درخواست را امضا می‌کند و کلید امضا در داشبورد در دسترس شماست.
پیش از انتشار چه چیزهایی را بررسی کنیم؟
- امضای هر رویداد را بررسی کنید تا از اصالت آن مطمئن شوید.
- شناسه کاربر را در هنگام ساخت حساب بفرستید تا تطبیق حساب‌ها ساده بماند.
- گزارش تحویل وب‌هوک‌ها را در داشبورد مرور کنید و از رسیدن رویدادها مطمئن شوید.
- یکپارچه‌سازی را ابتدا در سازمان آزمایشی امتحان کنید.
کلید دسترسی سازمان خودتان را بگیرید
شماره‌تان را بگذارید تا در ساعات کاری تماس بگیریم و راه‌اندازی سازمان شما را شروع کنیم.
پس از اولین واریز
همین سه گام پایه همه محصول‌های دیگر است. برداشت، انتقال داخلی، پس‌انداز، وام با وثیقه رمزارز و گواهی وثیقه روی همان حساب‌ها و همان کلید دسترسی کار می‌کنند. نمونه کامل هر درخواست و فهرست نقاط پایانی را در مستندات یکپارچه‌سازی سازمانی بخوانید.
سؤالات متداول
برای یکپارچه‌سازی به تیم بلاکچین نیاز داریم؟
نه. درخواست‌ها از نوع معمول رابط برنامه‌نویسی2 هستند و هر توسعه‌دهنده سمت سرور از عهده آن‌ها برمی‌آید.
آدرس واریز برای هر کاربر جداست؟
بله. هر حساب آدرس واریز اختصاصی خودش را دارد و واریز هر کاربر مستقیم به حساب خودش می‌نشیند.
تیم غیرفنی چطور داده‌ها را می‌بیند؟
داشبورد عملیاتی همه حساب‌ها، تراکنش‌ها و هشدارها را نشان می‌دهد. درباره کاربرد این زیرساخت در صرافی‌ها، مقاله واریز و برداشت رمزارز در صرافی را بخوانید.