# Magento invoice paid notifications on your phone

> Get a push notification when the money for a Magento order is captured, the moment you know you've actually been paid.

- Company: Magento (https://www.justpush.io/recipes/magento)
- Event: `invoice.paid` (Invoice paid)
- Tags: E-commerce, Payments
- Install: https://studio.justpush.io/recipes/magento/invoice-paid
- Web page: https://www.justpush.io/recipes/magento/invoice-paid

## 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 Invoice paid 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 **Invoice paid** field and click **Save Config**. Click **Send test**: this recipe answers with a quiet "🔔 Magento connected".
12. For online payment methods Magento usually captures the payment and creates the invoice automatically. For bank transfer, check/money order and other offline methods, the push comes when you create the invoice yourself.
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 invoice** 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 → invoice paid
// Fires when the JustPush module (justpush/magento-module-notify) reports an "invoice.paid" event:
// the money for an invoice was captured. For bank transfer and other offline methods that's
// when you create the invoice.
// 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}`
    }
}

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 invoice = body.invoice
    if (body.event !== "invoice.paid" || !invoice || typeof invoice !== "object") {
        console.log(`Ignoring Magento event "${body.event ?? "unknown"}"`)
        return null
    }

    const order = text(invoice.order_increment_id)
    const number = text(invoice.increment_id)
    const total = money(invoice.grand_total, invoice.currency)
    const customer = text(invoice.customer_name)

    return {
        title: order ? `💰 Order #${order} paid` : "💰 Invoice paid",
        message: [
            `${total ?? "A payment"}${customer ? ` from ${customer}` : " received"}`,
            number ? `invoice #${number}` : null,
            shop(body.store),
        ]
            .filter(Boolean)
            .join(" · "),
        topic: "Magento",
        priority: 0, // Normal — money in, nothing to do
        sound: "cashregister",
        buttons: link(invoice.admin_url, "Open invoice"),
    }
}
```

## Magento invoice.paid webhook payload (sample)

```json
{
  "event": "invoice.paid",
  "store": {
    "url": "https://shop.example.com/",
    "website": "Main Website",
    "store_view": "Default Store View"
  },
  "invoice": {
    "currency": "EUR",
    "admin_url": "https://shop.example.com/admin/sales/invoice/view/invoice_id/3/",
    "grand_total": "108.00",
    "increment_id": "000000003",
    "customer_name": "Jane Doe",
    "order_increment_id": "000000012"
  },
  "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.