Intégrer votre boutique

📅 Dernière mise à jour : Mai 2026 EcomCloser par MODECO — Plateforme de mise en relation
01

Présentation & prérequis

EcomCloser peut recevoir automatiquement les commandes de votre boutique en ligne : boutique Shopify équipée de l'application GoodSell, site personnalisé (PHP, WordPress/WooCommerce, Node.js…) ou toute autre plateforme capable d'envoyer une requête HTTP. Chaque commande apparaît instantanément dans l'application mobile de l'e-commerçant — écran Mes commandes → onglet « À assigner » — avec une notification push, prête à être confiée à un closer en un tap.

Ce qu'il vous faut
  • Un compte e-commerçant EcomCloser (application disponible sur les stores) ;
  • Votre clé de connexion : dans l'app mobile, menu Intégrations → « Copier » (format eck_…).
🔒 Cette clé est un secret : elle identifie votre compte. Utilisez-la uniquement côté serveur, jamais dans du JavaScript public. En cas de fuite, régénérez-la depuis le même écran — l'ancienne cesse immédiatement de fonctionner.
02

L'endpoint

POST https://ecomcloser.livrezmoa.com/api/integrations/orders Content-Type: application/json X-Integration-Key: eck_votre_cle_ici

Limite : 60 requêtes/minute. Appelez cet endpoint depuis votre serveur au moment où la commande est confirmée : à la création pour du paiement à la livraison, au callback de confirmation pour du paiement en ligne.

03

Le format JSON

ChampTypeRequisDescription
sourcestring ≤30✔Identifiant de votre boutique (ex : maboutique). Affiché comme badge dans l'app.
external_order_idstring ≤100✔Référence unique de la commande chez vous. Sert à la déduplication.
customer_namestring ≤255✔Nom du client
customer_phonestring ≤50✔Téléphone du client (le closer l'appellera)
customer_addressstring ≤255—Adresse de livraison
customer_citystring ≤255—Ville
customer_countrystring ≤255—Pays
currencystring ≤10—Devise (défaut : FCFA)
notesstring ≤2000—Note libre pour le closer (mode de paiement, frais…)
itemsarray✔Articles de la commande (minimum 1)
items[].namestring ≤255✔Nom du produit
items[].skustring ≤100—Recommandé : identifiant stable du produit chez vous, pour rattacher les commandes suivantes au même produit EcomCloser
items[].quantityinteger ≥1✔Quantité
items[].unit_pricenumber ≥0✔Prix unitaire
items[].variantstring ≤255—Variante lisible (ex : « Rouge, XL »)

Le montant total est calculé automatiquement (somme quantité × prix unitaire). Les produits inconnus sont créés automatiquement dans votre catalogue (rapprochement par SKU, puis par nom, sinon création).

04

Exemple & réponses

curl -X POST https://ecomcloser.livrezmoa.com/api/integrations/orders \ -H "Content-Type: application/json" \ -H "X-Integration-Key: eck_votre_cle_ici" \ -d '{ "source": "maboutique", "external_order_id": "CMD-2026-00123", "customer_name": "Awa Kone", "customer_phone": "+2250700000000", "customer_address": "Cocody, Abidjan", "customer_city": "Abidjan", "customer_country": "Côte d'\''Ivoire", "currency": "FCFA", "notes": "Paiement à la livraison", "items": [ { "name": "Montre LED Sport", "sku": "MTR-001", "quantity": 2, "unit_price": 7500, "variant": "Noir" } ] }'
CodeSignification
201Commande créée — {"success":true,"order":{"id":…,"reference":"ORD-…","status":"unassigned"}}
200Commande déjà reçue (duplicate: true). Si elle n'était pas encore assignée, son contenu a été mis à jour avec votre payload (updated: true).
401Clé manquante ou invalide
403Compte e-commerçant inactif ou bloqué
422Payload invalide (le corps JSON détaille les champs en erreur)
05

Bonnes pratiques

  • Idempotence : vous pouvez re-pousser la même commande sans risque (même source + external_order_id = jamais de doublon). Prévoyez 2–3 tentatives avec délai en cas d'erreur réseau ou de code 5xx ;
  • Ne bloquez jamais votre tunnel d'achat : faites l'appel après la réponse au client, avec un timeout court (10 s), et journalisez les échecs ;
  • Paiement en ligne : poussez au callback de confirmation (commande payée), pas à l'initiation ;
  • Produits numériques : inutile de les pousser (pas de livraison), sauf besoin particulier.
06

Solutions prêtes à l'emploi

Boutique Shopify

Installez l'application GoodSell (formulaires de commande à la livraison) : dans ses Paramètres, une section « EcomCloser » vous permet de coller directement votre clé de connexion — aucune ligne de code à écrire.

Site PHP personnalisé

Téléchargez notre fichier d'exemple autonome : une fonction unique ecomcloser_push() en cURL, jamais bloquante pour votre tunnel d'achat, avec journalisation intégrée. Collez votre clé, appelez la fonction à la confirmation de commande avec vos données — c'est tout.

⬇️ Télécharger ecomcloser-push.php

Le fichier est livré en texte brut — déposez-le sur votre serveur, il ne contient aucun secret (votre clé reste chez vous).

🤝
Besoin d'aide pour intégrer votre boutique ? Écrivez-nous :
support@ecomcloser.livrezmoa.com