> ## 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, 로컬 개발 환경 또는 명시적으로 허용된 테스트 시스템에서만 사용하세요. 생성된 값은 실제 결제나 운영 checkout에 사용할 수 없습니다.
</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>
  확장 프로그램 UI는 현재 영어와 베트남어를 지원합니다. 이 한국어 문서는 동일한 최신 기능을 설명합니다.
</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 브라우저 확장 프로그램](/ko/index.md)