> ## Documentation Index
> Fetch the complete documentation index at: https://ext.eplus.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Hướng dẫn sử dụng

> Tạo thẻ test, kích hoạt lỗi sandbox và điền form thanh toán

## Mở sidebar

Chọn biểu tượng Payment Sandbox Helper trên thanh công cụ. Chrome mở tiện ích trong side panel; Firefox mở sidebar tương ứng. Giữ panel hiển thị giúp kiểm thử nhiều trạng thái checkout mà không phải mở lại tiện ích liên tục.

## Kiểm thử PayPal Sandbox

<Steps>
  <Step title="Mở trang sandbox được hỗ trợ">
    Truy cập PayPal Sandbox, trang phát triển local hoặc ứng dụng App Engine có form nhập thẻ.
  </Step>

  <Step title="Chọn phần PayPal">
    Chọn loại thẻ cần dùng hoặc chọn PayPal error trigger cho negative test case.
  </Step>

  <Step title="Tạo hoặc chọn dữ liệu test">
    Tiện ích cung cấp số thẻ, ngày hết hạn trong tương lai và CVV ba hoặc bốn chữ số phù hợp.
  </Step>

  <Step title="Điền form">
    Dùng thao tác fill để điền các trường được phát hiện, sau đó kiểm tra lại toàn bộ dữ liệu trước khi submit giao dịch sandbox.
  </Step>
</Steps>

### PayPal error trigger

Các tình huống hiện có gồm thẻ bị từ chối, nghi ngờ gian lận, hết hạn, dữ liệu thẻ không hợp lệ, không đủ tiền, thẻ bị mất hoặc đánh cắp, tài khoản không hợp lệ, decline chung và lỗi CVV.

<Warning>
  Error trigger là dữ liệu kiểm thử riêng của provider. Cách phản hồi phụ thuộc vào PayPal Sandbox và có thể thay đổi ngoài phạm vi kiểm soát của tiện ích.
</Warning>

## Kiểm thử Stripe

Phần Stripe nhóm các thẻ test theo hành vi mong đợi:

* **Success** — các tình huống thanh toán thành công.
* **Decline** — các thẻ dùng để tạo phản hồi thanh toán bị từ chối.
* **3D Secure** — các tình huống xác thực và challenge.

Chọn case phù hợp với luồng ứng dụng, sau đó điền tự động hoặc copy dữ liệu vào form Stripe test.

## Điền toàn bộ form thẻ

Tiện ích cố gắng phát hiện và điền:

* Số thẻ.
* Ngày hết hạn dạng chung hoặc tháng/năm riêng.
* CVV, CVC hoặc security code.
* Tên chủ thẻ.
* Quốc gia thanh toán dạng input hoặc select.

Tiện ích phát sinh sự kiện `input` và `change` thông thường để React và các frontend framework khác nhận biết giá trị mới.

## Điền từng ô bằng context menu

<Steps>
  <Step title="Focus hoặc nhấp phải vào input">
    Chọn ô cần nhận dữ liệu kiểm thử.
  </Step>

  <Step title="Mở context menu">
    Nhấp chuột phải và chọn thao tác của Payment Sandbox Helper.
  </Step>

  <Step title="Chọn dữ liệu">
    Chọn thẻ hoặc giá trị cần dùng. Tiện ích điền vào input được focus gần nhất.
  </Step>
</Steps>

## Cấu hình mặc định

Trong phần thiết lập có thể thay đổi:

* Quốc gia thanh toán mặc định.
* Tên chủ thẻ mặc định.
* Hình nền thẻ PayPal và Stripe.
* Giao diện tiếng Anh hoặc tiếng Việt.

Các tùy chọn được lưu trong browser extension storage.

## Khi tự động điền không hoạt động

Một số provider đặt ô nhập nhạy cảm trong iframe bảo mật khác nguồn nên content script không thể truy cập. Khi đó, hãy copy dữ liệu từ sidebar và paste thủ công. Đồng thời kiểm tra hostname có nằm trong danh sách hỗ trợ và cấu trúc field của trang chưa thay đổi.


## Related topics

- [Tiện ích trình duyệt ePlus.DEV](/vi/index.md)
- [Payment Sandbox Helper](/vi/payment-sandbox-helper/introduction.md)
- [Câu hỏi thường gặp](/vi/payment-sandbox-helper/faq.md)
- [Tính năng](/vi/payment-sandbox-helper/features.md)
- [Cài đặt](/vi/payment-sandbox-helper/installation.md)