API پذیرنده چیست؟
API پذیرنده رابط برنامهنویسی پرداخت این برنامه برای کسبوکارها و رباتهاست. یک برنامهی پذیرنده میسازید، توکن API آن را میگیرید و با همان توکن، از کد خودتان، برای کاربران تلگرام صورتحساب صادر میکنید، برایشان پول میفرستید و موجودیتان را میخوانید.
این همان محصولی است که کاربران میبینند، اما از سمت توسعهدهنده: صورتحسابی که با API میسازید، همان صورتحسابی است که کاربر با یک ضربه از موجودی خودش پرداخت میکند.
با آن چه کارهایی میتوان کرد
- صورتحسابها — یک درخواست پرداخت بسازید (مبلغی ثابت به رمزارز، مبلغی به ارز فیات یا مبلغ دلخواهی که خود پرداختکننده وارد میکند)، لینک آن را برای پرداختکننده بفرستید و همان لحظه که پرداخت شد یک وبهوک امضاشده بگیرید.
- بازگشت وجه — مبلغ یک صورتحساب پرداختشده را، کامل یا بخشی از آن، به همان کسی که پرداخت کرده برگردانید — حتی اگر ناشناس پرداخت کرده باشد.
- انتقال — از موجودی برنامهتان به یک کاربر تلگرام رمزارز بفرستید، یکییکی یا تا 100 مورد در یک دسته.
- چکها — از موجودی برنامه لینکهایی بسازید که هر کسی میتواند آنها را دریافت کند.
- اشتراکها — صورتحساب دورهای: کاربر یک بار طرح را تأیید میکند و از آن به بعد هر دوره بهصورت خودکار از او کسر میشود.
- موجودی، ارزها، نرخ تبدیل و آمار — متدهای فقط خواندنی برای حسابداری خودتان.
اجزا چطور به هم وصل میشوند
- هر برنامه موجودی خودش را دارد، جدا از کیف پول شخصی شما.
- صورتحسابهایی که کاربران پرداخت میکنند به موجودی همان برنامه افزوده میشوند.
- انتقالها و چکها از همان موجودی برداشته میشوند.
- هر رویداد مهمی میتواند بهصورت یک وبهوک امضاشده به سرور شما فرستاده شود.
پرداختها داخل خود برنامه تسویه میشوند، نه روی زنجیره: نه کارمزد شبکهای در کار است، نه انتظاری برای تأیید شبکه و دارایی همان لحظه که میرسد قابل استفاده است. پرداختکننده میتواند صورتحساب را از یک کیف پول بیرونی هم تأمین کند — واریز او به کیف پول خودش انجام میشود و صورتحساب خودکار از همانجا تسویه میشود؛ از سمت شما دقیقاً مثل هر صورتحساب پرداختشدهی دیگری دیده میشود.
سازگار با Crypto Bot
این API عمداً همان شکل Crypto Bot را دارد: همان نام متدها، همان قالب
{ok, result}، همان مبلغهای رشتهای اعشاری، همان روش امضای وبهوک. در یک
یکپارچهسازی موجود Crypto Bot کافی است آدرس پایه و توکن را عوض کنید — شکل درخواست
و پاسخ تغییری نمیکند.
هدر رسمی توکن TgCryptoPay-API-Token است و Crypto-Pay-API-Token هم بهعنوان
نام جایگزین پذیرفته میشود تا کتابخانههای کلاینت موجود بدون تغییر کار کنند.
⚠️ توکن API شما کلید دسترسی به موجودی است
هر کسی که آن را داشته باشد میتواند موجودی برنامهی شما را خالی کند. آن را سمت سرور نگه دارید، بیرون از برنامههای کلاینت و مخزنهای کد و بهمحض اینکه به نشت آن شک کردید آن را تعویض کنید. برای سرورهایی که به دسترسی کامل نیاز ندارند یک توکن محدود بسازید که فقط به همان دامنههای دسترسی موردنیازشان محدود باشد — مرجع API را ببینید.
در ادامه
آیا این مطلب برای شما مفید بود؟
از بازخوردتان ممنونیم.