Maystro Delivery
Maystro Delivery is a national courier with strong presence across Algerian wilayas. The integration is one of the simplest: a single API token is all you need.
What you need
- API token (a single bearer token issued from your Maystro merchant dashboard).
If your account doesn't expose API access, contact Maystro to enable it.
Linking Maystro in DZBuild
- Open
/dashboard/shipping. - Click Link provider and pick Maystro.
- Paste your API token in the single credential field.
- Click Test API. DZBuild calls Maystro's orders endpoint live and confirms the token works.
- Save.
What gets synced
- The list of wilayas Maystro serves (Maystro doesn't expose a wilayas endpoint, so DZBuild ships with the standard 58-wilaya list and uses Maystro's wilaya code mapping).
- Communes per wilaya.
- The stop-desk list per wilaya for the Stop Desk picker.
Per-wilaya rates are not auto-synced for Maystro — you set them manually in /dashboard/shipping. Apply a default median rate from the dashboard or override per-wilaya as needed.
What happens when an order ships
DZBuild posts the order to Maystro's orders endpoint with customer name, phone, address, COD amount (subtotal), wilaya code, commune, and weight. For desk delivery, DZBuild also passes is_stopdesk (along with stopdesk / stopdesk_id mappings Maystro accepts).
Maystro returns:
- A tracking number (saved on the order).
- A label URL at
https://backend.maystro-delivery.com/api/stores/orders_store/{tracking}/label/so you can print the bordereau.
Common errors and fixes
| Symptom | Likely cause | Fix |
|---|---|---|
| "Test API" fails immediately | Wrong or expired token | Copy a fresh token from Maystro and paste again. |
| Order rejected with a wilaya error | Wrong wilaya code | Make sure the customer's wilaya is one of the 58 standard codes — Maystro expects the code as a string. |
| No label returned | Tracking saved but label endpoint not yet ready | Wait a minute and click "Print label" again — Maystro generates labels asynchronously. |
Tips
- Maystro's Test API hits the orders list, so if your account has zero shipments yet, the response can be sparse. As long as DZBuild shows green, the token is valid.
- Set your home + desk rates manually in
/dashboard/shippingper wilaya — you can lift the prices straight from your last Maystro invoice for a fair starting point. - Maystro is a good complement to Yalidine if you want a backup courier for specific zones.