MerchantWire SMSMerchantWire SMS Docs
Troubleshooting and support
Official merchant guidance from the MerchantWire SMS app documentation.
Updated September 24, 2026
Twilio will not connect
- Confirm the Account SID is from the Twilio account that owns the Messaging Service.
- Confirm the API Key SID begins with SK.
- Confirm the key type is Standard.
- Enter the API Key secret Twilio displayed when the key was created.
- Do not enter your Twilio Auth Token in the API Key secret field.
- If you no longer have the API Key secret, create a new Standard API key and reconnect MerchantWire SMS.
If the credentials are correct but connection still fails, check Twilio for account restrictions or billing issues.
No Messaging Service appears
Make sure the Messaging Service exists in the same Twilio account as the Account SID you connected. The service should contain the SMS-capable phone number you intend to use.
After correcting the service in Twilio, return to MerchantWire SMS and reconnect or refresh the Twilio setup.
Your sender is not ready
Open Settings → General and review the requirements for the selected messaging country. Confirm the Messaging Service contains one supported domestic SMS-capable phone number and complete any sender registration shown for that country.
For the United States, local 10-digit numbers use A2P 10DLC and toll-free numbers use Twilio's toll-free verification process.
Keep MerchantWire SMS production sending off until the sender is ready for the traffic you intend to send.
STOP / START / HELP verification fails
- Open the Messaging Service in Twilio.
- Open the Opt-out section.
- Confirm Advanced Opt-Out is enabled.
- Keep STOP in the opt-out group, START in the opt-in group, and HELP in the help group.
- Review the automatic confirmation messages.
- Return to MerchantWire SMS and run the reply check again from the test phone.
If the test still fails, confirm the sending number belongs to the selected Messaging Service and that the Twilio connection check passes.
The customer consent control is missing
- Open Settings → Customer Text Consent.
- Select Open theme settings.
- Confirm the MerchantWire SMS app embed is enabled on the published theme.
- Save the theme.
- Test the cart your customers actually use, including any cart drawer or popup.
- Return to MerchantWire SMS and select Verify setup.
If the control is still missing, contact support with the Shopify theme name and which cart experience is affected.
A test message will not send
Confirm:
- the Twilio account is connected
- the correct Messaging Service is selected
- the sender is ready
- the destination phone number is valid for the current MerchantWire SMS release
Do not repeatedly press Send while a result is still Queued or Awaiting confirmation.
A customer did not receive an order text
- Open Messages and find the order or message.
- Confirm order texts are turned on.
- Confirm the specific template is turned on.
- Confirm the customer authorized order text updates.
- If the message is scheduled, confirm its send time has passed.
- For shipping or delivery messages, confirm Shopify received the matching fulfillment or carrier event.
If the status is Failed or Undelivered, open the message and review the reason shown. Sent does not by itself confirm handset delivery.
A Text Command does not return an order update
Confirm the command is enabled under Templates → Text Commands. Ask the customer to include the order number and use the same phone number authorized for the order.
Tracking links and delivery estimates appear only when Shopify provides that information.
MerchantWire says the Shopify session expired
Open MerchantWire SMS again from Shopify Admin → Apps.
If the message appears repeatedly while you are actively using the app, note the approximate time and the page you were opening and contact support. Do not send authentication tokens or browser storage contents.
Subscription changes are not showing
Open Settings → Subscription and select Refresh subscription after completing the change in Shopify. Twilio charges are managed separately in Twilio.
Disconnecting Twilio or uninstalling
Use Settings → Twilio to disconnect MerchantWire SMS from Twilio. Messages already submitted cannot be recalled.
Your Twilio account, phone number, Messaging Service, and Twilio billing remain under your control. Uninstall MerchantWire SMS from Shopify when you no longer need the app.
Contact MerchantWire SMS support
Use the MerchantWire SMS support page.
Include:
- your store domain
- the page or setup step involved
- the approximate time
- the exact non-sensitive error message
Do not send your Twilio API Key secret, Twilio Auth Token, Shopify authentication tokens, customer phone numbers, or customer message contents. Remove customer information from screenshots.