Cổng thanh toán host-to-host là gì?
Cổng thanh toán host-to-host là gì: thanh toán server-to-server, chuyển hướng tới trang hosted và webhook trạng thái cuối, giải thích cho merchant.
Cổng thanh toán host-to-host kết nối trực tiếp máy chủ của bạn với nhà cung cấp thanh toán. Backend tạo thanh toán, khách hàng trả tiền trên trang hosted và nhà cung cấp gửi kết quả về máy chủ của bạn.
Host-to-host nghĩa là gì
Trong mô hình host-to-host, yêu cầu thanh toán đi từ máy chủ của bạn tới cổng thanh toán, không phải từ trình duyệt. Khách hàng chỉ gặp cổng thanh toán trên trang thanh toán hosted, còn khóa và logic đơn hàng vẫn ở phía bạn.
Luồng hoạt động
Máy chủ của bạn tạo thanh toán bằng POST /api/v1/payment, nhận redirectUrl, gửi khách hàng tới đó và nhận trạng thái cuối qua webhook. Ba bước bao trọn toàn bộ luồng.
Dành cho ai
Cửa hàng online, sản phẩm SaaS và sàn thương mại đã có backend và muốn toàn quyền kiểm soát logic thanh toán, trạng thái đơn hàng và đối soát.
Trang hosted và tỷ giá cố định
Khách hàng thanh toán trên trang checkout hosted của Qvard, nơi hiển thị đúng số tiền của tài sản và mạng đã chọn theo tỷ giá cố định trong thời hạn hóa đơn. Bạn không cần tự xây dựng tạo địa chỉ hay logic tỷ giá.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR",
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Những điều cơ bản về bảo mật
Giữ x-api-key trên máy chủ, kiểm tra header x-api-key trong mỗi webhook và chỉ chấp nhận endpoint HTTPS. Hãy coi chuyển hướng là điều hướng, không phải xác nhận thanh toán.
Khi nào sản phẩm khác phù hợp hơn
Không có backend thì liên kết thanh toán đơn giản hơn. Embedded checkout, SDK, Terminal và Telegram checkout nằm trong lộ trình; hiện nay cùng kết quả đó đạt được qua API và trang hosted.
FAQ
Host-to-host có giống API không?
Đây là mô hình dựa trên API, trong đó máy chủ nói chuyện trực tiếp với cổng thanh toán. Thuật ngữ này mô tả ai thực hiện lệnh gọi, tức là máy chủ, chứ không phải một giao thức riêng.
Tôi có cần một máy chủ riêng không?
Không. Chỉ cần một backend có thể gửi yêu cầu HTTPS và mở một URL webhook là đủ.
Cổng thanh toán tốn bao nhiêu?
Tỷ lệ cơ bản là 1% mỗi thanh toán, tỷ lệ riêng giảm xuống 0,1% khi khối lượng tăng, và phí mạng được trả riêng.
Tôi có thể kết hợp host-to-host với trang hosted không?
Có, đó là luồng chuẩn: API tạo thanh toán và trang hosted thu tiền.
