التكامل
وضع التضمين
أضف checkout MakePay باستخدام أزرار تعريفية أو المتصفح API.
زر مضمن
الصفات المطلوبة
يعد التكامل التعريفي هو الأفضل لصفحات المنتج والفواتير وصفحات CMS الثابتة حيث يمكنك إضافة علامة البرنامج النصي وعلامة الأزرار.
- استخدم
data-makepay-payment-linkمع الدفعة UID التي تريد فتحها. - قم بتحميل البرنامج النصي المشروط قبل أن يتمكن العميل من النقر فوق زر الدفع.
- اجعل لوحة المفاتيح العنصرية قابلة للوصول باستخدام عنصر
buttonأوaالحقيقي.
html
<script src="https://cdn.makepay.io/modal/makepay.min.js"></script>
<button type="button" data-makepay-payment-link="YOUR_PAYMENT_UID">
Pay with crypto
</button>المتصفح API
استخدم المتصفح العالمي API عندما يمتلك تطبيقك معالج النقر أو يحتاج إلى تمرير عمليات الاسترجاعات الخاصة بدورة الحياة مباشرة.
- افتح طريقة الدفع باستخدام
window.makepay.showPayment(uid, { onEvent }). - أغلق النموذج الحالي باستخدام
window.makepay.hide().
html
<script src="https://cdn.makepay.io/modal/makepay.min.js"></script>
<button type="button" id="pay-with-makepay">Pay with crypto</button>
<script>
document.getElementById("pay-with-makepay").addEventListener("click", function () {
window.makepay.showPayment("YOUR_PAYMENT_UID", {
onEvent: function (event) {
if (event.type === "makepay.payment.redirect_requested" && event.payload.redirectUrl) {
window.location.assign(event.payload.redirectUrl);
}
},
});
});
</script>التعامل مع رد الاتصال
قم بتمرير رد اتصال onEvent عندما تحتاج صفحتك إلى الاستجابة لتغييرات حالة checkout أو إعادة توجيه الطلبات دون الاستماع عالميًا على window.
متى تستخدمه
استخدم زر التضمين عندما لا يحتاج موقع التاجر إلى تشغيل JavaScript المخصص قبل فتح checkout. استخدم المتصفح API عندما يتحكم تطبيقك في النقر أو يحتاج إلى ردود اتصال لفتح محدد.