کوینلند پی
از مشتریان کوینلند روی سایت خودتان پرداخت بگیرید؛ تسویه فوری از موجودی آنها، بدون کارمزد شبکه
کوینلند پی به سایت شما امکان میدهد از هر کسی که در کوینلند موجودی دارد پرداخت بگیرد. شما روی سرور خودتان یک جلسه پرداخت میسازید، مشتری را به ویجت میزبانیشده میفرستید، و مبلغ از موجودی کوینلند او به حساب کسبوکار شما در کوینلند منتقل میشود.
در این مسیر هیچ بلاکچینی وجود ندارد. هر دو حساب در کوینلند هستند، پس پرداخت یک انتقال داخلی در دفتر حساب است: در یک مرحله تسویه میشود، در همان درخواستی که مشتری تأیید میکند قطعی است، و در هیچ مبلغی کارمزد شبکه ندارد. پرداخت ۴ تتری به همان اندازه بهصرفه است که پرداخت ۴٬۰۰۰ تتری.
یکپارچهسازی چه شکلی است
شما یک جلسه پرداخت میسازید با POST /api/pay/v1/sessions، از سمت سرور و با کلید مخفی خودتان.
شناسه سفارش خودتان، یک عنوان، و قیمت را در هر ارزی که میپذیرید به آن میدهید.
مشتری در ویجت میزبانیشده پرداخت میکند. ویجت را با اسکریپت جایگذاری در یک پنجره بازشو باز میکنید
یا به checkout_url جلسه هدایتش میکنید. مشتری وارد کوینلند میشود، یکی از ارزهای شما را انتخاب میکند،
تأیید میکند و انتقال تسویه میشود.
به شما اطلاع داده میشود و سفارش را تحویل میدهید. کوینلند یک وبهوک امضاشده payment.completed
ارسال میکند؛ شما رکورد معتبر را با GET /api/pay/v1/payments/{id} میخوانید و کالا را آزاد میکنید.
برای دیدن نسخه آماده کپی و اجرای هر سه مرحله، از شروع سریع آغاز کنید.
چرا این شکل طراحی شده است
ویجت میزبانیشده است، و همین نکته اصلی است. مشتری روی دامنه خودِ کوینلند احراز هویت میکند و تأیید میکند، نه روی دامنه شما. هیچ رمز عبور، کد یکبارمصرف یا کد TOTP کوینلندی هرگز در صفحهای که شما سرو میکنید تایپ نمیشود. یعنی نفوذ به بخش فرانتاند شما نمیتواند به نفوذ به حساب کوینلند مشتریانتان تبدیل شود. سایت شما هیچوقت با یک اطلاعات محرمانه سر و کار ندارد و لازم نیست به آن اعتماد شود.
شما در ارزها قیمت میگذارید و کوینلند هیچ تبدیلی انجام نمیدهد. یک جلسه پرداخت فهرستی از گزینههای
{currency, amount} دارد و مشتری دقیقاً یکی را انتخاب میکند. اگر 10.5 تتر و 0.00012 بیتکوین
اعلام کنید، هر کدام را که انتخاب کند همان عدد جابهجا میشود. این ریل هیچ نرخ لحظهای اعلام نمیکند و
هیچ تبدیلی اعمال نمیکند، پس مبلغی که خواستهاید همان مبلغی است که میتوانید مغایرتگیری کنید.
پرداختها قابل جعل نیستند. هر پرداخت تکمیلشده یک توکن رسید دارد که با کلید مخفی وبهوک شما امضا شده است. مشتری بدون آن کلید نمیتواند چنین توکنی بسازد، پس رسید یک اثبات پرداخت قابلحمل است که هر سیستمی در مجموعه شما میتواند آفلاین بررسی کند. با این حال، مبنای تحویل سفارش همان وبهوک و API است، نه رسید.
پیش از نوشتن هر کدی
دو چیز باید از قبل وجود داشته باشد و هیچکدام از طریق API خودسرویس نیست:
- حساب شما به کسبوکار ارتقا داده میشود. این کار را کارشناسان کوینلند انجام میدهند. با این ارتقا حساب کاربری معمولی شما به یک کسبوکار تبدیل میشود و یک کیفپول کسبوکار مخصوص درآمدتان میگیرد که از موجودی شخصیتان جدا نگه داشته میشود.
- یک کلید API دارید. بعد از ارتقا، خودتان آن را در کنسول کسبوکار میسازید و فقط یک بار نمایش داده میشود.
شروع سریع هر دو مرحله را قدمبهقدم توضیح میدهد.
قدم بعدی
| اگر میخواهید | بخوانید |
|---|---|
| کوتاهترین مسیر تا یک پرداخت موفق | شروع سریع |
| ویجت را در صفحه پرداخت خودتان جای دهید | ویجت |
| چرخه حیات جلسه پرداخت و تلاش مجدد را بفهمید | جلسههای پرداخت |
| کارمزد و شماره رسید را مغایرتگیری کنید | پرداختها |
| رسید را بدون تماس با ما اعتبارسنجی کنید | رسیدها |
| به یک مشتری پول بفرستید یا پرداختی را بازپرداخت کنید | پرداخت به مشتری |
| اعلانها را درست مدیریت کنید | وبهوکها |
| هر اندپوینت را فیلد به فیلد ببینید | مرجع API |
نسخههای ماشینخوان این سایت در /llms.txt و /llms-full.txt هستند و هر
صفحه یک نسخه Markdown روی مسیر خودش بههمراه .md دارد. سند OpenAPI در
/openapi.json منتشر شده است.