# Foxmayn Shopify Pay : paiement à la livraison et carte en Algérie

> Intergiciel de paiement et de livraison pour les boutiques Shopify algériennes : paiement à la livraison avec confirmation téléphonique, cartes Chargily et livraison Yalidine. En service chez Cosmekarn.

Updated: 2026-10-27

- **Détails:** Foxmayn Shopify Pay
- **Client:** Cosmekarn
- **Année:** 2026
- **Statut:** Pilote en service
- **Technologies:** TypeScript, Hono, PostgreSQL, Shopify, Chargily, Yalidine

## Le problème

Shopify ne propose pas d'origine les moyens de paiement et de livraison qu'utilisent les clients algériens. La plupart veulent payer à la livraison. D'autres veulent payer en ligne avec une carte CIB ou Edahabia. La livraison passe par des transporteurs locaux comme Yalidine, à domicile ou en stop desk.

Le paiement à la livraison a un coût. Les colis que personne n'a confirmés reviennent, et un colis retourné est payé deux fois. Les boutiques appellent donc chaque client avant d'expédier. Cet appel vit en général dans un cahier ou un fil de discussion, séparé de la commande.

Cosmekarn, une boutique algérienne de cosmétiques sur Shopify, avait besoin de tout cela dans un seul parcours.

## Ce que nous avons construit

Foxmayn Shopify Pay (FSP) est un middleware de paiement et de livraison pour les boutiques Shopify en Algérie. Il comporte trois parties.

- **Un backend** qui gère les paiements, la livraison et les commandes pour plusieurs commerçants.
- **Un tableau de bord d'administration** avec les commerçants, les transactions, la livraison et le rapprochement.
- **Une app Shopify, « Foxmayn Pay »,** intégrée à l'admin Shopify, avec une extension de checkout personnalisée.

Il prend en charge :

- Le paiement à la livraison.
- Le paiement en ligne par carte via Chargily (CIB et Edahabia).
- La livraison Yalidine, à domicile ou en stop desk, ainsi que les expéditions manuelles.
- La confirmation de chaque commande en paiement à la livraison par une personne, avant la création du colis.

## Comment ça marche

Pour un paiement par carte, le checkout crée un brouillon de commande Shopify et envoie le client vers Chargily. Quand Chargily confirme le paiement, FSP finalise le brouillon dans Shopify. Pour le paiement à la livraison, la commande attend un appel de confirmation. Le système ne crée aucun colis pour une commande en paiement à la livraison tant qu'une personne ne l'a pas confirmée.

Le backend est en TypeScript sur Node 24 avec Hono et Drizzle ORM sur PostgreSQL. Le serveur ne garde aucun état de session. Une seule image exécute le serveur et un worker planifié, avec Postgres derrière. Chaque commerçant a sa propre app personnalisée Shopify, et les identifiants de chaque commerçant sont chiffrés en AES-256-GCM avec un nonce distinct pour chaque ligne. L'app intégrée utilise React Router v7 et Prisma.

Les passerelles et les transporteurs sont derrière des registres. Chaque passerelle et chaque transporteur reste ainsi dans son propre module.

## Où en est le projet

FSP est en service chez Cosmekarn et reçoit de vraies commandes. Le commerçant est actif depuis le 26 juillet 2026, et le fournisseur Yalidine est activé et synchronisé pour lui.

En octobre 2026, FSP avait fait passer des milliers de commandes du checkout à Shopify, la plupart payées à la livraison et le reste par carte via Chargily. Cosmekarn est le premier commerçant en service.

Le paiement direct SATIM et CIB est enregistré dans le code, mais il n'est pas accepté en production. Les paiements par carte passent par Chargily.

## Ce que nous avons appris

**Tester avant le lancement, et auditer.** Le backend compte des centaines de tests automatisés, dont des tests de bout en bout avec les services externes simulés. Avant le lancement, nous avons mené un audit de sécurité complet du code et corrigé ses constats critiques et élevés, avant que de l'argent réel en dépende.

**Garder des personnes dans la boucle.** L'appel de confirmation est une règle métier. L'intégrer au système, en amont de l'étape du colis, est ce qui permet d'automatiser le reste en sécurité.

## La suite

Davantage de transporteurs, et davantage de boutiques Shopify algériennes. Si vous tenez une boutique Shopify en Algérie, consultez nos [autres produits algériens](https://foxmayn.com/fr/dz) ou [lisez l'étude sur Foxmayn Track](https://foxmayn.com/fr/dz/work/track), notre suivi des bons de livraison, en service chez Cosmekarn lui aussi.

---
Contact: foxmayn@protonmail.com · https://foxmayn.com/fr/dz#contact
HTML: https://foxmayn.com/fr/dz/work/shopify-pay · [en](https://foxmayn.com/en/dz/work/shopify-pay.md) · [ar](https://foxmayn.com/ar/dz/work/shopify-pay.md)
