Key Takeaways
- Refund and chargeback webhooks are money copy. Idempotency on refund id stops “we refunded you” three times.
- Do not put full PAN, raw gateway errors, or a surprise promo in a refund SMS.
- Checkout OTP stays on its own SIM. A chargeback storm must not starve login.
- Service pricing is devices plus SMS send volume. You bring the Android phone and operator credit.
- Free is 1 device, 300 SMS lifetime, 300 contacts.
- Unsigned PSP retries plus staging will text real buyers that a refund posted when it did not.
Summary
Ecommerce webhooks in scenario 169 are refund, partial refund, and chargeback-opened events. Unlike paid-order receipts or restock waitlists, this copy is money. The Android SIM will send whatever your hook enqueues — including a PSP replay that says refunded when finance has not posted it.
Service pricing is devices plus SMS send volume. You bring the Android phone and operator SMS credit. Free is 1 device, 300 SMS lifetime, 300 contacts. Do not title Unlimited SMS. Paid SKUs can uncap platform send volume; devices and carrier bills still apply.
Three “your refund is on the way” texts from one chargeback are not reassurance. They are a support queue you paid airtime to create.
Key takeaways
- Refund and chargeback webhooks are money copy. Idempotency on refund id stops “we refunded you” three times.
- Do not put full PAN, raw gateway errors, or a surprise promo in a refund SMS.
- Checkout OTP stays on its own SIM. A chargeback storm must not starve login.
- Service pricing is devices plus SMS send volume. You bring the Android phone and operator credit.
- Free is 1 device, 300 SMS lifetime, 300 contacts.
- Unsigned PSP retries plus staging will text real buyers that a refund posted when it did not.
Related reading
Use Laravel SMS gateway, how an Android SMS gateway works, SMS API documentation, and HMAC (RFC 2104).
Context
Finance and support land here after a PSP retried refund.paid four times and buyers called asking which one was real. Radio reality still wins: a Doze-killed phone means the queue looks healthy while money SMS never leaves. Cross-link hubs; do not rewrite the product overview.
Core scenario guidance
Verify signature, timestamp skew, idempotency on refund id, enqueue. Amount and last4 only — no PAN. Checkout OTP isolated. Do not attach a coupon to a chargeback SMS.
| Event | SMS action | Do not |
|---|---|---|
| refund.paid | One status per refund id | Send from the HTTP thread |
| refund.partial | Amount + portal | Imply full refund |
| dispute.opened | Short status, no blame copy | Include raw PSP errors |
| staging replay | Reject unsigned / wrong audience | Point staging at production SIMs |
Acceptance: “one SMS per refund id even if the PSP fires four times.” Developer Center owns live fields.
Cost and ownership
Devices + volume + airtime. Duplicates burn credit and trust. Assign webhook-secret rotation and SIM top-ups. Free (1 / 300 / 300) is a signed-path lab. Chargeback week needs a device-and-volume plan.
Operations
Daily pairing, battery, queue, DLR, duplicate-refund rate. After OEM updates, refund a sandbox order end to end. Spare charged device. On-call before night PSP batches.
Security and compliance
Protect secrets. Never log PAN. STOP applies if you later promo from this CLI — better: never promo from the refund number. TLS and HMAC on every callback.
Decision guide
Ship when refund-id locks and fallbacks exist. Delay if offline-phone behavior during a PSP batch is unexplained. If zero phone ops is mandatory, evaluate CPaaS for that lane.
Checklist
- HMAC + idempotency on refund id.
- No PAN in templates.
- Staging cannot reach production SIMs.
- OTP isolated.
- Spare device paired.
- On-call named.
Next steps
Return to Laravel SMS gateway, compare device and SMS volume pricing, open device setup, and confirm APIs in SMS API documentation.
Deep dive: production hardening
Ecommerce webhooks must verify signatures before they trigger SMS. Refund copy is not a coupon slot. Battery exemptions dominate overnight PSP jobs. Name on-call before unattended schedules. Document who owns SIM top-ups.
Deep dive: scaling and failure modes
Chargeback weeks add devices or they drop texts. Multi-device failover only helps if spares stay charged. Do not bypass the signed hook with an Excel panic. Never claim unlimited free cloud SMS credits with no device or volume meter.
Deep dive: integration discipline
Developer Center owns live API parameters. If zero phone ops is mandatory, evaluate CPaaS. Scenario playbooks still bill by devices and SMS send volume. You bring the Android phone and operator SMS credit. Cross-link Setup, Pricing, Downloads, and Developer Center.
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





