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

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

**Payment Sandbox Helper** é 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

1. Abra [GitHub Releases](https://github.com/ePlus-DEV/payment-sandbox-helper/releases/latest) e baixe o pacote do seu navegador.
2. Extraia o pacote Chromium antes de carregá-lo.
3. Abra `chrome://extensions` ou `edge://extensions`, ative o modo do desenvolvedor e escolha **Carregar sem compactação**.
4. No Firefox, carregue temporariamente um pacote compatível em `about:debugging#/runtime/this-firefox`.

Para desenvolvimento:

```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 da extensão 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

* [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)