Key Takeaways
- A gift-card webhook fires when the ledger issues the PAN last-four — not when the return was approved.
- “Card issued” is operational. “Spend it this weekend” is promo with STOP.
- Free is 1 device, 300 SMS lifetime, and 300 contacts. Developer is 25,000 SMS per year. Platform price is devices plus send volume.
- Account OTP stays off the gift-card radio.
- Idempotency is return-id plus issue-id — cores re-export after a void.
Summary
Scenario 1321 is ecommerce webhooks for store credit and gift cards issued after a return — not subscription boxes packed, not certified-refurb ships, not mattress trials, not e-gift purchase receipts. Refunded is a hint. Issued is the join. Service pricing is devices plus SMS send volume. You bring the phones and operator credit. Free is 1 device, 300 SMS lifetime, and 300 contacts.
Starter allows 2 devices: treasury dual-SIM plus a spare. Uncapped platform volume is not unlimited carrier SMS. Confirm payloads in Developer Center.
refunded · issued · SMS
return-id + issue-id — voids re-export
An issued card is not a restock blast
Issued copy names amount and last-four. Weekend merch lives elsewhere. Mixing them is how a shopper STOPs the week the only credit they waited on is actually live.
If merchandising fires “your credit” when the return is approved, the shopper thinks money moved. Join issued. Suppress refunded-to-buyer templates.
Gift-card webhook matrix
| Event | SMS | Failure |
|---|---|---|
| Return approved | None or “in process” | “Issued” two days early |
| Issued | Amount + last-four | Shop stuffed in |
| Void / reissue | Once after new issue | Two issued texts |
| Account OTP | Auth pool | OTP on the gift-card radio |
Join issued, not refunded
Persist return-id plus issue-id. Signed webhooks. DLR. MCP wraps REST only.
Last-four vs catalog
The SMS is that card. A catalog carousel is marketing. FTC business guidance is not a reason to hide last-four behind a shop grid.
Devices, volume, and airtime
Return weeks spike. We meter devices and platform sends. Free (1/300/300) is one card proof.
Treasury operations
Charge the chassis before issue hours. Setup, Downloads, pricing.
Decision guide
Ship when notice joins issued. Delay if approved texts “live.” Not a CodeCanyon gift-card pack.
Gift-card checklist
- Issue-id idempotency.
- Approved silent as issued.
- Shop off issue purpose.
- OTP off gift-card SIM.
- Developer Center fields confirmed.
Next steps
Scenario 1261 box, scenario 181 RMA.
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
