# Magento new order notifications on your phone

> Get a push notification with the customer, total, item count and payment method every time an order is placed in your Magento shop, from the storefront, the admin or the API.

- Company: Magento (https://www.justpush.io/recipes/magento)
- Event: `order.placed` (Order placed)
- Tags: E-commerce, Orders
- Install: https://studio.justpush.io/recipes/magento/order-placed
- Web page: https://www.justpush.io/recipes/magento/order-placed

## Setup

1. Click Install in Studio and sign in. The recipe is added to your account and you get a personal webhook URL.
2. Install the JustPush module in your shop: composer require justpush/magento-module-notify, then bin/magento setup:upgrade.
3. In the Magento admin, open Stores > Configuration > Services > JustPush and set Enabled to Yes.
4. Paste your webhook URL (shown in Studio after install) into the Order placed field, click Save Config, then click Send test.
5. Magento has no outgoing webhooks, so this recipe needs the free **JustPush module** in your shop ([source](https://github.com/JustPush-io/justpush-magento)). Install it once; it serves every Magento recipe:
6. ```bash
7. composer require justpush/magento-module-notify
8. bin/magento setup:upgrade
9. bin/magento cache:flush
10. ```
11. Then open **Stores → Configuration → Services → JustPush** in the Magento admin, set **Enabled** to **Yes**, paste the URL above into the **Order placed** field and click **Save Config**. Click **Send test**: this recipe answers with a quiet "🔔 Magento connected".
12. Orders placed with an online payment method such as iDEAL start as **pending payment**; the title then says "(awaiting payment)". Add `?unpaid=0` to the end of the URL to skip those and rely on the **Invoice paid** recipe for the money, so abandoned payments don't reach your phone.
13. The module sends from Magento's message queue, so Magento cron has to run (it usually does). Without cron, set **Send immediately (no cron)** to **Yes**.
14. The **Open order** button opens the Magento admin. With Magento's default **Add Secret Key to URLs** setting, it lands on the dashboard rather than the page itself.
15. Requests aren't signed, so keep the URL private.

## Code

Studio calls `handleRequest(request)` with the incoming webhook (`{ method, headers, body, query, raw }`) and sends the message object it returns. Returning `null` sends nothing.

```js
// Magento → order placed
// Fires when the JustPush module (justpush/magento-module-notify) reports an "order.placed" event:
// an order from the storefront, the admin, REST or GraphQL.
// Docs: https://github.com/JustPush-io/justpush-magento

// The module sends plain strings; treat blanks and nulls as missing.
function text(value) {
    return typeof value === "string" && value.trim() ? value.trim() : null
}

// Only link to real http(s) URLs.
function link(url, cta) {
    return typeof url === "string" && /^https?:\/\//.test(url) ? [{ cta, url }] : []
}

// Which shop sent it, so owners of several websites can tell them apart.
function shop(store) {
    if (!store || typeof store !== "object") return null
    const url = text(store.url)
    const host = url && /^https?:\/\//.test(url) ? url.replace(/^https?:\/\//, "").replace(/\/.*$/, "") : null
    return text(store.website) ?? text(store.store_view) ?? host
}

// The module's "Send test" button; every Magento recipe answers it.
function testPing(body) {
    const from = shop(body.store)
    return {
        title: "🔔 Magento connected",
        message: from ? `${from} is sending to this recipe` : "Your shop is sending to this recipe",
        topic: "Magento",
        priority: -1, // Low — you just clicked the button
    }
}

// Magento sends money as decimal strings ("49.00"). Returns null when there's no amount.
function money(amount, currency) {
    const value = Number(amount)
    if (amount == null || amount === "" || !Number.isFinite(value) || !text(currency)) return null

    try {
        return new Intl.NumberFormat("en-GB", { style: "currency", currency: currency.trim() }).format(value)
    } catch {
        return `${amount} ${currency}`
    }
}

// Order states worth calling out in the title; "pending" is normal for a new order.
const WAITING = {
    pending_payment: " (awaiting payment)",
    payment_review: " (payment review)",
    holded: " (on hold)",
    fraud: " (suspected fraud)",
}

function pick(table, key, fallback) {
    return typeof key === "string" && Object.prototype.hasOwnProperty.call(table, key) ? table[key] : fallback
}

function handleRequest(request) {
    const body = request.body && typeof request.body === "object" ? request.body : {}

    if (body.event === "test.ping") return testPing(body)

    // Guard: only handle this recipe's event, so other Magento events on this integration stay quiet.
    const order = body.order
    if (body.event !== "order.placed" || !order || typeof order !== "object") {
        console.log(`Ignoring Magento event "${body.event ?? "unknown"}"`)
        return null
    }

    // ?unpaid=0 skips orders still waiting for an online payment (e.g. an abandoned iDEAL payment).
    if (request.query?.unpaid === "0" && order.status === "pending_payment") {
        console.log("Order is awaiting payment and ?unpaid=0 is set — skipping")
        return null
    }

    const number = text(order.increment_id)
    const customer = text(order.customer_name) ?? (order.is_guest ? "A guest" : "A customer")
    const count = Number(order.item_count)
    const items = Number.isFinite(count) && count > 0 ? ` ${count} item${count === 1 ? "" : "s"}` : ""
    const total = money(order.grand_total, order.currency)
    const method = text(order.payment_method)
    const where = pick({ admin: "created in the admin", api: "via the API" }, order.source, null)

    return {
        title: `🛒 New order${number ? ` #${number}` : ""}${pick(WAITING, order.status, "")}`,
        message: [
            `${customer} ordered${items}${total ? ` for ${total}` : ""}${method ? ` via ${method}` : ""}`,
            where,
            shop(body.store),
        ]
            .filter(Boolean)
            .join(" · "),
        topic: "Magento",
        priority: 0, // Normal — a sale is good news, not an emergency
        sound: "cashregister",
        buttons: link(order.admin_url, "Open order"),
    }
}
```

## Magento order.placed webhook payload (sample)

```json
{
  "event": "order.placed",
  "order": {
    "source": "frontend",
    "status": "pending",
    "currency": "EUR",
    "is_guest": true,
    "admin_url": "https://shop.example.com/admin/sales/order/view/order_id/12/",
    "item_count": 2,
    "grand_total": "108.00",
    "increment_id": "000000012",
    "customer_name": "Jane Doe",
    "customer_email": "jane@example.com",
    "payment_method": "Check / Money order",
    "shipping_method": "Flat Rate - Fixed"
  },
  "store": {
    "url": "https://shop.example.com/",
    "website": "Main Website",
    "store_view": "Default Store View"
  },
  "sent_at": "2026-09-30T14:29:28Z",
  "version": 1
}
```

## FAQ

### Does this work on iPhone and Android?

Yes. Install the JustPush app from the App Store or Google Play and sign in. Every phone signed in to your account gets the notification.

### Do I need to write code?

No. Install the recipe in Studio, paste your webhook URL into Magento and you are done. The code is there if you want to change the text, the sound or the buttons.

### Can I change what the notification says?

Yes. After install the recipe's code is yours. Edit it in Studio and test it against the sample payload before you save.

### What does it cost?

JustPush is free for 30 days. After that it's $19.99 a year, or $39.99 once. There is no extra charge for recipes.