Chuyển tới nội dung chính

Giả lập luồng thanh toán

Tổng quan

Payment Simulator là công cụ kiểm thử tích hợp sẵn trong nền tảng DevAssistant, cho phép các developer của MiniApp mô phỏng luồng thanh toán mà chưa cần setup cấu hình thanh toán với payment key thật. Khi bật simulator, toàn bộ các thao tác thanh toán sẽ được điều hướng và xử lý bởi module simulator, giúp bạn kiểm thử các kịch bản thanh toán khác nhau.

Cách sử dụng

Bật toggle

Trong Cài đặt DevAssistant, bật toggle Payment Simulator.

Khởi chạy bản build MiniApp

Mở MiniApp qua DevAssistant như bình thường. User có thể chọn bản build hoặc scan QR code bản build với link kiểm thử nhanh từ DevCenter

Kích hoạt thanh toán

Ở màn hình của miniapp, click chọn Phương Thức Thanh Toán (nơi mà implement gọi JS API showPaymentMethod)

Cấu hình kịch bản

Chọn kết quả, phương thức thanh toán mong muốn và tùy chọn nhập Webhook URL. Hiện tại simulator đang hỗ trợ.

Các phương thức thanh toán:

  • CREDIT_CARD
  • DEBIT_CARD
  • BANK_TRANSFER
  • E_WALLET
  • QR_CODE

Các kết quả giả lập:

  • PENDING
  • PROCESSING
  • HOLDING
  • COMPLETED
  • FAILED
  • CANCELLED

Quay về MiniApp

Sau khi chọn phương thức thanh toán, user sẽ được đưa về MiniApp với các cài đặt đã được lưu.

Nhấn "Thanh toán" trong MiniApp (nơi implement gọi JS API initPayment)

Simulator hiển thị màn hình kết quả tương ứng với kịch bản đã chọn và gửi IPN webhook nếu đã cấu hình. IPN gửi tới webhook sẽ mô phỏng payload như trong hướng dẫn Xử lý kết quả thanh toán

Chú ý

Vì luồng giả lập không thể tạo được giá trị secureHash nên nếu user muốn dùng IPN để update order status thì cần bỏ phần validate secureHash khi test