Key Takeaways
- Scenario 553 is customs-hold / import-delay webhooks — not subscription pause, size-exchange ready, fraud-review holds, preorder slips, loyalty-points expiry, gift-wrap ready, digital downloads, pre-auth holds, custom-proof approval, line-item cancels, warranty, store credit, price-match, try-on kits, subscription skips, BOPIS, waitlist restocks, preorder drops, gift-card sales, COD, split-ship, refunds, or renewals.
- “Hold CH-8 — broker docs due 12 Nov” is transactional. “Shop our duty-free drop” is marketing. Split SIMs.
- Cap SMS per hold id. Broker retries of customs.held will empty prepaid.
- Priced by devices and SMS send volume. You use your own phone and operator SMS credit. Free is 1 / 300 / 300. Developer is 25,000 SMS per year.
- Verify HMAC. A forged customs.held event nags people whose carton already cleared.
- REST fields live in Developer Center — not a CodeCanyon customs plugin. MCP, if you use it, is only a REST wrapper.
Summary
Scenario 553 is ecommerce webhooks for customs-hold notices. The broker owns the hold id. The Android texts the shopper a due date, not a shopping blast. Priced by devices and SMS send volume. You use your own phone and operator SMS credit.
If you SMS on every broker ping without a hold+date key, you will burn airtime on cartons that already cleared — and shoppers will treat CH as spam.
Customs-hold confirm
Verify the webhook signature before you enqueue. Shopify overview · webhooks guide. Fields: Developer Center. Industry notes: GSMA.
Event map
| Event | Payload | SIM | Do not |
|---|---|---|---|
| customs.held | CH id + due date | Transactional | Retry-SMS on broker ping |
| customs.cleared | Once per hold | Transactional | Bundle a shop CTA |
| Duty-free drop | Promo | Promo MSISDN | Ride the hold inbox |
| Staff login | OTP | Dedicated OTP phone | Share the hold radio |
One SMS per hold
Broker retries. Your key is hold+date. Idempotent send. DLR ≠ cleared — DLR.
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 per year. Paid plans uncap platform volume; devices still meter. Pricing.
Ops
Spare radio before a port-delay week. Doze · setup.
Security
Separate broker secrets from gateway callbacks. Trust Center · OTP. Shop STOP off the hold inbox. STOP.
Checklist
- HMAC required.
- Idempotency on hold+date.
- Cleared events capped once.
- OTP isolated.
- Airtime for port-delay week.
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
- PHP REST send samplesPHP code examples
