Nhúng checkout stablecoin vào cửa hàng online của bạn
Nhúng checkout stablecoin vào cửa hàng: cách sử dụng widget nhúng, tạo thanh toán trên trình duyệt và máy chủ, xác minh webhook.
Nhúng checkout stablecoin nghĩa là đưa một cửa sổ thanh toán USDT hoặc USDC vào bên trong cửa hàng online của bạn. Widget checkout nhúng của Qvard nhận stablecoin ngay hôm nay. Khách hàng của bạn chọn tài sản tiền điện tử và mạng trên trang thanh toán, bạn xác minh thanh toán qua webhook.
Checkout stablecoin nhúng là gì
Checkout stablecoin nhúng là cửa sổ thanh toán mở trên trang của bạn thông qua widget JavaScript. Có thể xuất hiện dưới dạng modal (cửa sổ bật lên) hoặc nhúng trong phần tử. Khách hàng của bạn ở lại trang của bạn và thanh toán bằng USDT hoặc USDC mà không rời đi. Cửa sổ thanh toán là cùng một trang Qvard trong iframe: khách hàng nhìn thấy nó bằng ngôn ngữ của họ, chọn tài sản stablecoin và mạng, số tiền được tính với tỷ giá cố định cho hóa đơn của bạn.
Hoạt động như thế nào ở Qvard
Widget tải từ https://qvard.com/checkout.js và mở cửa sổ thanh toán stablecoin dưới dạng modal hoặc nhúng. Cửa sổ hiển thị tài sản và mạng có sẵn; khách hàng chọn, số tiền cần gửi được hiển thị. Widget phát hành event: onSuccess (thanh toán thành công), onClose (cửa sổ đóng), onError (thanh toán thất bại). Phiên bản widget nhận khóa công khai của bạn (qvard_pk_...) để tạo phía trình duyệt, hoặc id thanh toán để tạo phía máy chủ. Thử trang demo ở qvard.com.
Hai cách tạo thanh toán
Phía trình duyệt: chuyể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ổ. Khách hàng có thể thay đổi số tiền trong trình duyệt, vì vậy sử dụng cho mục đích thông tin. Khóa công khai của bạn có thể bị giới hạn ở các trang được phép qua bảng điều khiển, yêu cầu bị giới hạn tốc độ. Phía máy chủ: backend của bạn tạo thanh toán qua POST /api/v1/payment và chuyển id thanh toán cho widget. Đối với đơn hàng có số tiền cố định hoặc quan trọng, sử dụng tạo phía máy chủ và luôn xác minh số tiền trong webhook của bạn. Hoặc bỏ qua widget và chuyển hướng khách hàng đến trang thanh toán được lưu trữ.
Phía máy chủ: tạo thanh toán trước
Máy chủ của bạn gửi yêu cầu POST tới /api/v1/payment với id đơn hàng và giá USD, sử dụng tiêu đề x-api-key với khóa bí mật của bạn (qvard_sk_...). Phản hồi trả về { id, redirectUrl }. Chuyển id cho widget trong trình duyệt, hoặc sử dụng redirectUrl để chuyển hướng. Giữ khóa bí mật của bạn trên máy chủ; yêu cầu không được thực hiện 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 là paid, webhook của bạn nhận { id, status }, ký bằng tiêu đề X-Qvard-Signature ở định dạng t=...,v1=... (HMAC-SHA256 với khóa bí mật của bạn). 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 trong webhook khớp với đơn hàng của bạn. Khóa kế thừa không có tiền tố qvard_sk_ cũng nhận tiêu đề x-api-key. Đánh dấu đơn hàng đã thanh toán chỉ sau khi xác minh chữ ký. Xem hướng dẫn chữ ký trong tài liệu Qvard.
Khi nào chọn cửa sổ nhúng
Sử dụng widget modal nhúng hoặc nhúng để giữ khách hàng trên trang của bạn và cung cấp checkout stablecoin liền mạch. Trang được lưu trữ với chuyển hướng hoạt động tương tự và là một lựa chọn nếu bạn thích không nhúng cửa sổ thanh toán. Cả hai chia sẻ cùng quy trình tạo thanh toán, luồng webhook và xác minh chữ ký.
FAQ
Checkout stablecoin nhúng có sẵn tại Qvard hôm nay không?
Có. Tải widget từ https://qvard.com/checkout.js và chuyển khóa công khai của bạn (qvard_pk_...) để tạo phía trình duyệt, hoặc tạo thanh toán phía máy chủ và chuyển id.
Khách hàng chọn stablecoin và mạng trên widget như thế nào?
Khách hàng thấy tài sản stablecoin và mạng có sẵn trên trang thanh toán và chọn cái muốn sử dụng. Số tiền gửi cập nhật dựa trên lựa chọn của họ.
Tại sao tôi phải xác minh số tiền trong webhook?
Số tiền trong webhook là nguồn sự thật từ Qvard. Luôn xác minh khớp với đơn hàng của bạn, ngay cả khi bạn tạo thanh toán phía máy chủ, vì khách hàng chọn stablecoin và mạng.
Làm sao để thử trước khi phát hành?
Sử dụng trang demo ở qvard.com để thử widget và xem event webhook. Xác nhận webhook của bạn xác minh chữ ký và đánh dấu đơn hàng đã thanh toán.
