Nút thanh toán crypto: cách thêm vào website của bạn
Nút thanh toán crypto: cách thêm nút trả bằng crypto vào website, nút SDK dự kiến là gì và những gì dùng được hôm nay. Có mã mẫu. Mã mẫu chi tiết.
Nút thanh toán crypto là một nút duy nhất trên website để bắt đầu thanh toán bằng tiền điện tử. SDK dự kiến của Qvard sẽ hiển thị nút như vậy chỉ với vài dòng mã, nhưng chưa được phát hành. Hướng dẫn này chỉ cách tạo một nút chạy được với API thực tế ngay hôm nay.
Nút thanh toán crypto làm gì
Nút thanh toán bắt đầu một thanh toán khi khách hàng nhấn vào. Trên website crypto, cú nhấn dẫn tới trang thanh toán nơi khách hàng chọn tài sản và mạng. Bản thân nút không giữ tiền hay khóa.
Trạng thái: nút SDK nằm trong lộ trình
Nút SDK của Qvard chưa được phát hành. Bài viết không trình bày nó như một thành phần hoàn chỉnh, và đoạn mã xem trước trong phần media được đánh dấu roadmap.
x-api-key: sk_live_…
{
"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
}Một nút chạy được hôm nay
Nút gửi yêu cầu tới backend của bạn. Backend tạo thanh toán bằng POST /api/v1/payment và header x-api-key, rồi trả về redirectUrl. Nút chuyển khách hàng tới đó, và webhook xác nhận thanh toán.
Đặt nút trong checkout
Đặt nút ở cuối giỏ hàng, cạnh tổng tiền. Hiển thị số tiền bằng USD trước khi nhấn để khách hàng biết sẽ thấy gì trên trang hosted.
Làm cho nút an toàn
Không đặt khóa API trong mã của nút. Chỉ tạo thanh toán khi khách hàng nhấn và kiểm tra tổng đơn hàng trên máy chủ, không phải trên trình duyệt.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });Xác nhận bằng webhook
Khi webhook gửi id và trạng thái paid, hãy đánh dấu đơn hàng đã thanh toán. Nhấn nút không có nghĩa là tiền đã về.
FAQ
Hôm nay Qvard có thành phần nút thanh toán không?
Không dưới dạng thành phần SDK, vốn nằm trong lộ trình. Hôm nay một nút thông thường gọi backend làm đúng việc đó.
Nút có thể hiển thị số tiền bằng đơn vị khác không?
Giá trong yêu cầu API tính bằng USD. Trang hosted hiển thị đúng số tiền bằng tài sản đã chọn theo tỷ giá cố định.
Chỉ có nút mà không có webhook có đủ không?
Không. Nút chỉ khởi tạo thanh toán. Chỉ đánh dấu đơn hàng đã thanh toán dựa trên webhook.
Làm sao để thử nút?
Dùng luồng hóa đơn demo và kiểm tra webhook đánh dấu đơn hàng sau khi thanh toán.
