SDK

Cửa sổ thanh toán crypto dạng popup: hoạt động và dự kiến gì

Cửa sổ thanh toán crypto dạng popup được giải thích: cách hoạt động, SDK của Qvard dự kiến gì và bạn có thể chạy gì hôm nay. Có mã mẫu. Có ví dụ.

Cửa sổ thanh toán crypto dạng popup là cửa sổ thanh toán mở trên trang hiện tại, nhờ vậy khách hàng thanh toán mà không rời website. Popup này được dự kiến là một phần của SDK Qvard và chưa được phát hành. Hướng dẫn này giải thích cách một popup như vậy hoạt động và những gì bạn có thể chạy hôm nay với API.

Cửa sổ thanh toán hoạt động thế nào

Trang gọi một hàm, một cửa sổ mở trên nội dung, khách hàng hoàn tất thanh toán trong đó và cửa sổ đóng lại. Cửa hàng vẫn ở phía sau và đơn hàng được xác nhận trên máy chủ.

Trạng thái: popup nằm trong lộ trình

Popup checkout của Qvard chưa được phát hành, và bài viết này không mô tả nó như tính năng hoàn chỉnh. Mã trong phần media là bản xem trước của lệnh gọi đã lên kế hoạch.

Những gì hoạt động hôm nay

Tạo thanh toán bằng POST /api/v1/payment và header x-api-key, rồi chuyển khách hàng tới redirectUrl trên trang checkout hosted. Nhận trạng thái cuối qua webhook. Như vậy khách hàng có cùng kết quả thanh toán mà không cần popup.

POST/api/v1/payment
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ở cửa sổ mới cẩn thận

Nếu bạn thích cửa sổ riêng, chỉ mở redirectUrl trong tab mới sau một cú nhấp. Trình duyệt chặn các cửa sổ mở mà không có thao tác của người dùng, nên cú nhấp phải đến trước.

Xác nhận thanh toán trên máy chủ

Khi popup ra mắt, nó sẽ hiển thị tiến trình trên trang, nhưng trạng thái đã thanh toán vẫn phải đến từ webhook. Hãy xây logic đơn hàng xoay quanh webhook ngay từ bây giờ.

JSroadmap: not released yet
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });

Những điều nên tránh

Đừng coi cửa sổ bị đóng là thanh toán thất bại, và đừng đánh dấu đơn hàng đã thanh toán khi cửa sổ đóng. Hãy chờ kết quả từ webhook.

FAQ

Hôm nay Qvard có popup thanh toán không?

Chưa. Popup được dự kiến là một phần của SDK trong lộ trình. Hôm nay trang checkout hosted hoặc tab mới là đủ.

Popup có thể mở mà không cần nhấp không?

Trình duyệt thường chặn. Hãy mở trang thanh toán sau khi người dùng nhấp.

Nếu khách hàng đóng cửa sổ thì sao?

Đừng quyết định kết quả theo sự kiện đóng. Kiểm tra trạng thái đơn hàng qua webhook.

Làm sao để kiểm thử luồng?

Tạo hóa đơn demo và kiểm tra kết quả webhook.

Bài viết liên quan

Bài viết liên quan