# Comment connecter SMSA Express à ma boutique ?

L'application **SMSA Express** envoie vos commandes en paiement à la livraison à SMSA partout en Arabie Saoudite, encaisse en SAR, imprime les bordereaux et suit chaque colis.

## Étapes

1. **Récupérez vos clés.** Demandez la clé API eCommerce à votre chargé de compte SMSA (les clés sandbox et live sont différentes).
2. Ouvrez **Applications → Découvrir**, trouvez **SMSA Express** et cliquez sur **Installer**.
3. Ouvrez-la depuis **Applications → Mes applications**. Cliquez sur **Connecter**, collez la **Clé API**, puis validez avec **Connecter**.
4. Remplissez l'**Adresse de ramassage** avec un numéro de mobile saoudien. Laissez **Code de service** vide sauf si SMSA vous en a donné un.
5. **Suivi en direct :** demandez à SMSA d'envoyer les changements de statut à l'**Adresse du webhook** (elle contient déjà votre secret), ou d'envoyer la valeur affichée sous **Valeur de X-Dropify-Webhook-Secret** dans cet en-tête.
6. Liez chaque produit à SMSA Express : **Produits** → modifiez le produit → **Traitement et livraison** → **Centre de traitement** = SMSA Express. Avec **Envoyer automatiquement les commandes à**, les nouvelles commandes partent seules.
7. Sur la page d'une commande, la carte **Colis SMSA Express** propose **Envoyer à SMSA Express** (ou en lot depuis **Commandes** → **Envoyer à SMSA Express**). Le numéro de suivi apparaît ensuite sur la commande.
8. Sur la même carte : **Imprimer le bordereau**, **Actualiser le suivi**. Les commandes passent seules à Expédiée, Livrée ou Retournée.

## Problèmes courants

- « SMSA a refusé cette clé API. » → demandez la clé API eCommerce à votre chargé de compte SMSA.
- « Aucun produit de cette commande n'est configuré pour être expédié avec SMSA Express. » → réglez le **Centre de traitement** du produit sur SMSA Express (**Produits** → produit → **Traitement et livraison**).
- « SMSA Express ne connaît pas la ville … de la commande #… » → ouvrez la commande, cliquez sur **Choisir la zone de livraison**, choisissez la ville dans la liste de SMSA Express et saisissez la zone, puis renvoyez-la.
- « SMSA Express encaisse uniquement en SAR, et cette commande est en … » → si l'acheteur a déjà payé, marquez la commande payée et renvoyez-la : rien ne sera encaissé.

## Voir aussi

- [Quel coursier / appli COD dois-je connecter sur Dropify ?](https://help.dropify.shop/fr/shipping/choose-a-courier-integration/)
- [Comment connecter Aramex à ma boutique ?](https://help.dropify.shop/fr/shipping/aramex/)
- [Comment connecter AyMakan à ma boutique ?](https://help.dropify.shop/fr/shipping/aymakan/)
- [Comment connecter Torod à ma boutique ?](https://help.dropify.shop/fr/shipping/torod/)
