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

> Gere e preencha automaticamente cartões de teste para PayPal Sandbox e Stripe Test

<Warning>
  Use somente no PayPal Sandbox, Stripe Test Mode, ambientes locais ou outros sistemas de teste autorizados. Os dados gerados não servem para pagamentos reais nem para checkouts de produção.
</Warning>

**Sandbox Pay** é uma extensão open source para desenvolvedores e equipes de QA. Ela reúne cartões do PayPal Sandbox, cenários de erro do PayPal e cartões de teste da Stripe em uma barra lateral, com ações de preenchimento automático.

## Principais recursos

<CardGroup cols={2}>
  <Card title="PayPal Sandbox" icon="paypal">
    Gera números válidos pelo algoritmo de Luhn para Visa, Mastercard, American Express, Diners Club, Maestro, CUP e JCB, com validade e CVV.
  </Card>

  <Card title="Stripe Test Mode" icon="stripe">
    Inclui cartões para pagamentos aprovados, recusas e fluxos 3D Secure.
  </Card>

  <Card title="Preenchimento automático" icon="wand-magic-sparkles">
    Preenche número, validade, CVV, nome do titular e país nos campos reconhecidos.
  </Card>

  <Card title="Menu de contexto" icon="computer-mouse">
    Insere um valor de teste no último campo focado usando o clique direito.
  </Card>
</CardGroup>

## Instalação

<CardGroup cols={2}>
  <Card title="Chrome Web Store" icon="chrome" href="https://chromewebstore.google.com/detail/sandbox-pay/alpieoifgmjfafonmafjcmjmallgmpie">
    Instale o Sandbox Pay diretamente no Chrome e em navegadores Chromium compatíveis.
  </Card>

  <Card title="Firefox Add-ons" icon="firefox-browser" href="https://addons.mozilla.org/en-US/firefox/addon/sandbox-pay/">
    Instale a versão assinada do Sandbox Pay para Firefox.
  </Card>
</CardGroup>

Para desenvolvimento pelo código-fonte:

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

Outros comandos:

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

## Como usar

1. Abra uma página de teste compatível do PayPal, Stripe ou um checkout local.
2. Clique no ícone do Sandbox Pay para abrir a barra lateral.
3. Escolha a aba **PayPal** ou **Stripe**.
4. Selecione um cartão ou cenário de erro.
5. Execute a ação de preenchimento.
6. Revise os valores antes de enviar o formulário, principalmente em checkouts personalizados ou incorporados.

## Cenários de erro do PayPal

A extensão inclui valores como `CCREJECT-REFUSED`, `CCREJECT-SF`, `CCREJECT-EC`, `CCREJECT-IF`, `CCREJECT-LS`, `CCREJECT-BANK_ERROR` e `CCREJECT-CVV_F`. Use-os apenas em fluxos do PayPal Sandbox que reconheçam esses gatilhos.

## Sites compatíveis

O Content Script funciona em domínios do PayPal e Stripe, além de `localhost`, `127.0.0.1` e `*.appspot.com`. Iframes seguros de outra origem podem impedir o acesso aos campos; nesses casos o preenchimento manual pode ser necessário.

## Configurações e privacidade

País padrão, nome do titular e fundos opcionais são armazenados localmente pela extensão. As permissões incluem `activeTab`, `scripting`, `contextMenus`, `storage` e a API de barra lateral específica do navegador. Nenhum dado real de cartão é salvo.

<Info>
  A interface da extensão está disponível atualmente em inglês e vietnamita. Este guia em português descreve o mesmo conjunto atual de recursos.
</Info>

## Suporte e código-fonte

* [Chrome Web Store](https://chromewebstore.google.com/detail/sandbox-pay/alpieoifgmjfafonmafjcmjmallgmpie)
* [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/sandbox-pay/)
* [Repositório](https://github.com/ePlus-DEV/payment-sandbox-helper)
* [Versão mais recente](https://github.com/ePlus-DEV/payment-sandbox-helper/releases/latest)
* [Relatar um problema](https://github.com/ePlus-DEV/payment-sandbox-helper/issues)

Não publique números reais de cartão, dados de clientes, credenciais ou capturas com informações pessoais de pagamento em issues públicos.


## Related topics

- [Extensões de navegador ePlus.DEV](/pt-BR/index.md)