Module PrestaShop 1.7/8.x pour Nexera Pay — Mobile Money + Carte (RDC)
# Nexera Pay for PrestaShop
Official Nexera Pay payment module for PrestaShop 1.7.6+ and PrestaShop 8.x.
Accept payments via:
- Mobile Money — M-Pesa (Vodacom), Airtel Money, Orange Money, Afrimoney
- Card — Visa / Mastercard (via Cybersource)
Target markets: Democratic Republic of the Congo (RDC) and francophone Africa.
Admin interface is in French; front-office strings are French by default and
translatable via the standard PrestaShop translation system.
---
## Requirements
- PrestaShop 1.7.6.0 → 8.x
- PHP 8.0+
- `ext-curl`, `ext-json`
- A Nexera Pay merchant account (
pay.nexera.africa)
- API key + API secret + webhook secret (available in the Nexera dashboard)
---
## Installation (from ZIP)
1. Package the module:
```bash
cd /path/to/nexera-pay-prestashop/..
zip -r nexerapay-1.0.0.zip nexera-pay-prestashop \
-x "*/.git/*" "*/vendor/*" "*/node_modules/*" "*.zip"
```
(Or rename the folder to `nexerapay` before zipping if you want the archive
root to match the module name — PrestaShop accepts both.)
2. Log into the PrestaShop Back Office.
3. Go to **Modules → Module Manager → Upload a module**.
4. Drop the ZIP.
5. Click **Configure** on the freshly installed **Nexera Pay** module.
---
## Configuration
In the module admin page, set:
| Field | Description |
| --- | --- |
| Enabled | Toggle module on/off |
| Mode | `test` (sandbox) or `live` (production) |
| API Key | `X-Nexera-Key` header value |
| API Secret | HMAC-SHA256 signing secret |
| Webhook Secret | Shared secret for verifying `X-Nexera-Signature` on incoming webhooks |
| Allowed MM Operators | `mpesa`, `airtel`, `orange`, `afrimoney` |
| Allowed Currencies | `USD`, `CDF` |
Then copy the displayed **Webhook URL** and paste it into your Nexera Pay
dashboard so payment events are pushed to your shop.
---
## Development
The module ships a self-contained HTTP client (`classes/NexeraApi.php`) that
signs every outbound request with `X-Nexera-Key`, `X-Nexera-Timestamp` and
`X-Nexera-Signa …