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

**Sandbox Pay** — расширение с открытым исходным кодом для разработчиков и 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>

## Установка

<CardGroup cols={2}>
  <Card title="Chrome Web Store" icon="chrome" href="https://chromewebstore.google.com/detail/sandbox-pay/alpieoifgmjfafonmafjcmjmallgmpie">
    Установите Sandbox Pay напрямую в Chrome и совместимые Chromium-браузеры.
  </Card>

  <Card title="Firefox Add-ons" icon="firefox-browser" href="https://addons.mozilla.org/en-US/firefox/addon/sandbox-pay/">
    Установите подписанную версию Sandbox Pay для Firefox.
  </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 или локальный checkout.
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](/ru/index.md)