> ## 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, локальной разработке или других явно разрешённых тестовых системах. Сгенерированные данные не предназначены для реальных платежей или production checkout.
</Warning>

**Payment Sandbox Helper** — расширение с открытым исходным кодом для разработчиков и QA-команд. Оно объединяет карты PayPal Sandbox, сценарии ошибок PayPal и тестовые карты Stripe в боковой панели и умеет автоматически заполнять поддерживаемые платёжные формы.

## Основные возможности

<CardGroup cols={2}>
  <Card title="PayPal Sandbox" icon="paypal">
    Генерирует номера, проходящие проверку Luhn, для Visa, Mastercard, American Express, Diners Club, Maestro, CUP и JCB, а также срок действия и 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 или локальный checkout.
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>
  Интерфейс расширения сейчас доступен на английском и вьетнамском языках. Это русское руководство описывает тот же актуальный набор функций.
</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](/ru/index.md)