Magento order refunded notifications on your phone.
Get a low-priority push notification when a credit memo refunds all or part of a Magento order.
Monday 5 October
9:41
JustPushnow
Order refunded
Get a low-priority push notification when a credit memo refunds all or part of a Magento order.
Three steps to your first push
STEP 01
Install the recipe
One click in Studio gives you a personal webhook URL.
STEP 02
Paste your URL into Magento
Add it as a webhook for Order refunded.
STEP 03
Get a push on your phone
With the text, sound and buttons from the recipe.
How to set up the Magento order refunded webhook
- Click Install in Studio and sign in. The recipe is added to your account and you get a personal webhook URL.
- Install the JustPush module in your shop: composer require justpush/magento-module-notify, then bin/magento setup:upgrade.
- In the Magento admin, open Stores > Configuration > Services > JustPush and set Enabled to Yes.
- Paste your webhook URL into the Order refunded field, click Save Config, then click Send test.https://••••••••/•••••••• your personal URL, shown after install
- 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:
- ```bash
- composer require justpush/magento-module-notify
- bin/magento setup:upgrade
- bin/magento cache:flush
- ```
- Then open **Stores → Configuration → Services → JustPush** in the Magento admin, set **Enabled** to **Yes**, paste the URL above into the **Order refunded** field and click **Save Config**. Click **Send test**: this recipe answers with a quiet "🔔 Magento connected".
- The module sends one message per credit memo, so an order refunded in two steps gives two pushes.
- 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**.
- The **Open credit memo** 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.
- Requests aren't signed, so keep the URL private.
What runs when the webhook arrives
Studio calls handleRequest(request) with the incoming webhook and sends the message it returns. It's yours after install; change anything.
transform.js
1// Magento → order refunded
2// Fires when the JustPush module (justpush/magento-module-notify) reports an "order.refunded" event:
3// a credit memo was created, once per credit memo.
4// Docs: https://github.com/JustPush-io/justpush-magento
5
6// The module sends plain strings; treat blanks and nulls as missing.
7function text(value) {
8 return typeof value === "string" && value.trim() ? value.trim() : null
9}
10
11// Only link to real http(s) URLs.
12function link(url, cta) {
13 return typeof url === "string" && /^https?:\/\//.test(url) ? [{ cta, url }] : []
14}
15
16// Which shop sent it, so owners of several websites can tell them apart.
17function shop(store) {
18 if (!store || typeof store !== "object") return null
19 const url = text(store.url)
20 const host = url && /^https?:\/\//.test(url) ? url.replace(/^https?:\/\//, "").replace(/\/.*$/, "") : null
21 return text(store.website) ?? text(store.store_view) ?? host
22}
23
24// The module's "Send test" button; every Magento recipe answers it.
25function testPing(body) {
26 const from = shop(body.store)
27 return {
28 title: "🔔 Magento connected",
29 message: from ? `${from} is sending to this recipe` : "Your shop is sending to this recipe",
30 topic: "Magento",
31 priority: -1, // Low — you just clicked the button
32 }
33}
34
35// Magento sends money as decimal strings ("49.00"). Returns null when there's no amount.
36function money(amount, currency) {
37 const value = Number(amount)
38 if (amount == null || amount === "" || !Number.isFinite(value) || !text(currency)) return null
39
40 try {
41 return new Intl.NumberFormat("en-GB", { style: "currency", currency: currency.trim() }).format(value)
42 } catch {
43 return `${amount} ${currency}`
44 }
45}
46
47function handleRequest(request) {
48 const body = request.body && typeof request.body === "object" ? request.body : {}
49
50 if (body.event === "test.ping") return testPing(body)
51
52 // Guard: only handle this recipe's event, so other Magento events on this integration stay quiet.
53 const memo = body.creditmemo
54 if (body.event !== "order.refunded" || !memo || typeof memo !== "object") {
55 console.log(`Ignoring Magento event "${body.event ?? "unknown"}"`)
56 return null
57 }
58
59 const order = text(memo.order_increment_id)
60 const refunded = money(memo.grand_total, memo.currency)
61 const of = money(memo.order_grand_total, memo.currency)
62 // Only say "of €x" for a partial refund.
63 const partial = refunded && of && Number(memo.grand_total) < Number(memo.order_grand_total)
64 const customer = text(memo.customer_name)
65
66 return {
67 title: order ? `↩️ Refund for order #${order}` : "↩️ Refund issued",
68 message: [
69 (refunded ? `${refunded}${partial ? ` of ${of}` : ""} refunded` : "Refund issued") +
70 (customer ? ` to ${customer}` : ""),
71 shop(body.store),
72 ]
73 .filter(Boolean)
74 .join(" · "),
75 topic: "Magento",
76 priority: -1, // Low — you (or a colleague) most likely created the credit memo yourself
77 buttons: link(memo.admin_url, "Open credit memo"),
78 }
79}
The Magento order.refunded webhook
This is what Magento sends to your URL for order refunded. It is a sample, trimmed to the fields recipes use.
order.refunded · sample.json
1{
2 "event": "order.refunded",
3 "store": {
4 "url": "https://shop.example.com/",
5 "website": "Main Website",
6 "store_view": "Default Store View"
7 },
8 "sent_at": "2026-09-30T14:29:28Z",
9 "version": 1,
10 "creditmemo": {
11 "currency": "EUR",
12 "admin_url": "https://shop.example.com/admin/sales/creditmemo/view/creditmemo_id/3/",
13 "grand_total": "49.00",
14 "increment_id": "000000003",
15 "customer_name": "Jane Doe",
16 "order_grand_total": "108.00",
17 "order_increment_id": "000000012"
18 }
19}
Magento order refunded notifications: questions
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.
Ready when you are
Magento on your phone in two minutes.
Install the recipe, paste one URL, done. Free for 30 days, no credit card required.