Dans le cadre de l'intégration de systèmes de paiement avec Shopify, la gestion des statuts est une étape cruciale pour garantir le traitement des commandes. Voici une présentation détaillée des règles et mappages appliqués pour définir le statut des paiements et assurer une synchronisation optimale.
Définition du Statut pour un Paiement Réglé
Pour qu'un lien de paiement soit considéré comme réglé, son attribut status doit impérativement être défini sur COMPLETED.
- Condition essentielle : Si cet attribut n’a pas cette valeur, aucune commande ne sera importée dans Shopify.
Il est donc fondamental de valider cette condition avant toute tentative d’intégration ou d’importation de données.
👉 Référence : Consultez la section Payment Links Statuses dans la documentation Bridge pour des informations détaillées.
Mise à Jour du Statut de la Commande après Paiement
Après l’exécution d’un paiement, le système met à jour le statut de la commande en fonction de l’état des fonds associé au lien de paiement, identifié par l’attribut fund_information.status. Ce mappage est déterminé selon les règles suivantes :
Mappage des Statuts de Paiement
-
Paiement Accepté
Le paiement est considéré comme accepté lorsque le statut est l’un des suivants :
- PAID : Montant exact réglé.
- OVERPAID : Montant supérieur au montant demandé.
Ces statuts permettent de marquer la commande comme entièrement validée et prête pour le traitement.
‼️ Le statut OVERPAID indique que le paiement a été effectué via un VIBAN avec un trop perçu. Il est donc nécessaire de procéder à remboursement partiel.
-
Paiement Refusé
Le paiement est considéré comme refusé si le statut est défini comme :
- RECALLED : Paiement annulé ou ou fonds rappelés.
Dans ce cas, la commande ne sera pas traitée, et le statut final reflétera le rejet du paiement.
-
Paiement en Attente
Dans tous les autres cas non mentionnés ci-dessus, le paiement sera marqué comme en attente.
- Exception importante : Si la commande a déjà un statut final (accepté ou refusé), aucune modification du statut ne sera effectuée.
👉 Référence : Consultez la section Fund Information Status dans la documentation Bridge pour plus de précisions sur les différents états des fonds.
Conclusion
La gestion des statuts de paiement repose sur une logique claire et rigoureuse qui assure la cohérence entre les systèmes de paiement et Shopify. Le respect des conditions décrites pour les attributs status et fund_information.status est essentiel pour garantir une intégration réussie et éviter tout dysfonctionnement dans le processus de traitement des commandes.
Pour une implémentation réussie, il est recommandé de :
- Vérifier systématiquement les statuts des paiements avant l'importation des commandes.
- Se référer à la documentation Bridge pour mieux comprendre les différents états et leur impact sur le système.