API thanh toán crypto cho nhà phát triển và nền tảng SaaS
Tích hợp thanh toán crypto bằng một request tạo hóa đơn, một chuyển hướng redirectUrl và webhook trạng thái cuối. Hãy thử trọn luồng bằng hóa đơn demo trước khi chạy thật.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR"
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}API thanh toán crypto
- Tạo thanh toán qua API
- Chuyển hướng bằng redirectUrl
- Nhận các trạng thái wait, processing, completed và rejected
x-api-key: sk_live_…
{
"id": "order_1024",
"status": "paid"
}1 yêu cầu, 1 chuyển hướng, 1 webhook
Tạo thanh toán, chuyển hướng khách hàng và xử lý webhook cuối — toàn bộ tích hợp gói gọn trong một trang.
Tạo thanh toán với externalId, số tiền, tiền tệ và các URL.
Chuyển khách hàng tới data.redirectUrl.
Nhận webhook trạng thái cuối: wait, processing, completed hoặc rejected.
Thu bằng tiền của bạn, hạch toán bằng USD
Nhập số tiền bằng bất kỳ đơn vị tiền ISO-4217 nào qua trường currency, ví dụ INR, RUB hoặc EUR. Không có trường này, số tiền là USD như trước đây.
- Tỷ giá Qvard được cố định một lần, khi tạo thanh toán. Người trả thấy số tiền bằng đơn vị tiền của bạn và số tiền bằng token họ dùng để trả; thanh toán được ghi nhận bằng USD.
- Hạn mức được kiểm tra bằng USD sau khi quy đổi. Nếu số tiền vượt ngưỡng, thông báo lỗi hiển thị hạn mức bằng đơn vị tiền của bạn.
- Tỷ giá hiện tại có ở trang tỷ giá và trong API: GET /api/v1/rates, không cần khóa. Trong cài đặt cửa hàng, bạn có thể đặt tỷ giá riêng cho từng đơn vị tiền.
- Lỗi: 422 unsupported_currency — đơn vị tiền không được hỗ trợ; 422 rate_unavailable — chưa có tỷ giá; 422 invalid_amount_precision — số chữ số thập phân nhiều hơn mức đơn vị tiền cho phép (JPY 0, KWD 3, đa số 2).
curl "https://api.qvard.com/api/v1/rates?currencies=EUR,INR"
// 200 OK
{ "data": { "base": "USD", "updatedAt": "…", "rates": { "EUR": 0.92, "INR": … } } }Xác minh chữ ký webhook
Mỗi webhook Qvard được ký bằng HMAC-SHA256. Tìm hiểu cách xác minh chữ ký và bảo vệ chống lại giả mạo với mã sẵn sàng cho Node.js và PHP.
FAQ
A quick overview of how Qvard handles payments, integration and merchant operations.
Qvard là gì?
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.
Những tài sản nào được hỗ trợ?
Qvard hỗ trợ USDT, USDC, BTC, LTC, TRX, BNB và ETH. TON và USDT trên TON sắp ra mắt.
Có phù hợp cho nhà phát triển không?
Có. Qvard bao gồm thanh toán API, redirectUrl, webhook, thử lại và nhật ký gửi.
Tôi có thể tùy chỉnh checkout không?
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.
Tôi cần gì để bắt đầu?
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.
Việc rút tiền diễn ra như thế nào?
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.