Modal trên trang của bạnSắp ra mắt
Cửa sổ thanh toán mở trên trang hiện tại, nên khách hàng giữ nguyên vị trí trong giỏ hàng.
Cửa sổ thanh toán mở trên trang của bạn dưới dạng modal, nên khách hàng không bao giờ rời khỏi cửa hàng. Cùng logic hóa đơn như trang hosted checkout.
Trang của bạn mở cửa sổ thanh toán với hóa đơn tạo qua API.
Khách hàng thanh toán trong modal, không chuyển hướng.
Trạng thái cuối đến qua webhook và modal đóng lại.
Cửa sổ thanh toán mở trên trang hiện tại, nên khách hàng giữ nguyên vị trí trong giỏ hàng.
Số tiền, tài sản, mạng và tỷ giá cố định hoạt động giống hệt trang hosted checkout.
Trạng thái đơn hàng đến từ webhook cuối, không phải từ trạng thái cửa sổ trình duyệt.
Chỉ cần một lệnh gọi script là mở được cửa sổ thanh toán trên cửa hàng của bạn.
Qvard có nhiều sản phẩm thanh toán. Hãy chọn sản phẩm phù hợp với kênh bán hàng của bạn.
A quick overview of how Qvard handles payments, integration and merchant operations.
Qvard là cổng thanh toán crypto cho doanh nghiệp với hosted checkout, hóa đơn, thanh toán qua API và số dư merchant.
Qvard hỗ trợ USDT, USDC, BTC, LTC, TRX, BNB và ETH. TON và USDT trên TON sắp ra mắt.
Có. Qvard bao gồm thanh toán API, redirectUrl, webhook, thử lại và nhật ký gửi.
Checkout hỗ trợ logo merchant, tên cửa hàng, màu nút và bản địa hóa. URL quay lại tùy chỉnh sắp ra mắt.
Hãy tạo tài khoản merchant và hoàn tất xác minh doanh nghiệp. Sau khi thử một hóa đơn demo, bạn kết nối hosted checkout hoặc API và bắt đầu nhận các khoản thanh toán thật.
Tiền được theo dõi trong số dư merchant, tách riêng theo tài sản và mạng. Bạn có thể rút thủ công hoặc thiết lập quy tắc rút tiền để thanh toán tự động.
Tích hợp widget thanh toán Qvard theo ba cách:
Khóa công khai của bạn (qvard_pk_…) có thể nằm trong mã trang. Nó chỉ có thể tạo thanh toán cho cửa hàng của bạn—không thể đọc dữ liệu hoặc rút tiền. Chỉ hoạt động từ các miền trong Nguồn gốc được phép của bạn, và có giới hạn tốc độ.
Máy chủ của bạn có cần tính toán số tiền hoặc kiểm tra hàng tồn kho không? Sử dụng tab "Qua máy chủ của bạn": backend của bạn tạo thanh toán bằng khóa bí mật (qvard_sk_…), và chỉ URL thanh toán đi tới trình duyệt.
<script src="https://qvard.com/checkout.js"></script> <script> // 1. Mô tả thanh toán var checkout = new QvardCheckout({ mode: 'modal', publishableKey: 'qvard_pk_YOUR_PUBLISHABLE_KEY', price: 10, orderId: 'order-123', onSuccess: function (e) { // 3. Xử lý kết quả console.log('paid', e.paymentId); }, onError: function (err) { console.log(err.code); } }); // 2. Tạo và hiển thị cửa sổ checkout.open(); </script>
# Tạo thanh toán trên máy chủ của bạn curl -X POST https://api.qvard.com/api/v1/payment \ -H 'x-api-key: qvard_sk_YOUR_SECRET_KEY' \ -H 'Content-Type: application/json' \ -d '{"price":10,"id":"order-123"}' # Phản hồi: {"id":"...","redirectUrl":"https://my.qvard.com/pay/..."} // Mở cửa sổ thanh toán trong trình duyệt <script src="https://qvard.com/checkout.js"></script> <script> // 1. Mô tả thanh toán var checkout = new QvardCheckout({ mode: 'modal', paymentUrl: 'https://my.qvard.com/pay/...', // Lấy redirectUrl từ phản hồi máy chủ onSuccess: function (e) { // 3. Xử lý kết quả console.log('paid', e.paymentId); } }); // 2. Tạo và hiển thị cửa sổ checkout.open(); </script>
<div id="checkout"></div> <script src="https://qvard.com/checkout.js"></script> <script> // 1. Mô tả thanh toán var checkout = new QvardCheckout({ mode: 'inline', target: '#checkout', publishableKey: 'qvard_pk_YOUR_PUBLISHABLE_KEY', price: 10, onSuccess: function (e) { // 3. Xử lý kết quả console.log('paid', e.paymentId); } }); // 2. Tạo và hiển thị cửa sổ checkout.open(); </script>
Tài liệu tham khảo API đầy đủ: api.qvard.com/doc
| Tùy chọn | Mô tả |
|---|---|
| mode | modal | inline |
| target | Bộ chọn CSS hoặc phần tử DOM (chỉ chế độ inline) |
| publishableKey | Khóa công khai của bạn—cần thiết để tạo thanh toán từ trình duyệt |
| paymentId | UUID của thanh toán được tạo trước—cần thiết cho luồng máy chủ |
| paymentUrl | URL thanh toán đầy đủ từ phản hồi máy chủ—cần thiết cho luồng máy chủ |
| price | Số tiền tính bằng USD (cần thiết với publishableKey) |
| orderId | ID giao dịch của bạn (tùy chọn, tối đa 128 ký tự, tự động tạo nếu bỏ qua) |
| paymentSystemId | ID phương thức thanh toán (tùy chọn, từ cài đặt tài khoản) |
| locale | Ngôn ngữ trang thanh toán: en, ru, es, pt, tr, id, vi, fr, de (mặc định là ngôn ngữ trình duyệt) |
| theme | light | dark (tùy chọn) |
| onSuccess | Callback khi thanh toán thành công: function(e) { console.log(e.paymentId); } |
| onClose | Callback khi người dùng đóng cửa sổ mà không thanh toán |
| onError | Callback khi có lỗi: function(err) { console.log(err.code, err.message); } |
Mã lỗi: invalid_mode, invalid_target, invalid_options, invalid_payment_url, network_error, invalid_key, origin_not_allowed, duplicate_order, rate_limited, invalid_request, payment_failed.