Checkout crypto trên website và chuyển hướng: chuyển đổi và đánh đổi
Checkout crypto gömülü vs chuyển hướng: mỗi mô hình ảnh hưởng thế nào đến chuyển đổi, kiểm soát và công sức. Widget Qvard đang hoạt động. So sánh các cách tiếp cận và chọn cách đúng.
Checkout crypto gömülü trong website giữ thanh toán trong trang của bạn, còn chuyển hướng đưa khách hàng tới một trang hosted. Mỗi mô hình có đánh đổi về chuyển đổi, kiểm soát và công sức. Widget Qvard hiện đang hoạt động, nên hướng dẫn này so sánh hai cách tiếp cận và chỉ ra cách chọn.
Checkout gömülü là gì
Checkout gömülü là một cửa sổ thanh toán mở trực tiếp trên trang của bạn thông qua widget JavaScript. Nó có thể là cửa sổ modal (trên nội dung) hoặc biểu mẫu gömülü. Khách hàng ở lại trong bối cảnh trang web của bạn và thanh toán mà không rời đi. Logic thanh toán giống như trên trang hosted; chỉ bản thân trình bày là khác.
Hoạt động như thế nào trong Qvard
Widget tải từ https://qvard.com/checkout.js và mở cửa sổ thanh toán dưới dạng modal (pop-up) hoặc gömülü trong phần tử. Cửa sổ là trang thanh toán Qvard giống nhau: khách hàng chọn tài sản và mạng, số tiền được cố định theo đơn hàng của bạn. Instance widget nhận khóa công khai của bạn (qvard_pk_...) để tạo thanh toán trong trình duyệt hoặc id thanh toán để tạo trên máy chủ. Thử ngay.
Hai cách tạo thanh toán
Trong trình duyệt: truyền khóa công khai (qvard_pk_...) và số tiền cho widget; nó tạo thanh toán và mở cửa sổ. Trên máy chủ: backend của bạn tạo thanh toán qua POST /api/v1/payment và truyền id thanh toán cho widget. Đối với đơn hàng có giá cố định hoặc giới hạn hàng tồn kho, hãy sử dụng tạo máy chủ để không thể thay đổi giá trong trình duyệt. Hoặc bỏ qua widget và chuyển hướng khách hàng đến trang thanh toán hosted.
<script src="https://qvard.com/checkout.js"></script>
new QvardCheckout({
mode: 'modal',
publishableKey: 'qvard_pk_…',
price: 10,
onSuccess: function (e) {
console.log('paid', e.paymentId);
}
}).open();Trên máy chủ: tạo thanh toán trước tiên
Máy chủ của bạn gửi id đơn hàng và giá bằng USD với tiêu đề x-api-key. Phản hồi trả lại id thanh toán và redirectUrl. Truyền id cho widget trong trình duyệt, hoặc sử dụng redirectUrl để chuyển hướng hosted. Giữ khóa trên máy chủ, vì yêu cầu không được tạo từ trình duyệt.
x-api-key: qvard_sk_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Xác minh thanh toán từ webhook
Khi trạng thái paid, webhook của bạn nhận được id và trạng thái, được ký bằng tiêu đề X-Qvard-Signature (HMAC-SHA256). Xác minh chữ ký bằng khóa bí mật của bạn (qvard_sk_...) và đảm bảo số tiền khớp với đơn hàng của bạn. Đánh dấu đơn hàng là đã thanh toán chỉ sau khi xác minh chữ ký.
Khi nào sử dụng cửa sổ gömülü
Sử dụng cửa sổ modal hoặc gömülü để giữ khách hàng trên trang của bạn. Trang hosted có chuyển hướng cũng hoạt động tốt như nhau và là lựa chọn khi bạn thích không gömülü cửa sổ thanh toán. Cả hai cách tiếp cận sử dụng cùng một dòng tạo thanh toán và webhook.
FAQ
Checkout crypto gömülü có sẵn tại Qvard hôm nay không?
Có. Tải widget từ https://qvard.com/checkout.js và truyền khóa công khai của bạn (qvard_pk_...) để tạo trong trình duyệt hoặc tạo thanh toán trên máy chủ và truyền id.
Làm cách nào để thêm widget vào trang web của tôi?
Bao gồm thẻ <script src="https://qvard.com/checkout.js"></script> và khởi tạo QvardCheckout bằng khóa, số tiền và chế độ của bạn (modal hoặc inline). Xem ví dụ mã trong bài viết này và bản demo.
Chữ ký thanh toán có quan trọng không?
Có. Luôn xác minh tiêu đề X-Qvard-Signature trong webhook của bạn bằng khóa bí mật, và đảm bảo số tiền trong webhook khớp với đơn hàng của bạn.
Tôi có thể sử dụng chuyển hướng thay vì cửa sổ gömülü không?
Có. Trang thanh toán hosted tại redirectUrl cũng hoạt động tốt như nhau và không yêu cầu widget. Cả hai cách tiếp cận sử dụng cùng một API và webhook.
