یکپارچه‌سازی یک درگاه پرداخت کریپتوی White Label فقط به اتصال به یک APIمحدود نمی‌شود. این کار یعنی افزودن یک جریان کامل پرداخت کریپتویی به وب‌سایت یا اپلیکیشن شما، در حالی که کنترل تجربه مشتری همچنان در اختیار شماست.
با OxaPay White Label، کسب‌وکار شما می‌تواند آدرس پرداخت، QR code، مبلغ، شبکه و وضعیت پرداخت را در رابط کاربری خودش نمایش دهد. در همین حال، OxaPay زیرساخت پرداخت پشت صحنه، از جمله ایجاد پرداخت، پایش بلاک‌چینو به‌روزرسانی تراکنش‌ها را مدیریت می‌کند.
این رویکرد به کسب‌وکارها امکان می‌دهد بدون ساخت و نگهداری داخلی زیرساخت پرداخت بلاک‌چینی، پرداخت‌های کریپتویی را با برند خود ارائه کنند.
در این راهنما توضیح می‌دهیم چگونه درگاه White Label OxaPay را یکپارچه کنید، کسب‌وکار شما پیش از شروع به چه چیزهایی نیاز دارد و قبل از راه‌اندازی نهایی باید چه وضعیت‌های پرداختی را در نظر بگیرید.
آیا White Label برای کسب‌وکار شما مناسب است؟
پیش از شروع یکپارچه‌سازی، مهم است مشخص کنید آیا راهکار White Label گزینه مناسبی برای جریان پرداخت شما.
یک صفحه پرداخت کریپتویی میزبانی‌شده اغلب برای کسب‌وکارهایی که می‌خواهند به‌سرعت پذیرش ارز دیجیتال را شروع کنندکافی است. در این مدل، مشتری برای تکمیل تراکنش به صفحه پرداختی که درگاه ارائه می‌کند هدایت می‌شود.
White Label زمانی مناسب‌تر است که تجربه پرداخت بخش مهمی از محصول یا مسیر مشتری شما باشد. به‌جای هدایت مشتری به یک صفحه پرداخت خارجی، اطلاعات پرداخت را داخل وب‌سایت، اپلیکیشن، پلتفرم یا فرایند تسویه‌حساب خودتان نمایش می‌دهید.
این راهکار به‌ویژه برای کسب‌وکارهایی مناسب است که می‌خواهند:
- در تمام فرایند تسویه‌حساب، برندینگ یکپارچه داشته باشند
- مشتریان را داخل پلتفرم خود نگه دارند
- نحوه نمایش دستورالعمل‌ها و وضعیت‌های پرداخت را کنترل کنند
- پرداخت‌های کریپتویی را به فرایند سفارش فعلی خود متصل کنند
- از ساخت زیرساخت پرداخت بلاک‌چینی از صفر جلوگیری کنند
تفاوت اصلی در میزان کنترل است. کسب‌وکار شما تجربه‌ای را که مشتری می‌بیند مدیریت می‌کند و OxaPay زیرساخت پرداخت پشت آن را بر عهده دارد.
قبل از شروع به چه چیزهایی نیاز دارید
یکپارچه‌سازی White Label به مقداری آماده‌سازی نیاز دارد، اما کسب‌وکار شما لازم نیست نودهای بلاک‌چین را اجرا کند یا سیستم پایش تراکنش اختصاصی خودش را بسازد.
وب‌سایت یا اپلیکیشن شما باید یک backend داشته باشد که بتواند به‌صورت امن با API OxaPayارتباط برقرار کند، اطلاعات پرداخت را ذخیره کند و هر پرداخت را به سفارش درست متصل کند.
همچنین به یک endpoint برای callback نیاز دارید که بتواند به‌روزرسانی‌های پرداخت را از OxaPay دریافت کند. این به‌روزرسانی‌ها به سیستم شما می‌گویند مشتری چه زمانی پرداخت را شروع کرده و پرداخت چه زمانی کامل شده است.
در نهایت، رابط پرداخت شما باید بتواند جزئیات ضروری زیر را نمایش دهد:
- مبلغ پرداخت
- ارز دیجیتال انتخاب‌شده
- شبکه بلاک‌چین
- آدرس پرداخت
- QR code
- زمان باقی‌مانده برای پرداخت
- آخرین وضعیت پرداخت
رابط باید این اطلاعات، به‌خصوص شبکه انتخاب‌شده و زمان انقضا را واضح نمایش دهد، چون اشتباه در این بخش‌ها می‌تواند باعث مشکل در پرداخت شود.
یکپارچه‌سازی درگاه پرداخت کریپتوی White Label با OxaPay
۱. ایجاد حساب Merchant در OxaPay
اولین مرحله، ایجاد حساب OxaPay و ورود به داشبورد Merchant است.
از داشبورد می‌توانید Merchant API Key، تنظیمات پرداخت، ارزهای پشتیبانی‌شده، سوابق تراکنش و سایر ابزارهای Merchant را مدیریت کنید.
در این مرحله، حساب کسب‌وکار خود را برای ارتباط با OxaPay آماده می‌کنید. لازم نیست برای هر سفارش یک کیف پول بلاک‌چینی جداگانه بسازید یا سیستم اختصاصی پایش تراکنش ایجاد کنید.
۲. ساخت Merchant API Key
در مرحله بعد یک Merchant API Key از حساب OxaPay خود ایجاد کنید.
این کلید به سیستم شما اجازه می‌دهد درخواست‌های پرداخت ارسال‌شده به API OxaPay را احراز هویت کند. این کلید باید همیشه به‌صورت امن ذخیره شود روی سرور backend شما.
Merchant API Key نباید در کد frontend، مخزن عمومی، اسکریپت مرورگر یا هر محل دیگری که مشتری بتواند به آن دسترسی داشته باشد قرار گیرد.
backend شما باید هنگام ساخت درخواست‌های پرداخت White Label از این کلید استفاده کند. frontend فقط باید اطلاعاتی را دریافت کند که برای نمایش پرداخت به مشتری لازم است.
۳. ایجاد درخواست پرداخت White Label
برای ایجاد یک پرداخت White Label، سیستم شما یک درخواست به endpoint زیر ارسال می‌کند:
POST https://api.oxapay.com/v1/payment/white-labelدو فیلد الزامی پرداخت عبارت‌اند از:
مبلغ: مقدار پرداختpay_currency: ارز دیجیتالی که برای پرداخت استفاده می‌شود
بسته به جریان پرداخت شما می‌توان فیلدهای دیگری نیز اضافه کرد.
برای مثال:
currencyارزی را مشخص می‌کند که قیمت سفارش با آن تعیین می‌شود، مانند USD.شبکهشبکه بلاک‌چین را زمانی انتخاب می‌کند که ارز دیجیتال روی چند شبکه در دسترس باشد.order_idپرداخت را به یک سفارش در سیستم داخلی شما متصل می‌کند.callback_urlبه OxaPay می‌گوید به‌روزرسانی‌های پرداخت را به کجا ارسال کند.lifetimeمشخص می‌کند پرداخت تا چه مدت معتبر بماند.under_paid_coverageاختلاف قابل‌قبول بین مبلغ درخواستی و مبلغ دریافت‌شده را مشخص می‌کند.
راهنمای currency, شبکه, order_id، و callback_url در API اختیاری هستند. بااین‌حال، استفاده از order ID و callback URL برای کسب‌وکارهایی که به رهگیری قابل‌اعتماد سفارش نیاز دارند، قویاً توصیه می‌شود.
پس از موفقیت درخواست، OxaPay یک session پرداخت ایجاد می‌کند و اطلاعات لازم برای نمایش پرداخت را به سیستم شما برمی‌گرداند.
۴. دریافت و نمایش اطلاعات پرداخت
پس از ایجاد درخواست پرداخت، OxaPay اطلاعات ساختاریافته پرداخت را برمی‌گرداند.
این اطلاعات می‌تواند شامل موارد زیر باشد:
- یک
track_id - مبلغ دقیق پرداخت
- ارز دیجیتال پرداخت
- شبکه بلاک‌چین
- آدرس پرداخت
- یک QR code
- زمان انقضا
سیستم شما باید track_id را ذخیره و آن را به سفارش داخلی درست متصل کند. این شناسه به کسب‌وکار شما کمک می‌کند پرداخت را پیگیری و در صورت نیاز بعداً بررسی کند.
frontend شما سپس می‌تواند از اطلاعات برگشتی برای ساخت یک صفحه پرداخت با برند خودتان استفاده کند.
مشتری باید بتواند:
- QR code را اسکن کند
- آدرس پرداخت را کپی کند
- مبلغ دقیق را کپی کند
- ارز دیجیتال و شبکه موردنیاز را ببیند
- زمان باقی‌مانده را بررسی کند
- وضعیت فعلی پرداخت را دنبال کند
این مزیت اصلی مدل White Label است. مشتری پرداخت را در تجربه‌ای تکمیل می‌کند که توسط کسب‌وکار شما طراحی و برند شده است.
صفحه پرداخت همچنین باید به مشتری هشدار دهد که پس از انقضای پرداخت، وجه ارسال نکند. طبق مستندات OxaPay، آدرس‌های White Label ایجادشده فقط در طول lifetime مشخص‌شده برای پرداخت معتبر هستند.
۵. پیگیری وضعیت پرداخت
پس از ارسال ارز دیجیتال توسط مشتری، OxaPay پرداخت را پایش می‌کند و پیشرفت آن را گزارش می‌دهد.
وضعیت‌های پرداخت OxaPay می‌توانند شامل حالت‌های زیر باشند:
- در انتظار پرداخت
- پرداخت در حال انجام
- paid
- underpaid
- expired
- پذیرفته‌شده به‌صورت دستی
- refunded
کسب‌وکار شما لازم نیست همه وضعیت‌های داخلی را به مشتری نمایش دهد. رابط می‌تواند این وضعیت‌ها را به پیام‌های ساده‌ای مانند «در انتظار پرداخت»، «پرداخت شناسایی شد»، «پرداخت کامل شد» یا «پرداخت منقضی شد» تبدیل کند.
نکته مهم این است که سیستم شما نباید سفارش را زودتر از موعد تکمیل کند.
OxaPay یک به‌روزرسانی paying زمانی ارسال می‌کند که فعالیت پرداخت شناسایی شده باشد. سیستم شما معمولاً باید تا وضعیت نهایی paid صبر کند و بعد محصول را تحویل دهد، سرویس را فعال کند یا سفارش را تکمیل‌شده علامت بزند.
۶. دریافت و اعتبارسنجی به‌روزرسانی‌های پرداخت
OxaPay به‌روزرسانی‌های پرداخت را به callback_url درج‌شده در درخواست پرداخت ارسال می‌کند.
این اعلان‌ها به سیستم شما اجازه می‌دهند:
- پرداخت مرتبط را شناسایی کند
- وضعیت داخلی سفارش را به‌روزرسانی کند
- مشتری را از پیشرفت پرداخت مطلع کند
- پس از پرداخت موفق، سفارش را تکمیل کند
از آنجا که endpoint مربوط به callback به‌صورت عمومی قابل دسترسی است، سیستم شما باید اعلان‌های ورودی را اعتبارسنجی کند پیش از انجام هر اقدام.
OxaPay یک امضای امنیتی همراه callbackهای خود ارائه می‌کند. تیم فنی شما باید این امضا را بررسی کند و مطمئن شود اطلاعات پرداخت با جزئیات سفارش ذخیره‌شده مطابقت دارد.
نیازی نیست این بخش برای مشتری قابل مشاهده باشد، اما قسمت مهمی از حفاظت از فرایند پرداخت است.
سیستم شما باید برای دریافت یک به‌روزرسانی بیش از یک بار نیز آماده باشد. callback تکراری نباید باعث تحویل دوباره محصول، افزایش دوباره موجودی یا چند بار تأیید شدن سفارش شود.
اگر سیستم شما دریافت callback را با موفقیت تأیید نکند، OxaPay ممکن است ارسال آن را دوباره تلاش کند.
مدیریت کم‌پرداختی
گاهی مشتری ممکن است مبلغی کمتر از مبلغ درخواستی ارسال کند.
OxaPay گزینه تحمل کم‌پرداختی را ارائه می‌کند که به Merchant اجازه می‌دهد اختلاف قابل‌قبول بین مبلغ مورد انتظار و مبلغ دریافت‌شده را تعیین کند.
اگر اختلاف در محدوده قابل‌قبول باشد، پرداخت می‌تواند طبق سیاست تنظیم‌شده ادامه پیدا کند. اگر مبلغ پایین‌تر از آستانه پذیرفته‌شده باشد، ممکن است اقدام دیگری برای پرداخت لازم باشد.
بسته به مدل کسب‌وکار خود می‌توانید:
- از مشتری بخواهید مبلغ باقی‌مانده را تکمیل کند
- پرداخت را به‌صورت دستی بررسی کنید
- پرداخت را طبق یک سیاست داخلی بپذیرید
- در صورت مناسب بودن، سفارش را لغو یا مبلغ را بازپرداخت کنید
کم‌پرداختی‌ها نباید به‌طور خودکار مانند پرداخت‌های ناموفق در نظر گرفته شوند. باید فرایند مشخصی داشته باشند تا مشتریان و تیم پشتیبانی بدانند مرحله بعد چیست.
۷. آزمایش کامل جریان پرداخت
پیش از راه‌اندازی یکپارچه‌سازی، کل مسیر مشتری را از ایجاد پرداخت تا تکمیل سفارش آزمایش کنید.
آزمایش‌های شما باید شامل موارد زیر باشد:
- ایجاد موفق پرداخت
- نمایش درست آدرس و QR code
- اطلاعات دقیق مبلغ پرداخت و شبکه
- به‌روزرسانی‌های وضعیت پرداخت
- تکمیل موفق سفارش
- پرداخت‌های منقضی‌شده
- سناریوهای کم‌پرداختی
- اعلان‌های تکراری پرداخت
- به‌روزرسانی‌های با تأخیر پرداخت
همچنین باید عملکرد صفحه پرداخت روی دستگاه‌های موبایل را بررسی کنید. بسیاری از مشتریان QR code را با دستگاه دیگری اسکن می‌کنند یا آدرس را مستقیماً در کیف پول موبایل کپی می‌کنند.
فقط آزمایش درخواست اولیه API کافی نیست. کل فرایند سفارش، از جمله به‌روزرسانی‌های پرداخت و fulfillment، باید پیش از در دسترس قرار گرفتن یکپارچه‌سازی برای مشتریان، به‌شکل قابل‌اعتماد کار کند.
ملاحظات مهم یکپارچه‌سازی
یک تجربه پرداخت White Label قابل‌اعتماد به چند جزئیات عملی وابسته است.
مدیریت انقضا
وقتی پرداخت منقضی می‌شود، سیستم شما باید نمایش آن به‌عنوان پرداخت فعال را متوقف کند. مشتری باید بتواند یک درخواست پرداخت جدید ایجاد کند و از اطلاعات پرداخت منقضی‌شده استفاده نکند.
انتخاب صحیح شبکه
اگر یک ارز دیجیتال روی بیش از یک شبکه پشتیبانی می‌شود، شبکه انتخاب‌شده را به‌وضوح نمایش دهید.
مشتری‌ای که وجه را از طریق شبکه اشتباه ارسال کند ممکن است مجبور شود با پشتیبانی تماس بگیرد و بازیابی همیشه امکان‌پذیر نیست. دستورالعمل‌های واضح می‌تواند از بسیاری از این اشتباه‌ها جلوگیری کند.
دستورالعمل‌های واضح پرداخت
مشتریان باید فوراً بدانند:
- کدام ارز دیجیتال را ارسال کنند
- از کدام شبکه استفاده کنند
- چه مقدار ارسال کنند
- به کجا ارسال کنند
- پرداخت تا چه زمانی معتبر است
- بعد از پرداخت چه اتفاقی می‌افتد
یک صفحه پرداخت واضح، سردرگمی را کاهش می‌دهد و تجربه تسویه‌حساب قابل‌اعتمادتری ایجاد می‌کند.
جریان یکپارچه‌سازی White Label
کل فرایند را می‌توان در هفت مرحله خلاصه کرد:
- سیستم شما یک سفارش داخلی ایجاد می‌کند.
- backend شما یک درخواست پرداخت White Label به OxaPay ارسال می‌کند.
- OxaPay جزئیات پرداخت را برمی‌گرداند.
- وب‌سایت یا اپلیکیشن شما پرداخت را داخل رابط خودش نمایش می‌دهد.
- مشتری ارز دیجیتال درخواستی را ارسال می‌کند.
- OxaPay تراکنش را پایش می‌کند و به‌روزرسانی‌های پرداخت را ارسال می‌کند.
- سیستم شما پرداخت را تأیید می‌کند و سفارش را تکمیل می‌کند.
نتیجه‌گیری
یکپارچه‌سازی درگاه پرداخت کریپتوی White Label OxaPay به کسب‌وکار اجازه می‌دهد بدون ساخت زیرساخت بلاک‌چین زیرین به‌صورت داخلی، کنترل تجربه پرداخت خود را در اختیار داشته باشد.
OxaPay ایجاد پرداخت، پایش تراکنش و به‌روزرسانی‌های پرداخت را مدیریت می‌کند. کسب‌وکار شما برندینگ، رابط مشتری، مدیریت سفارش و fulfillment نهایی را کنترل می‌کند.
ایده ساده است: کسب‌وکار شما مالک تجربه مشتری است و OxaPay زیرساخت پرداخت پشت آن را فراهم می‌کند.
با یک صفحه پرداخت واضح، رهگیری قابل‌اعتماد وضعیت و آزمایش مناسب، یکپارچه‌سازی White Label می‌تواند تجربه پرداخت کریپتویی یکپارچه‌ای برای مشتری ایجاد کند که کاملاً به وب‌سایت یا اپلیکیشن شما متصل باقی می‌ماند.
