> ## 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.

# Sandbox Pay

> 为 PayPal Sandbox 和 Stripe Test 生成并自动填写测试卡数据

<Warning>
  仅可用于 PayPal Sandbox、Stripe Test Mode、本地开发环境或其他明确授权的测试系统。生成的数据不能用于真实支付或生产环境结账。
</Warning>

**Sandbox Pay** 是面向开发者和 QA 团队的开源浏览器扩展。它在侧边栏中集中提供 PayPal Sandbox 卡、PayPal 错误场景和 Stripe 测试卡，并可自动填写受支持的支付表单。

## 主要功能

<CardGroup cols={2}>
  <Card title="PayPal Sandbox" icon="paypal">
    为 Visa、Mastercard、American Express、Diners Club、Maestro、CUP 和 JCB 生成通过 Luhn 校验的测试卡号、有效期和 CVV。
  </Card>

  <Card title="Stripe Test Mode" icon="stripe">
    提供成功、拒付和 3D Secure 流程所需的测试卡。
  </Card>

  <Card title="自动填写" icon="wand-magic-sparkles">
    将卡号、有效期、CVV、持卡人姓名和国家填写到识别出的表单字段。
  </Card>

  <Card title="右键菜单" icon="computer-mouse">
    通过右键菜单向最后聚焦的输入框写入测试值。
  </Card>
</CardGroup>

## 安装

<CardGroup cols={2}>
  <Card title="Chrome Web Store" icon="chrome" href="https://chromewebstore.google.com/detail/sandbox-pay/alpieoifgmjfafonmafjcmjmallgmpie">
    直接在 Chrome 和兼容的 Chromium 浏览器中安装 Sandbox Pay。
  </Card>

  <Card title="Firefox Add-ons" icon="firefox-browser" href="https://addons.mozilla.org/en-US/firefox/addon/sandbox-pay/">
    安装适用于 Firefox 的已签名 Sandbox Pay。
  </Card>
</CardGroup>

从源代码开发：

```bash theme={null}
corepack enable
yarn install
yarn dev
```

其他命令：

```bash theme={null}
yarn dev:firefox
yarn build
yarn build:firefox
```

## 使用方法

1. 打开受支持的 PayPal、Stripe 或本地测试页面。
2. 点击 Sandbox Pay 图标打开侧边栏。
3. 选择 **PayPal** 或 **Stripe** 标签页。
4. 选择测试卡或错误场景。
5. 执行自动填写操作。
6. 在自定义或嵌入式 checkout 中，提交前应再次检查所有字段。

## PayPal 错误场景

扩展包含 `CCREJECT-REFUSED`、`CCREJECT-SF`、`CCREJECT-EC`、`CCREJECT-IF`、`CCREJECT-LS`、`CCREJECT-BANK_ERROR` 和 `CCREJECT-CVV_F` 等触发值。仅在支持这些值的 PayPal Sandbox 流程中使用。

## 支持的网站

Content Script 会在 PayPal 和 Stripe 域名，以及 `localhost`、`127.0.0.1` 和 `*.appspot.com` 上运行。受保护的 cross-origin iframe 可能阻止扩展访问其中的字段，此时需要手动填写。

## 设置与隐私

默认国家、持卡人姓名和可选卡片背景保存在扩展的本地存储中。权限包括 `activeTab`、`scripting`、`contextMenus`、`storage` 以及浏览器对应的侧边栏 API。扩展不会保存真实卡片数据。

<Info>
  扩展界面目前支持英语和越南语。本中文指南描述相同的最新功能。
</Info>

## 支持与源代码

* [Chrome Web Store](https://chromewebstore.google.com/detail/sandbox-pay/alpieoifgmjfafonmafjcmjmallgmpie)
* [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/sandbox-pay/)
* [代码仓库](https://github.com/ePlus-DEV/payment-sandbox-helper)
* [最新版本](https://github.com/ePlus-DEV/payment-sandbox-helper/releases/latest)
* [报告问题](https://github.com/ePlus-DEV/payment-sandbox-helper/issues)

请勿在公开 Issue 中发布真实卡号、客户数据、登录凭据或包含个人支付信息的截图。


## Related topics

- [ePlus.DEV 浏览器扩展](/zh/index.md)