How do I connect SMSA Express to my store?
The SMSA Express app sends your cash-on-delivery orders to SMSA across Saudi Arabia, collects cash in SAR, prints waybills and follows every parcel.
Steps
- Get your keys. Ask your SMSA account manager for the eCommerce API key (sandbox and live keys are different).
- In Dropify, go to Apps → Discover, find SMSA Express and click Install.
- Open it from Apps → My apps. Click Connect, paste the API key, then click Connect.
- Fill the Pickup address with a Saudi mobile number. Leave Service code empty unless SMSA gave you one.
- Live tracking: Ask SMSA to send status updates to the Webhook address (it already carries your secret), or to send the value shown under X-Dropify-Webhook-Secret value in that header.
- Set each product to ship with SMSA Express: Products → edit the product → Fulfillment and Shipping → Fulfillment Center = SMSA Express. Automatically send orders to sends new orders on their own.
- Send an order: on the order page, the SMSA Express parcel card has Send to SMSA Express (or select orders in Orders and use Send to SMSA Express). The tracking number then appears on the order.
- From the same card: Print bordereau, Refresh tracking. Orders move to Shipped, Delivered or Returned automatically.
Common problems
- "SMSA refused this API key."ask your SMSA account manager for the eCommerce API key.
- "None of the products in this order are set to ship with SMSA Express."edit the product and set Fulfillment Center to SMSA Express (Products → product → Fulfillment and Shipping).
- "SMSA Express does not know the city … of order #…"open the order, click Choose delivery area, pick the city from SMSA Express's list and type the area, then send again.
- "SMSA Express collects cash in SAR only, and this order is in …"SMSA Express collects cash in SAR. If the buyer already paid, mark the order as paid and send again: it ships with no cash to collect.