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

# Payment Sandbox Helper

> PayPal Sandbox と Stripe Test 用のテストカードを生成し、自動入力します

<Warning>
  PayPal Sandbox、Stripe Test Mode、ローカル開発環境、または明示的に許可されたテスト環境でのみ使用してください。生成された値は実際の決済や本番チェックアウトには使用できません。
</Warning>

**Payment Sandbox Helper** は、開発者と 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>

## インストール

1. [GitHub Releases](https://github.com/ePlus-DEV/payment-sandbox-helper/releases/latest) を開き、ブラウザー用パッケージをダウンロードします。
2. Chromium 用パッケージは展開してから読み込みます。
3. `chrome://extensions` または `edge://extensions` を開き、デベロッパーモードを有効にして **パッケージ化されていない拡張機能を読み込む** を選択します。
4. Firefox では `about:debugging#/runtime/this-firefox` から互換パッケージを一時的に読み込めます。

開発環境:

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

その他のコマンド:

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

## 使い方

1. 対応する PayPal、Stripe、またはローカルのテストページを開きます。
2. 拡張機能アイコンをクリックしてサイドバーを開きます。
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>
  拡張機能の UI は現在英語とベトナム語に対応しています。この日本語ガイドは同じ最新機能を説明します。
</Info>

## サポートとソースコード

* [リポジトリ](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 ブラウザー拡張機能](/ja/index.md)