@ghemrim/slickpay-bridge-studio 0.0.0-stage → 1.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +56 -0
- package/README.md +269 -3
- package/SECURITY.md +33 -0
- package/package.json +48 -6
- package/public/sdk/slickpay-widget.css +422 -0
- package/public/sdk/slickpay-widget.js +910 -0
- package/server/index.mjs +334 -0
- package/server/slickpay-sdk.mjs +826 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
SLICKPAY BRIDGE STUDIO — LICENCE D'UTILISATION DÉVELOPPEUR & RESTRICTION COMMERCIALE
|
|
2
|
+
====================================================================================
|
|
3
|
+
|
|
4
|
+
Copyright (c) 2026 GHEMRI M (https://connect-gm.com). Tous droits réservés.
|
|
5
|
+
|
|
6
|
+
1. UTILISATION GRATUITE POUR LE DÉVELOPPEUR LUI-MÊME (USAGE PROPRE UNIQUEMENT)
|
|
7
|
+
------------------------------------------------------------------------------
|
|
8
|
+
La permission est accordée gratuitement à tout développeur d'utiliser, copier,
|
|
9
|
+
modifier et intégrer ce logiciel et sa documentation (le « Logiciel ») uniquement
|
|
10
|
+
pour ses propres besoins, sur ses propres projets, sites web ou applications dont
|
|
11
|
+
il est directement propriétaire, afin d'accepter des paiements via la passerelle
|
|
12
|
+
SlickPay (CIB / Edahabia / SATIM).
|
|
13
|
+
|
|
14
|
+
2. RESTRICTION DE COMMERCIALISATION ET PRESTATION POUR CLIENTS TIERS
|
|
15
|
+
--------------------------------------------------------------------
|
|
16
|
+
L'utilisation gratuite ne couvre PAS la facturation ou le déploiement du Logiciel
|
|
17
|
+
au profit de clients tiers. Il est strictement interdit, sans un accord écrit
|
|
18
|
+
préalable et une licence commerciale délivrée par l'auteur titulaire des droits :
|
|
19
|
+
a) D'intégrer, vendre, facturer ou déployer le Logiciel dans le cadre d'une
|
|
20
|
+
prestation commerciale pour des clients tiers (agences, freelances facturant
|
|
21
|
+
l'intégration à un client, sous-traitance commerciale) ;
|
|
22
|
+
b) De vendre, louer, sous-licencier ou facturer le Logiciel lui-même en tant que
|
|
23
|
+
produit, plugin payant, extension payante ou service SaaS/passerelle monétisé ;
|
|
24
|
+
c) D'intégrer ou d'héberger le Logiciel au sein d'une plateforme de paiement,
|
|
25
|
+
d'un agrégateur financier ou d'une offre commerciale destinée à des tiers ;
|
|
26
|
+
d) De retirer les mentions de droits d'auteur et la présente licence dans les
|
|
27
|
+
copies substantielles du Logiciel.
|
|
28
|
+
|
|
29
|
+
3. CONTACT POUR LICENCE COMMERCIALE, PRESTATIONS CLIENTS OU PARTENARIAT
|
|
30
|
+
-----------------------------------------------------------------------
|
|
31
|
+
Pour toute demande de licence commerciale (déploiement pour des clients tiers,
|
|
32
|
+
partenariat ou hébergement officiel par un prestataire de paiement) :
|
|
33
|
+
- Auteur : GHEMRI M
|
|
34
|
+
- Téléphone: 0549 77 73 66
|
|
35
|
+
- E-mail : contact@connect-gm.com
|
|
36
|
+
- Site web : https://connect-gm.com
|
|
37
|
+
|
|
38
|
+
4. ABSENCE DE GARANTIE
|
|
39
|
+
----------------------
|
|
40
|
+
LE LOGICIEL EST FOURNI « TEL QUEL », SANS GARANTIE D'AUCUNE SORTE, EXPRESSE OU
|
|
41
|
+
IMPLICITE, Y COMPRIS MAIS SANS S'Y LIMITER LES GARANTIES DE QUALITÉ MARCHANDE,
|
|
42
|
+
D'ADÉQUATION À UN USAGE PARTICULIER ET D'ABSENCE DE CONTREFAÇON.
|
|
43
|
+
|
|
44
|
+
====================================================================================
|
|
45
|
+
ENGLISH SUMMARY — DEVELOPER OWN-USE FREE LICENSE & COMMERCIAL RESTRICTION
|
|
46
|
+
====================================================================================
|
|
47
|
+
|
|
48
|
+
1. Free for the Developer's Own Projects Only: A developer may freely use, modify,
|
|
49
|
+
and integrate this Software into their own personal or directly owned websites
|
|
50
|
+
and applications at no cost.
|
|
51
|
+
2. Client Work & Commercialization Prohibited Without Agreement: Deploying or
|
|
52
|
+
integrating this Software for third-party clients (commercial client projects,
|
|
53
|
+
agency work), or selling, reselling, sublicensing, or monetizing this Software
|
|
54
|
+
as a paid plugin, SaaS platform, or commercial payment provider feature is
|
|
55
|
+
strictly prohibited without a prior written commercial license from the
|
|
56
|
+
copyright holder.
|
package/README.md
CHANGED
|
@@ -1,3 +1,269 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
|
|
1
|
+
# SlickPay Bridge Studio
|
|
2
|
+
|
|
3
|
+
Passerelle web et studio générateur d'intégration multi-produits pour SlickPay (CIB / Edahabia / SATIM). Ce projet permet à tout développeur ou commerçant — même non initié — d'intégrer le paiement électronique algérien sur n'importe quel site web en configurant sa boutique une seule fois (`SlickPay.init`), puis en déclenchant un parcours de paiement en 3 étapes inspiré de Stripe Checkout.
|
|
4
|
+
|
|
5
|
+
- Démo et générateur en ligne : [https://connect-gm.com/slickpay-test/](https://connect-gm.com/slickpay-test/)
|
|
6
|
+
- Guide complet pas-à-pas pour les débutants et intégrateurs : [docs/GUIDE-UTILISATION.md](docs/GUIDE-UTILISATION.md)
|
|
7
|
+
- Politique de sécurité et garde-fous CI/CD : [SECURITY.md](SECURITY.md)
|
|
8
|
+
- Licence d'utilisation (Gratuit pour le développeur sur ses propres projets / Usage commercial réglementé) : [LICENSE](LICENSE)
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## Comment ça fonctionne ? (Les 3 modes d'utilisation)
|
|
13
|
+
|
|
14
|
+
Vous **n'avez pas besoin d'installer Node.js ni de lancer le projet en local** pour utiliser ce Bridge sur votre site web. Il existe 3 modes d'utilisation détaillés dans [docs/GUIDE-UTILISATION.md](docs/GUIDE-UTILISATION.md) :
|
|
15
|
+
|
|
16
|
+
1. **Mode 1 — Service Hébergé / Sans aucune installation (Pour les non-initiés et intégrateurs rapides)** :
|
|
17
|
+
- Vous ouvrez directement le générateur en ligne ([https://connect-gm.com/slickpay-test/](https://connect-gm.com/slickpay-test/)).
|
|
18
|
+
- Vous remplissez vos informations (nom de boutique, clé publique SlickPay, liste de vos produits).
|
|
19
|
+
- Vous copiez-collez le code généré directement dans votre site (WordPress, HTML, PrestaShop, Shopify, React...). Ça fonctionne immédiatement grâce au script et au relais hébergés.
|
|
20
|
+
- *(Note : Ce service est actuellement hébergé sur notre serveur de démonstration et est conçu pour pouvoir être hébergé nativement chez SlickPay dans le futur s'ils le souhaitent).*
|
|
21
|
+
|
|
22
|
+
2. **Mode 2 — Auto-Hébergé sur votre propre serveur web (cPanel / PHP)** :
|
|
23
|
+
- Si vous souhaitez que tout tourne sur votre propre nom de domaine (`https://maboutique.dz`), il vous suffit de copier les **3 fichiers** du dossier `public/` (`sdk/slickpay-widget.js`, `sdk/slickpay-widget.css` et `api/checkout.php`) sur votre hébergement cPanel/FTP. Aucune base de données ni serveur Node.js n'est requis.
|
|
24
|
+
|
|
25
|
+
3. **Mode 3 — Développement en local (`localhost:3400` via Node.js)** :
|
|
26
|
+
- Les commandes `git clone` et `npm start` servent uniquement aux développeurs qui veulent faire tourner ou modifier le code source du générateur sur leur propre ordinateur (`localhost:3400` n'étant accessible que depuis votre machine locale).
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Aperçu du Studio et du parcours en 3 étapes
|
|
31
|
+
|
|
32
|
+
### 1. Interface du générateur multi-produits (Bridge Studio)
|
|
33
|
+
|
|
34
|
+
Le développeur renseigne les paramètres de sa boutique à gauche (nom de l'entreprise, langue par défaut, environnement `mock` / `sandbox` / `production`, route API v2, clé publique SlickPay, frais de livraison, URL de retour et champs fiscaux B2B optionnels), puis ajoute la liste de ses produits. Le studio affiche immédiatement l'aperçu fonctionnel à droite et génère les extraits de code prêts à être copiés.
|
|
35
|
+
|
|
36
|
+

|
|
37
|
+
|
|
38
|
+
### 2. Parcours client — Étape 1 : Coordonnées de contact
|
|
39
|
+
|
|
40
|
+
Lorsqu'un client clique sur un bouton de paiement, une modale isolée en Shadow DOM (compatible avec les politiques `Content-Security-Policy` strictes) s'ouvre sur la première étape : sélection de la quantité, nom complet ou raison sociale, adresse e-mail et numéro de téléphone mobile.
|
|
41
|
+
|
|
42
|
+

|
|
43
|
+
|
|
44
|
+
### 3. Parcours client — Étape 2 : Facturation et informations fiscales
|
|
45
|
+
|
|
46
|
+
La deuxième étape recueille la wilaya (liste complète des 58 wilayas d'Algérie, de `01 - Adrar` à `58 - El Meniaa`), l'adresse de facturation, ainsi que les champs fiscaux B2B activés par le marchand (`NIF`, `RC`, `AI`).
|
|
47
|
+
|
|
48
|
+

|
|
49
|
+
|
|
50
|
+
### 4. Parcours client — Étape 3 : Récapitulatif et redirection SATIM
|
|
51
|
+
|
|
52
|
+
Après validation de l'étape 2, la passerelle backend crée la facture auprès de l'API SlickPay (`/api/v2/users/invoices` ou `/api/v2/merchants/invoices`) et affiche le récapitulatif final avec la référence de transaction et le bouton de redirection vers le portail bancaire SATIM (`cib.satim.dz` / `satim.slick-pay.com`).
|
|
53
|
+
|
|
54
|
+

|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## Guide d'intégration rapide (Copier-Coller)
|
|
59
|
+
|
|
60
|
+
L'intégration repose sur un principe simple : **une seule initialisation globale pour tout le site**, suivie d'autant de boutons produits que nécessaire.
|
|
61
|
+
|
|
62
|
+
### Étape A — Initialisation globale (une seule fois par site)
|
|
63
|
+
|
|
64
|
+
Placez ce bloc unique dans l'en-tête (`<head>`) ou en bas de page (`<footer>`) de votre site web :
|
|
65
|
+
|
|
66
|
+
```html
|
|
67
|
+
<script src="https://connect-gm.com/slickpay-test/sdk/slickpay-widget.js"></script>
|
|
68
|
+
<script>
|
|
69
|
+
SlickPay.init({
|
|
70
|
+
endpoint: "https://connect-gm.com/slickpay-test/api/checkout.php",
|
|
71
|
+
merchantName: "Boutique Demo DZ",
|
|
72
|
+
mode: "sandbox", // "mock" | "sandbox" | "production"
|
|
73
|
+
accountType: "users", // "users" (/api/v2/users/invoices) | "merchants" (/api/v2/merchants/invoices)
|
|
74
|
+
publicKey: "54|BZ7F6N4KwSD46GEXToOv3ZBpJpf7WVxnBzK5cOE6",
|
|
75
|
+
locale: "fr", // "fr" | "ar" (RTL automatique) | "en"
|
|
76
|
+
deliveryFee: 0,
|
|
77
|
+
returnUrl: "https://monsite-exemple.dz/merci",
|
|
78
|
+
customFields: [
|
|
79
|
+
{ key: "nif", label: "NIF (Identification Fiscale)", required: true },
|
|
80
|
+
{ key: "rc", label: "RC (Registre du Commerce)", required: true }
|
|
81
|
+
]
|
|
82
|
+
});
|
|
83
|
+
</script>
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
### Étape B — Ajout des produits (3 méthodes au choix)
|
|
87
|
+
|
|
88
|
+
Une fois `SlickPay.init(...)` déclaré, tous vos boutons héritent automatiquement de votre configuration marchand. Vous pouvez intégrer vos produits selon l'une des trois méthodes suivantes :
|
|
89
|
+
|
|
90
|
+
#### Méthode 1 : Balise Web Component `<slickpay-button>`
|
|
91
|
+
|
|
92
|
+
Utilisez la balise dédiée sur vos fiches produits en précisant uniquement le nom, la description et le montant en DZD :
|
|
93
|
+
|
|
94
|
+
```html
|
|
95
|
+
<slickpay-button
|
|
96
|
+
product-name="Abonnement Starter"
|
|
97
|
+
product-description="Licence mensuelle 1 poste"
|
|
98
|
+
amount="4500"
|
|
99
|
+
></slickpay-button>
|
|
100
|
+
|
|
101
|
+
<slickpay-button
|
|
102
|
+
product-name="Pack Business Pro"
|
|
103
|
+
product-description="Licence annuelle multi-utilisateurs"
|
|
104
|
+
amount="45000"
|
|
105
|
+
></slickpay-button>
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
#### Méthode 2 : Attributs `data-slickpay` sur vos propres boutons HTML/CSS
|
|
109
|
+
|
|
110
|
+
Si vous souhaitez conserver exactement le design CSS des boutons existants de votre thème (WordPress, Bootstrap, Tailwind, etc.), ajoutez simplement l'attribut `data-slickpay` accompagné des attributs `data-product-name` et `data-amount` :
|
|
111
|
+
|
|
112
|
+
```html
|
|
113
|
+
<button
|
|
114
|
+
class="btn-custom-theme"
|
|
115
|
+
data-slickpay
|
|
116
|
+
data-product-name="Abonnement Starter"
|
|
117
|
+
data-product-description="Licence mensuelle 1 poste"
|
|
118
|
+
data-amount="4500"
|
|
119
|
+
>
|
|
120
|
+
Acheter Abonnement Starter (4 500 DZD)
|
|
121
|
+
</button>
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
#### Méthode 3 : Appel JavaScript dynamique (`SlickPay.openCheckout`)
|
|
125
|
+
|
|
126
|
+
Pour un panier e-commerce multi-articles ou une application React / Vue / Next.js dans laquelle les coordonnées de l'utilisateur connecté sont déjà connues :
|
|
127
|
+
|
|
128
|
+
```javascript
|
|
129
|
+
SlickPay.openCheckout({
|
|
130
|
+
productName: "Commande #1042",
|
|
131
|
+
productDescription: "Panier 3 articles",
|
|
132
|
+
amount: 25000,
|
|
133
|
+
quantity: 1,
|
|
134
|
+
prefill: {
|
|
135
|
+
fullName: "Amine Benali",
|
|
136
|
+
email: "client@exemple-dz.com",
|
|
137
|
+
phone: "0550123456",
|
|
138
|
+
wilaya: "16",
|
|
139
|
+
address: "12 Rue Didouche Mourad, Alger",
|
|
140
|
+
customFields: {
|
|
141
|
+
nif: "002616001234567",
|
|
142
|
+
rc: "16/00-1234567B26"
|
|
143
|
+
}
|
|
144
|
+
},
|
|
145
|
+
onSuccess: function (session) {
|
|
146
|
+
console.log("Facture créée :", session.invoiceId, session.paymentUrl);
|
|
147
|
+
}
|
|
148
|
+
});
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
---
|
|
152
|
+
|
|
153
|
+
## Écoute des événements côté Frontend
|
|
154
|
+
|
|
155
|
+
Le SDK émet des événements DOM standards sur `window` permettant à votre application d'enregistrer la commande dès que la facture SlickPay est générée :
|
|
156
|
+
|
|
157
|
+
```javascript
|
|
158
|
+
window.addEventListener("slickpay:session-created", function (event) {
|
|
159
|
+
const session = event.detail;
|
|
160
|
+
console.log("ID Facture SlickPay :", session.invoiceId);
|
|
161
|
+
console.log("URL de paiement SATIM :", session.paymentUrl);
|
|
162
|
+
console.log("Montant total (DZD) :", session.totals.totalChargeDzd);
|
|
163
|
+
});
|
|
164
|
+
|
|
165
|
+
window.addEventListener("slickpay:session-error", function (event) {
|
|
166
|
+
console.error("Erreur de création de session :", event.detail.error);
|
|
167
|
+
});
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## Architecture Backend, Verrouillage des Prix et Sécurité en Production
|
|
173
|
+
|
|
174
|
+
En environnement de production (`SLICKPAY_MODE=production`), la passerelle active automatiquement le **verrouillage des prix côté serveur** (`requirePriceSignature: true`) et exige un secret HMAC (`SLICKPAY_WEBHOOK_SECRET`) afin qu'un visiteur ne puisse jamais modifier le prix d'un produit dans le navigateur.
|
|
175
|
+
|
|
176
|
+
Vous disposez de deux mécanismes pour certifier les prix côté serveur :
|
|
177
|
+
|
|
178
|
+
### Option 1 — Catalogue de produits côté serveur (`productId`)
|
|
179
|
+
|
|
180
|
+
Déclarez votre catalogue sur le serveur (en Node.js via l'option `catalog`, ou en PHP via la variable d'environnement `SLICKPAY_CATALOG_JSON`) :
|
|
181
|
+
|
|
182
|
+
```javascript
|
|
183
|
+
// Exemple Node.js
|
|
184
|
+
const { server } = createGatewayServer({
|
|
185
|
+
mode: "production",
|
|
186
|
+
publicKey: process.env.SLICKPAY_PUBLIC_KEY,
|
|
187
|
+
webhookSecret: process.env.SLICKPAY_WEBHOOK_SECRET,
|
|
188
|
+
defaultReturnUrl: "https://maboutique.dz/payment-return",
|
|
189
|
+
allowedReturnHosts: ["maboutique.dz"],
|
|
190
|
+
catalog: {
|
|
191
|
+
"plan-starter": { name: "Abonnement Starter", unitPrice: 4500, deliveryFee: 0 },
|
|
192
|
+
"plan-pro": { name: "Pack Business Pro", unitPrice: 45000, deliveryFee: 0 }
|
|
193
|
+
}
|
|
194
|
+
});
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
Côté HTML, le bouton référence alors `product-id="plan-pro"` : même si un utilisateur modifie `amount` dans l'inspecteur du navigateur, le serveur appliquera strictement le prix du catalogue (`45 000 DZD`).
|
|
198
|
+
|
|
199
|
+
### Option 2 — Signature cryptographique HMAC-SHA256 du prix (`priceSignature`)
|
|
200
|
+
|
|
201
|
+
Si vos prix sont générés dynamiquement par votre CMS/base de données sans catalogue fixe, signez le triplet `price:{productName}:{unitPrice.toFixed(2)}:{deliveryFee.toFixed(2)}` avec votre `SLICKPAY_WEBHOOK_SECRET` :
|
|
202
|
+
|
|
203
|
+
- **En Node.js** : `const sig = gateway.signProductPrice("Pack Pro", 45000, 0);`
|
|
204
|
+
- **En PHP** : `$sig = slickpaySignProductPrice("Pack Pro", 45000, 0, getenv("SLICKPAY_WEBHOOK_SECRET"));`
|
|
205
|
+
|
|
206
|
+
Passez ensuite cette signature dans l'attribut `price-signature="..."` (ou `data-price-signature="..."`).
|
|
207
|
+
|
|
208
|
+
---
|
|
209
|
+
|
|
210
|
+
## Développement et test du code source en local (Optionnel — Mode 3)
|
|
211
|
+
|
|
212
|
+
Si vous êtes développeur et souhaitez modifier le code source ou exécuter les tests unitaires sur votre machine locale (nécessite Node.js 18+) :
|
|
213
|
+
|
|
214
|
+
```bash
|
|
215
|
+
git clone https://github.com/MGhemri/SlickPay-Bridge-Studio.git
|
|
216
|
+
cd SlickPay-Bridge-Studio
|
|
217
|
+
|
|
218
|
+
# Exécuter la suite de tests automatisés
|
|
219
|
+
npm test
|
|
220
|
+
|
|
221
|
+
# Démarrer le serveur de développement local sur http://localhost:3400
|
|
222
|
+
npm start
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
---
|
|
226
|
+
|
|
227
|
+
## Structure du dépôt
|
|
228
|
+
|
|
229
|
+
```text
|
|
230
|
+
SlickPay-Bridge-Studio/
|
|
231
|
+
├── docs/
|
|
232
|
+
│ ├── GUIDE-UTILISATION.md # Guide détaillé pour non-initiés (Hébergé vs cPanel vs Local)
|
|
233
|
+
│ └── screenshots/
|
|
234
|
+
│ ├── 01-bridge-studio-overview.png
|
|
235
|
+
│ ├── 02-checkout-step1-contact.png
|
|
236
|
+
│ ├── 03-checkout-step2-billing.png
|
|
237
|
+
│ └── 04-checkout-step3-payment.png
|
|
238
|
+
├── public/
|
|
239
|
+
│ ├── api/
|
|
240
|
+
│ │ └── checkout.php # Passerelle Backend PHP / cURL (Sandbox, Production, Mock)
|
|
241
|
+
│ ├── sdk/
|
|
242
|
+
│ │ ├── slickpay-widget.css # Feuille de style isolée (design Stripe Checkout, CSP-safe)
|
|
243
|
+
│ │ └── slickpay-widget.js # SDK Frontend (SlickPay.init, <slickpay-button>, data-slickpay)
|
|
244
|
+
│ ├── index.html # Interface du générateur multi-produits (Bridge Studio)
|
|
245
|
+
│ ├── playground.css # Styles du Bridge Studio
|
|
246
|
+
│ └── playground.js # Logique du générateur de code et de l'aperçu multi-produits
|
|
247
|
+
├── server/
|
|
248
|
+
│ ├── index.mjs # Serveur HTTP Node.js
|
|
249
|
+
│ └── slickpay-sdk.mjs # Coeur du SDK Node.js + classes Invoice / MerchantInvoice
|
|
250
|
+
├── test/
|
|
251
|
+
│ └── gateway.test.mjs # Tests unitaires et d'intégration
|
|
252
|
+
├── LICENSE # Gratuit pour les développeurs / Commercialisation soumise à accord
|
|
253
|
+
├── package.json
|
|
254
|
+
└── README.md
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
---
|
|
258
|
+
|
|
259
|
+
## Licence et Contact Commercial
|
|
260
|
+
|
|
261
|
+
Ce projet est distribué sous une licence spécifique (voir le fichier [LICENSE](LICENSE)) :
|
|
262
|
+
- **Utilisation gratuite pour le développeur lui-même (usage propre uniquement)** : Tout développeur peut utiliser, modifier et intégrer gratuitement ce Bridge sur ses propres sites web et projets dont il est directement propriétaire.
|
|
263
|
+
- **Restriction de commercialisation et prestations clients** : L'utilisation pour des clients tiers (prestations facturées, agences), la revente du logiciel en tant que plugin/service payant ou son exploitation commerciale au sein d'une plateforme de paiement sont interdites sans l'accord écrit préalable de l'auteur.
|
|
264
|
+
|
|
265
|
+
Pour toute demande de licence commerciale, d'intégration pour vos clients ou de partenariat :
|
|
266
|
+
- **Auteur** : GHEMRI M
|
|
267
|
+
- **Téléphone** : 0549 77 73 66
|
|
268
|
+
- **E-mail** : [contact@connect-gm.com](mailto:contact@connect-gm.com)
|
|
269
|
+
- **Site web** : [https://connect-gm.com](https://connect-gm.com)
|
package/SECURITY.md
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Politique de Sécurité (Security Policy)
|
|
2
|
+
|
|
3
|
+
## Versions supportées
|
|
4
|
+
|
|
5
|
+
| Version | Support de sécurité |
|
|
6
|
+
| :--- | :--- |
|
|
7
|
+
| `1.1.x` | Oui |
|
|
8
|
+
| `1.0.x` | Mise à jour vers `1.1.x` recommandée |
|
|
9
|
+
|
|
10
|
+
## Mesures de sécurité implémentées
|
|
11
|
+
|
|
12
|
+
1. **Verrouillage des prix côté serveur (Catalogue ou Signature HMAC)** :
|
|
13
|
+
- Le SDK supporte la résolution des prix depuis un catalogue serveur (`catalog: { [productId]: { name, unitPrice, deliveryFee } }`) ou la vérification cryptographique d'une signature HMAC-SHA256 (`priceSignature` / `SLICKPAY_REQUIRE_PRICE_SIGNATURE=true`), empêchant un client de modifier le montant dans le DOM.
|
|
14
|
+
2. **Verrouillage de la configuration serveur (`mode`, `publicKey`, `returnUrl`)** :
|
|
15
|
+
- Par défaut (`allowClientConfigOverride: false`), le serveur ignore les paramètres `mode`, `publicKey`, `accountType` et `returnUrl` envoyés par le navigateur et utilise exclusivement les variables d'environnement du marchand, avec une liste blanche stricte de domaines autorisés (`SLICKPAY_ALLOWED_RETURN_HOSTS`).
|
|
16
|
+
3. **Authentification HMAC des Webhooks et Protection des Données Personnelles (PII)** :
|
|
17
|
+
- La route `POST /api/slickpay/webhook` exige une signature HMAC-SHA256 valide (`X-SlickPay-Signature` ou `webhook_signature`) comparée en temps constant (`crypto.timingSafeEqual`).
|
|
18
|
+
- La route `GET /api/slickpay/status/:id` ne divulgue aucune donnée personnelle (ni e-mail, ni téléphone, ni adresse, ni `NIF`/`RC`, ni réponse brute `rawResponse`) et ne renvoie jamais un statut local en cas d'échec de l'API distante.
|
|
19
|
+
4. **Protection contre les injections XSS et compatibilité CSP** :
|
|
20
|
+
- Toutes les chaînes dynamiques injectées dans le DOM et le Shadow DOM du widget passent par `escapeHtml(...)`, et toutes les URLs (`paymentUrl`, `shopUrl`) sont filtrées par `sanitizeUrl(...)` (rejetant `javascript:` et exigeant `https:` pour l'URL de paiement).
|
|
21
|
+
- Aucun `<style>` inline ni attribut `style="..."` n'est utilisé afin de respecter les politiques `Content-Security-Policy` sans `unsafe-inline`.
|
|
22
|
+
5. **Durcissement du serveur HTTP et Limitation de Débit** :
|
|
23
|
+
- Le serveur Node.js n'expose qu'une liste blanche d'extensions statiques (`.html`, `.js`, `.css`, `.json`, `.png`, `.svg`, `.ico`) et bloque tout accès aux fichiers `.php`, `.htaccess` ou dotfiles.
|
|
24
|
+
- Une limitation de débit par IP (`60 req/min` par défaut) et une limite stricte de `64 Ko` par requête sont appliquées sur les backends Node.js et PHP.
|
|
25
|
+
|
|
26
|
+
## Signaler une vulnérabilité
|
|
27
|
+
|
|
28
|
+
Ne publiez pas de vulnérabilité de sécurité dans une Issue publique GitHub. Veuillez la signaler directement à l'auteur :
|
|
29
|
+
|
|
30
|
+
- **Responsable** : GHEMRI M
|
|
31
|
+
- **E-mail** : [contact@connect-gm.com](mailto:contact@connect-gm.com)
|
|
32
|
+
- **Téléphone** : 0549 77 73 66
|
|
33
|
+
- **Site web** : [https://connect-gm.com](https://connect-gm.com)
|
package/package.json
CHANGED
|
@@ -1,6 +1,48 @@
|
|
|
1
|
-
{
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
1
|
+
{
|
|
2
|
+
"name": "@ghemrim/slickpay-bridge-studio",
|
|
3
|
+
"version": "1.1.2",
|
|
4
|
+
"description": "Passerelle \u0026 Studio Générateur d\u0027Intégration Multi-Produits pour SlickPay (CIB / Edahabia / SATIM) style Stripe Checkout en 3 étapes",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "server/slickpay-sdk.mjs",
|
|
7
|
+
"exports": {
|
|
8
|
+
".": "./server/slickpay-sdk.mjs",
|
|
9
|
+
"./server": "./server/index.mjs"
|
|
10
|
+
},
|
|
11
|
+
"browser": "./public/sdk/slickpay-widget.js",
|
|
12
|
+
"style": "./public/sdk/slickpay-widget.css",
|
|
13
|
+
"files": [
|
|
14
|
+
"server/",
|
|
15
|
+
"public/sdk/",
|
|
16
|
+
"README.md",
|
|
17
|
+
"SECURITY.md",
|
|
18
|
+
"LICENSE"
|
|
19
|
+
],
|
|
20
|
+
"engines": {
|
|
21
|
+
"node": "\u003e=20.0.0"
|
|
22
|
+
},
|
|
23
|
+
"repository": {
|
|
24
|
+
"type": "git",
|
|
25
|
+
"url": "git+https://github.com/MGhemri/SlickPay-Bridge-Studio.git"
|
|
26
|
+
},
|
|
27
|
+
"homepage": "https://connect-gm.com/slickpay-test/",
|
|
28
|
+
"bugs": {
|
|
29
|
+
"url": "https://github.com/MGhemri/SlickPay-Bridge-Studio/issues"
|
|
30
|
+
},
|
|
31
|
+
"scripts": {
|
|
32
|
+
"start": "node server/index.mjs",
|
|
33
|
+
"test": "node --test test/gateway.test.mjs",
|
|
34
|
+
"lint": "node --check server/slickpay-sdk.mjs \u0026\u0026 node --check server/index.mjs \u0026\u0026 node --check public/sdk/slickpay-widget.js \u0026\u0026 node --check public/playground.js \u0026\u0026 node --check test/gateway.test.mjs"
|
|
35
|
+
},
|
|
36
|
+
"keywords": [
|
|
37
|
+
"slickpay",
|
|
38
|
+
"satim",
|
|
39
|
+
"cib",
|
|
40
|
+
"edahabia",
|
|
41
|
+
"algeria",
|
|
42
|
+
"payment-gateway",
|
|
43
|
+
"web-component",
|
|
44
|
+
"stripe-checkout"
|
|
45
|
+
],
|
|
46
|
+
"author": "GHEMRI M \u003ccontact@connect-gm.com\u003e (https://connect-gm.com)",
|
|
47
|
+
"license": "SEE LICENSE IN LICENSE"
|
|
48
|
+
}
|