Envoyer les commandes de votre site web personnalisé à eGrow (Guide API pour développeurs et outils de codage IA)

Pourquoi envoyer vos commandes à eGrow

Un site web personnalisé est excellent pour prendre des commandes. Il n'est pas conçu pour gérer tout ce qui se passe après la commande — et pour le paiement à la livraison, c'est ce "après" qui détermine si l'argent est gagné ou perdu. Une fois qu'une commande atteint eGrow :

• La confirmation se fait d'elle-même — confirmation WhatsApp, l'agent IA ou votre centre d'appels, avec les réponses du client enregistrées sur la commande.
• L'expédition se fait en un clic (ou zéro) — le colis est créé auprès de votre société de livraison et le numéro de suivi est enregistré sur la commande ; les statuts se synchronisent automatiquement.
• Les clients sont tenus informés — les messages "commande reçue", "en route", "livraison échouée, pouvons-nous réessayer ?" sont envoyés depuis votre numéro WhatsApp sans que vous n'ayez à faire quoi que ce soit.
• Les retours diminuent — les adresses et les villes sont validées, les doublons sont signalés, les clients injoignables sont relancés et les paniers abandonnés peuvent être récupérés.
• Vous voyez les vrais chiffres — taux de confirmation, taux de livraison, retours, revenus par produit et par campagne (UTM), le tout en un seul endroit.

Votre site web reste votre site web. eGrow est le moteur des opérations qui le sous-tend.

Comment ça marche

1. Vous créez une clé API personnelle dans eGrow (2 minutes).
2. Lorsqu'un client passe une commande sur votre site, votre serveur envoie cette commande à l'API eGrow (orderFullCreate).
3. eGrow répond avec l'ID de commande — et prend le relais.

C'est toute l'intégration. Tout ce qui suit est un détail.

Étape 1 : Obtenez votre clé API

1. Dans eGrow, ouvrez Settings → Developer → API Key.
2. Cliquez sur Générer et copiez la clé (elle commence par egrow_).
3. Enregistrez-la dans l'environnement de votre projet sous le nom EGROW_API_KEY.

Étape 2 : Envoyez la commande

L'API eGrow est GraphQL. Vous envoyez toujours une requête POST au même endpoint avec un corps JSON qui contient une query et ses variables.

• Endpoint : https://api5.egrow.com/graphql
• En-têtes : Authorization: Bearer YOUR_API_KEY et Content-Type: application/json
• Mutation : orderFullCreate — crée une commande complète (client, adresse, produits, prix) en un seul appel.

La mutation

mutation CreateOrder($input: OrderFullCreateInput!) {
 orderFullCreate(input: $input) {
 order { id orderNumber }
 userErrors { field message code }
 }
}

Les variables (une vraie commande COD)

{
 "input": {
 "orderExternalId": "WEB-10245",
 "orderNumber": "10245",
 "orderType": "Order",
 "paymentMethod": "COD",
 "financialStatus": "Pending",
 "currency": "MAD",
 "phone": "+212612345678",
 "email": "[email protected]",
 "customer": {
 "firstName": "Amina",
 "lastName": "El Idrissi",
 "phone": "+212612345678",
 "email": "[email protected]"
 },
 "shippingAddress": {
 "firstName": "Amina",
 "lastName": "El Idrissi",
 "phone": "+212612345678",
 "address1": "12 Rue Al Massira, Apt 4",
 "city": "Casablanca",
 "province": "Casablanca-Settat",
 "countryCode": "MA"
 },
 "lineItems": [
 {
 "title": "Leather wallet — brown",
 "sku": "WAL-BR-01",
 "externalProductId": "prod_88",
 "quantity": 2,
 "price": 149.00,
 "imageUrl": "https://yourshop.ma/img/wallet-brown.jpg"
 }
 ],
 "subtotal": 298.00,
 "shippingPrice": 30.00,
 "note": "Customer prefers delivery after 6pm",
 "tags": ["website"],
 "utmParameters": { "source": "facebook", "campaign": "ramadan-2026" }
 }
}

À quoi sert chaque champ

La réponse

{
 "data": {
 "orderFullCreate": {
 "order": { "id": 1834512, "orderNumber": "10245" },
 "userErrors": []
 }
 }
}

Enregistrez order.id à côté de votre propre commande. Si userErrors n'est pas vide, rien n'a été créé — le message vous indique quel champ corriger.

Étape 3 : Exemples de code

Chaque exemple fait la même chose : construire les variables à partir de vos données de paiement et les envoyer par POST. Remplacez la clé par votre variable d'environnement.

cURL (testez-le depuis votre terminal)

curl -X POST https://api5.egrow.com/graphql \
 -H "Authorization: Bearer $EGROW_API_KEY" \
 -H "Content-Type: application/json" \
 -d '{
 "query": "mutation CreateOrder($input: OrderFullCreateInput!) { orderFullCreate(input: $input) { order { id orderNumber } userErrors { field message code } } }",
 "variables": { "input": { "orderExternalId": "WEB-10245", "paymentMethod": "COD", "currency": "MAD",
 "customer": { "firstName": "Amina", "lastName": "El Idrissi", "phone": "+212612345678" },
 "shippingAddress": { "address1": "12 Rue Al Massira", "city": "Casablanca", "countryCode": "MA", "phone": "+212612345678" },
 "lineItems": [ { "title": "Leather wallet — brown", "sku": "WAL-BR-01", "quantity": 2, "price": 149 } ],
 "subtotal": 298, "shippingPrice": 30 } }
 }'

Node.js / Next.js (gestionnaire de route ou route API)

// app/api/checkout/route.js — runs on the server, the key never reaches the browser
const MUTATION = `mutation CreateOrder($input: OrderFullCreateInput!) {
 orderFullCreate(input: $input) { order { id orderNumber } userErrors { field message code } }
}`;

export async function sendOrderToEgrow(order) {
 const input = {
 orderExternalId: String(order.id),
 orderNumber: String(order.number),
 orderType: "Order",
 paymentMethod: order.paidOnline ? "CARD" : "COD",
 financialStatus: order.paidOnline ? "Paid" : "Pending",
 currency: "MAD",
 phone: order.customer.phone,
 email: order.customer.email,
 customer: { firstName: order.customer.firstName, lastName: order.customer.lastName,
 phone: order.customer.phone, email: order.customer.email },
 shippingAddress: { firstName: order.customer.firstName, lastName: order.customer.lastName,
 phone: order.customer.phone, address1: order.address.line1,
 city: order.address.city, province: order.address.region, countryCode: "MA" },
 lineItems: order.items.map(i => ({ title: i.name, sku: i.sku, externalProductId: String(i.productId),
 quantity: i.qty, price: i.unitPrice, imageUrl: i.image })),
 subtotal: order.subtotal,
 shippingPrice: order.shipping,
 note: order.note || undefined,
 tags: ["website"],
 utmParameters: order.utm || undefined,
 };

 const res = await fetch("https://api5.egrow.com/graphql", {
 method: "POST",
 headers: { "Authorization": `Bearer ${process.env.EGROW_API_KEY}`, "Content-Type": "application/json" },
 body: JSON.stringify({ query: MUTATION, variables: { input } }),
 });
 const json = await res.json();
 const result = json.data?.orderFullCreate;
 if (!result || result.userErrors?.length) {
 throw new Error("eGrow rejected the order: " + JSON.stringify(result?.userErrors ?? json.errors));
 }
 return result.order; // { id, orderNumber } — store it with your order
}

PHP (Laravel, WordPress, PHP pur)

function sendOrderToEgrow(array $order): array {
 $mutation = 'mutation CreateOrder($input: OrderFullCreateInput!) {
 orderFullCreate(input: $input) { order { id orderNumber } userErrors { field message code } }
 }';
 $input = [
 'orderExternalId' => (string)$order['id'],
 'paymentMethod' => 'COD',
 'financialStatus' => 'Pending',
 'currency' => 'MAD',
 'phone' => $order['phone'],
 'customer' => ['firstName' => $order['first_name'], 'lastName' => $order['last_name'], 'phone' => $order['phone']],
 'shippingAddress' => ['address1' => $order['address'], 'city' => $order['city'], 'countryCode' => 'MA', 'phone' => $order['phone']],
 'lineItems' => array_map(fn($i) => ['title' => $i['name'], 'sku' => $i['sku'], 'quantity' => (int)$i['qty'], 'price' => (float)$i['price']], $order['items']),
 'subtotal' => (float)$order['subtotal'],
 'shippingPrice' => (float)$order['shipping'],
 ];
 $ch = curl_init('https://api5.egrow.com/graphql');
 curl_setopt_array($ch, [
 CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 20,
 CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('EGROW_API_KEY'), 'Content-Type: application/json'],
 CURLOPT_POSTFIELDS => json_encode(['query' => $mutation, 'variables' => ['input' => $input]]),
 ]);
 $json = json_decode((string)curl_exec($ch), true);
 curl_close($ch);
 $result = $json['data']['orderFullCreate'] ?? null;
 if (!$result || !empty($result['userErrors'])) {
 throw new RuntimeException('eGrow rejected the order: ' . json_encode($result['userErrors'] ?? $json['errors'] ?? null));
 }
 return $result['order']; // ['id' => …, 'orderNumber' => …]
}

Python (Django, FastAPI, Flask)

import os, requests

MUTATION = """mutation CreateOrder($input: OrderFullCreateInput!) {
 orderFullCreate(input: $input) { order { id orderNumber } userErrors { field message code } }
}"""

def send_order_to_egrow(order):
 payload = {
 "orderExternalId": str(order["id"]),
 "paymentMethod": "COD", "financialStatus": "Pending", "currency": "MAD",
 "phone": order["phone"],
 "customer": {"firstName": order["first_name"], "lastName": order["last_name"], "phone": order["phone"]},
 "shippingAddress": {"address1": order["address"], "city": order["city"], "countryCode": "MA", "phone": order["phone"]},
 "lineItems": [{"title": i["name"], "sku": i["sku"], "quantity": i["qty"], "price": i["price"]} for i in order["items"]],
 "subtotal": order["subtotal"], "shippingPrice": order["shipping"],
 }
 r = requests.post("https://api5.egrow.com/graphql",
 headers={"Authorization": f"Bearer {os.environ['EGROW_API_KEY']}", "Content-Type": "application/json"},
 json={"query": MUTATION, "variables": {"input": payload}}, timeout=20)
 result = r.json().get("data", {}).get("orderFullCreate")
 if not result or result.get("userErrors"):
 raise RuntimeError(f"eGrow rejected the order: {result and result.get('userErrors')}")
 return result["order"] # {"id": …, "orderNumber": …}

Mettre à jour une commande déjà envoyée

Le client a changé l'adresse, ou vous avez annulé la commande sur votre site ? Utilisez orderCreateOrUpdate avec le même orderExternalId — il prend exactement la même entrée, et eGrow met à jour la commande existante au lieu d'en créer une seconde. C'est aussi le choix le plus sûr si vous n'êtes pas sûr qu'une commande ait déjà été envoyée.

mutation UpsertOrder($input: OrderCreateOrUpdateInput!) {
 orderCreateOrUpdate(input: $input) {
 order { id orderNumber }
 userErrors { field message code }
 }
}

Testez avant d'écrire du code

L'API Playground (Settings → Developer → Playground) dispose d'une action Ajouter une commande qui construit cette requête exacte à partir d'un formulaire, l'exécute et affiche la réponse en direct. Cliquez sur Remplir avec des données fictives, exécutez-la, et vous verrez une nouvelle commande apparaître dans votre liste de commandes. Copiez ensuite le cURL généré — c'est le même appel que ci-dessus, avec les vrais ID de pipeline et de magasin de votre compte.

Laissez votre codeur IA le faire : une invite que vous pouvez coller

Si votre site a été construit avec Claude, Codex, Cursor, Lovable, Bolt ou un outil similaire, vous n'avez pas à écrire tout cela vous-même. Collez l'invite ci-dessous dans le même outil, dans votre projet, et il trouvera votre code de paiement et ajoutera l'intégration. L'assistant est déjà dans votre code : il trouvera le paiement, respectera votre stack et vos conventions, et ajoutera l'intégration. Rien à remplir.

Integrate this project's checkout with eGrow so every new order is sent to eGrow through its API.
You are already in the codebase: find where an order is saved, use the language, framework and
conventions this project already has, and reuse my existing order/customer/product objects.

1. Add a server-side function (e.g. sendOrderToEgrow) that POSTs JSON to https://api5.egrow.com/graphql
 with headers Authorization: Bearer <EGROW_API_KEY> and Content-Type: application/json.
 Read the key from an environment variable named EGROW_API_KEY. It must never reach the browser.
2. Send this GraphQL mutation:
 mutation CreateOrder($input: OrderFullCreateInput!) {
 orderFullCreate(input: $input) { order { id orderNumber } userErrors { field message code } }
 }
 and map my order into `input` like this:
 orderExternalId = my order id (always), orderNumber, orderType "Order",
 paymentMethod "COD" + financialStatus "Pending" (or "Paid" when paid online), currency "MAD",
 phone, email, customer {firstName,lastName,phone,email},
 shippingAddress {firstName,lastName,phone,address1,city,province,countryCode "MA"},
 lineItems [{title,sku,externalProductId,quantity,price (unit price),imageUrl}],
 subtotal, shippingPrice, note, tags ["website"], utmParameters {source,medium,campaign,content,term}.
 Phone numbers must be in international format (+212…). Leave out fields I don't have.
3. Call it right after the order is saved, without blocking the customer's confirmation page
 (background job, queue, or after the response is sent). On failure log the error and retry
 later with the same orderExternalId — never create the same order twice.
4. Store the returned order.id and orderNumber on my order record (add a field if needed).
5. Treat a non-empty userErrors as a failure and include its messages in the log.
6. Add a small script or test that sends one sample order and prints the response.
Show me the diff, then run the test.

Invite pour les mises à jour et les annulations

Extend the eGrow integration: when an order is edited or cancelled on my site, send it again with
the mutation orderCreateOrUpdate (input type OrderCreateOrUpdateInput, same fields as before,
same orderExternalId) so eGrow updates the existing order instead of creating a new one.

Dépannage

Et ensuite ?

• Connectez votre société de livraison sous Intégrations, et activez l'automatisation qui crée le colis dès qu'une commande est confirmée.
• Activez la confirmation automatique des commandes via WhatsApp afin que les nouvelles commandes soient confirmées pendant que vous dormez.
• Poussez les paniers abandonnés avec orderType: "AbandonedCart" et laissez eGrow les récupérer.
• Explorez le reste de l'API — clients, produits, pipelines — dans le Playground.