Key Takeaways
- Scenario 1933 is refund, cancel, and restock webhooks — not the paid/shipped path from other ecommerce posts.
- A cancelled order must suppress the “out for delivery” SMS already in the radio queue, or you will text a ghost parcel.
- Restock “back in stock” is marketing. Refunds are transactional. Split SIMs and STOP stores.
- Priced by devices and SMS send volume. You use your own phone and operator SMS credit. Free is 1 device, 300 SMS lifetime, 300 contacts.
- Shop signature first. Idempotency on refund id, not SKU.
- Developer Center owns send fields. The shop owns refund webhook docs.
Summary
Scenario 1933 is ecommerce webhooks for refunds, cancels, and restock on an Android gateway. The storefront emits money-moving events. Your worker authenticates them, cancels stale fulfillment SMS, then maybe sends a refund stub. Priced by devices and SMS send volume. You use your own phone and operator SMS credit.
A refund hook that only sends “we refunded you” and never kills the in-flight shipped text is how you pay for two lies on the same order.
Refund and cancel hooks
Map refund.create / order.cancelled to a worker that (1) verifies HMAC, (2) voids unsent fulfillment jobs for that order id, (3) enqueues one refund template. Shopify overview · gateway webhooks. Send fields: Developer Center. Industry context: GSMA.
Event map
| Shop event | SMS job | Queue action | SIM |
|---|---|---|---|
| order.cancelled | Optional “cancelled” stub | Drop unpaid/ship jobs | Transactional |
| refund.create | Amount band + portal — not full PAN | Idempotent on refund id | Transactional |
| inventory.restock | Back-in-stock nudge | Consent + quiet hours | Promo MSISDN |
| staff login | OTP | Never share refund volume | Dedicated OTP phone |
Restock is not a sale blast
Waitlist opt-in is required. Cap how often a SKU may SMS the same MSISDN. STOP · idempotent send.
Cost
Priced by devices and SMS send volume. You use your own phone and operator SMS credit. Free: 1 device, 300 SMS lifetime, 300 contacts. Developer: 25,000 SMS/year. Paid plans uncap platform volume; devices still meter. We do not sell unlimited carrier SMS. Pricing.
Ops
Alert on “refund sent but ship DLR still pending.” Canary a cancel fixture after OEM updates. Doze · setup · DLR.
Security
Separate shop secrets from gateway callback secrets. Do not SMS full card last-four plus refund reason that leaks fraud notes. Trust Center · OTP.
Checklist
- HMAC required in production.
- Unsent fulfillment jobs voided on cancel/refund.
- Refund id idempotency.
- Restock on promo SIM with STOP.
- OTP isolated; airtime for retries.
Next steps
Ecommerce templates · SMS API documentation.
Related product pages
Jump to the live product docs for this topic—not another long-form article.
- SMS webhook integrationInbound and status events
- transactional SMS for orders and alertsEvent-driven messages
- SMS API documentationLive endpoint reference
- device and SMS volume pricingPlans and allowances
