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

> Générez et remplissez automatiquement des cartes de test pour PayPal Sandbox et Stripe Test

<Warning>
  Utilisez cette extension uniquement dans PayPal Sandbox, Stripe Test Mode, des environnements locaux ou d’autres systèmes de test autorisés. Les données générées ne conviennent pas aux paiements réels ni aux checkouts de production.
</Warning>

**Payment Sandbox Helper** est une extension open source destinée aux développeurs et aux équipes QA. Elle regroupe les cartes PayPal Sandbox, les scénarios d’erreur PayPal et les cartes de test Stripe dans une barre latérale, avec des actions de remplissage automatique.

## Fonctions principales

<CardGroup cols={2}>
  <Card title="PayPal Sandbox" icon="paypal">
    Génère des numéros valides selon Luhn pour Visa, Mastercard, American Express, Diners Club, Maestro, CUP et JCB, avec date d’expiration et CVV.
  </Card>

  <Card title="Stripe Test Mode" icon="stripe">
    Fournit des cartes de test pour les paiements réussis, les refus et les parcours 3D Secure.
  </Card>

  <Card title="Remplissage automatique" icon="wand-magic-sparkles">
    Remplit le numéro, la date, le CVV, le nom du titulaire et le pays dans les champs détectés.
  </Card>

  <Card title="Menu contextuel" icon="computer-mouse">
    Insère une valeur de test dans le dernier champ sélectionné via le clic droit.
  </Card>
</CardGroup>

## Installation

1. Ouvrez [GitHub Releases](https://github.com/ePlus-DEV/payment-sandbox-helper/releases/latest) et téléchargez le paquet correspondant à votre navigateur.
2. Décompressez le paquet Chromium avant de le charger.
3. Ouvrez `chrome://extensions` ou `edge://extensions`, activez le mode développeur puis choisissez **Charger l’extension non empaquetée**.
4. Dans Firefox, chargez temporairement un paquet compatible depuis `about:debugging#/runtime/this-firefox`.

Pour le développement :

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

Autres commandes :

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

## Utilisation

1. Ouvrez une page PayPal, Stripe ou locale prise en charge.
2. Cliquez sur l’icône de l’extension pour ouvrir la barre latérale.
3. Choisissez l’onglet **PayPal** ou **Stripe**.
4. Sélectionnez une carte ou un scénario d’erreur.
5. Lancez l’action de remplissage.
6. Vérifiez toujours les valeurs avant d’envoyer le formulaire, surtout avec les checkouts personnalisés ou intégrés.

## Scénarios d’erreur PayPal

L’extension inclut notamment `CCREJECT-REFUSED`, `CCREJECT-SF`, `CCREJECT-EC`, `CCREJECT-IF`, `CCREJECT-LS`, `CCREJECT-BANK_ERROR` et `CCREJECT-CVV_F`. Utilisez-les uniquement dans un flux PayPal Sandbox compatible.

## Sites pris en charge

Le content script s’exécute sur les domaines PayPal et Stripe ainsi que sur `localhost`, `127.0.0.1` et `*.appspot.com`. Les iframes sécurisées provenant d’un autre domaine peuvent empêcher l’accès aux champs ; un remplissage manuel peut alors être nécessaire.

## Réglages et confidentialité

Le pays par défaut, le nom du titulaire et les arrière-plans optionnels sont enregistrés dans le stockage local de l’extension. Les autorisations incluent `activeTab`, `scripting`, `contextMenus`, `storage` et l’API de barre latérale adaptée au navigateur. Aucune donnée réelle de carte n’est stockée.

<Info>
  L’interface de l’extension est actuellement disponible en anglais et en vietnamien. Ce guide français décrit le même périmètre fonctionnel.
</Info>

## Assistance et code source

* [Dépôt](https://github.com/ePlus-DEV/payment-sandbox-helper)
* [Dernière version](https://github.com/ePlus-DEV/payment-sandbox-helper/releases/latest)
* [Signaler un problème](https://github.com/ePlus-DEV/payment-sandbox-helper/issues)

Ne publiez jamais de vrais numéros de carte, données client, identifiants ou captures contenant des informations de paiement personnelles dans un issue public.


## Related topics

- [Extensions de navigateur ePlus.DEV](/fr/index.md)
