Installation - ePlus.DEV Extensions

Install from an official browser store

Chrome Web Store

Install the official Sandbox Pay extension for Chrome and compatible Chromium browsers.

Firefox Add-ons

Install the signed Sandbox Pay add-on for Firefox.

Only install Sandbox Pay from the official store pages above or packages published by the official ePlus-DEV repository. Browser extensions can access pages covered by their declared content-script matches.

Build from source

Use this option for development, contribution, or testing unreleased changes. Requirements: a current Node.js LTS release, Corepack, and Yarn 4.

# Clone the repository
git clone https://github.com/ePlus-DEV/payment-sandbox-helper.git
cd payment-sandbox-helper

# Enable the package manager declared by the project
corepack enable

# Install dependencies
yarn install

# Type-check the project
yarn compile

# Build Chrome
yarn build

# Optional: build Firefox
yarn build:firefox

Load an unpacked Chrome build

Build the extension

Run yarn build. WXT creates the Chrome Manifest V3 output under .output/chrome-mv3.

Open the extensions page

Visit chrome://extensions and enable Developer mode.

Load the output folder

Select Load unpacked, then choose .output/chrome-mv3.

Pin Sandbox Pay

Pin Sandbox Pay from the extensions menu so the sidebar is easy to open while testing.

Load a temporary Firefox build

Build the Firefox package

Run yarn build:firefox.

Open Firefox debugging

Visit about:debugging#/runtime/this-firefox and select Load Temporary Add-on.

Select the manifest

Choose manifest.json from .output/firefox-mv3.

A temporary Firefox add-on is removed when Firefox restarts. Install the signed version from Firefox Add-ons for normal long-term use.

GitHub packages

Check GitHub Releases for project release notes and additional packages.

# Chrome archive
yarn zip

# Firefox archive
yarn zip:firefox

Permissions

Permission	Purpose
`activeTab`	Work with the currently active sandbox or development page.
`scripting`	Support page interaction required by extension workflows.
`sidePanel`	Display the Chrome side panel.
`contextMenus`	Add field-level fill actions to the right-click menu.
`storage`	Save country, cardholder name, backgrounds, and preferences locally.

Firefox uses sidebar_action instead of Chrome’s sidePanel API. The manifest declares no required data collection for the Firefox build.

​Install from an official browser store

Chrome Web Store

Firefox Add-ons

​Build from source

​Load an unpacked Chrome build

​Load a temporary Firefox build

​GitHub packages

​Permissions

Install from an official browser store

Build from source

Load an unpacked Chrome build

Load a temporary Firefox build

GitHub packages

Permissions