Does return.received SMS include carrier credit?

No. Priced by devices and SMS send volume. You use your own phone and operator SMS credit. The warehouse SIM still needs operator balance.

Can refund.issued share the return handler?

No. Split HMAC routes so a refund wave cannot starve dock texts.

Should checkout OTP use the return SIM?

No. Isolate OTP so a returns spike cannot starve login codes.

Android SMS Gateway Scenario 757: Ecommerce webhooks in practice

Key Takeaways

return.received texts the dock photo path; refund.issued texts the ledger path — never the same HMAC handler.
A refund blast on the return SIM will starve “we have the parcel” texts at the dock.
Priced by devices and SMS send volume. You use your own phone and operator SMS credit. Free is 300 SMS lifetime; Developer is 25,000 SMS per year.
This is our signed webhook path, not a CodeCanyon shop plugin. MCP only wraps REST if you add it.
Checkout OTP stays off both return and refund radios.
Developer Center owns live webhook fields.

Summary

A return scan is not a refund. Dock photos fire on return.received; ledger texts fire on refund.issued. Split HMAC handlers so a refund wave cannot starve “we have the parcel.” Priced by devices and SMS send volume. You use your own phone and operator SMS credit.

If return.received and refund.issued share one handler, the dock loses when finance fires.

Return received vs refund issued

Event	SIM	Never
return.received	Warehouse / dock	Refund copy, OTP
refund.issued	Finance / ledger	Dock photo copy
Checkout OTP	Isolated radio	Either HMAC lane

Key takeaways

Split HMAC routes for return vs refund.
Dock texts stay off the finance SIM.
Checkout OTP stays off both.
Priced by devices and SMS send volume. You use your own phone and operator SMS credit.
Not a CodeCanyon shop plugin. MCP wraps REST if you add it.
Canary both events on staff orders before peak returns.

Context

Returns ops use this ecommerce scenario to pin dock texts to return.received and ledger texts to refund.issued.

Radio reality still wins: offline phones and OEM killers break scenarios overnight.

Cross-link hub cornerstones instead of rewriting the product overview.

Keep examples conceptual until Developer Center confirms live request shapes.

Budget airtime for retries — failed loops still cost operator credit.

Core scenario guidance

Map return.received, refund.issued, and checkout-OTP moments to separate HMAC handlers before peak returns week.

Separate configuration mistakes from radio failures during incidents.

Write acceptance criteria before seasonal or clinic-hour traffic.

Prefer gradual rollout with feature flags when automation is involved.

Cost and ownership

Model returns week as devices plus volume plus airtime on signed events only. Free is 300 lifetime SMS; Developer is 25,000 SMS per year.

Failed retries still burn credit during scenario experiments.

Assign who owns SIM top-ups and spare handsets.

Keep marketing spend out of OTP device pools.

Operations

Daily checks: pairing health, battery, queue depth, and DLR anomalies.

After OEM updates or SIM swaps, re-test the scenario path end to end.

Keep a spare charged device ready for failover drills.

Name an on-call owner before unattended sends go live.

Security and compliance

Protect API keys per environment; rotate after contractor access ends.

STOP and consent still apply on promotional scenario lanes.

Avoid logging full OTP bodies into shared chat.

Verify webhook signatures and TLS on every callback path.

Decision guide

Ship return vs refund HMAC only when signature checks, slot owners, and OTP isolation are written.

Delay if you cannot explain offline-phone behavior during peak hours.

If zero phone ops is mandatory, evaluate CPaaS for that lane.

If local SIM economics matter, harden the Android path and monitor airtime.

Checklist

Scenario moments listed with owners.
OTP vs marketing isolation confirmed.
Spare device funded and paired.
Canary on staff numbers passed.
Developer Center checked if API-shaped.
Webhook/DLR monitoring ready.
Airtime budget includes retries.
On-call owner named.
Rollback path documented.
Hub cornerstone reviewed.

Next steps

Return to how an Android SMS gateway works, compare device and SMS volume pricing, open device setup guide, and confirm APIs in SMS API documentation.

Deep dive: production hardening

Canary on staff numbers before customer OTP.

Battery exemptions and OEM killers dominate overnight reliability.

Cross-link Setup, Pricing, Downloads, and Developer Center with keyword-rich anchors.

If zero phone ops is mandatory, evaluate CPaaS for that lane instead.

Webhook signature verification is non-negotiable for scenario automation.

Document who owns SIM top-ups for multi-site scenario rollouts.

Prefer honest latency expectations over marketing claims about global SLAs on SIM paths.

Scenario playbooks still bill by devices and SMS send volume. You bring the Android phone and operator SMS credit.

Developer Center owns live API parameters. Scenario blogs teach process and failure modes, not endpoint catalogs.

Ecommerce webhooks must verify signatures before they trigger SMS sends.

Clinic reminders need consent records and STOP handling even when messages feel transactional.

Logistics ETAs should degrade gracefully when devices go offline mid-route.

Edtech OTP spikes at exam windows — capacity plan devices before the semester starts.

Fintech OTP is high-stakes: isolate devices, rotate keys, and avoid logging full codes.

Real-estate nurture is promotional; keep it off OTP SIMs and honor quiet hours.

Restaurant reservation SMS still needs STOP on marketing lanes.

SaaS onboarding OTPs should canary on staff numbers before paid scale.

Field-service dispatch needs two-way inbox ownership so techs are not double-booked.

Marketplace seller alerts need multi-device failover when a single phone is the SPOF.

NGO outreach must separate fundraising blasts from operational alerts.

Appointment businesses live on reminder deliverability the morning of the visit.

Bulk CSV import needs validation before radio send; bad rows burn airtime.

Scheduled SMS must survive device sleep and timezone mistakes.

Auto-reply and STOP protect promotional lanes — never auto-reply into OTP threads.

Dual SIM routing fails when slot maps drift after reboot without re-pair.

Multi-device failover only helps if spare phones stay charged and paired.

MMS attachments inherit carrier size and APN limits.

USSD requests are carrier- and region-sensitive; treat timeouts as expected.

Contact lists need consent metadata stored with the number.

OTP priority queues fail when marketing blasts share the same device pool.

Spare charged devices matter more than brochure SLAs when phones send the SMS.

Airtime surprise bills happen when bulk loops ignore radio pace.

OTP and marketing must stay on separate lanes on every scenario.

Never claim unlimited free cloud SMS credits with no device or volume meter.

Name an on-call owner before unattended schedules go live.