ANS-1644 · DéVELOPPEMENT SUITESCRIPT
Scripting des paiements NetSuite : adaptation aux moyens de paiement
Découvrez comment mettre à jour les scripts NetSuite existants afin de traiter correctement les paiements par carte bancaire lorsque la fonctionnalité « Instruments de paiement » est activée, ce qui permet d’éviter les divergences au niveau des événements de paiement.
Solution courte
Lorsque la fonctionnalité « NetSuite Payment Instruments » est activée, les scripts doivent utiliser la sous-liste « paymentinstruments » au lieu de « creditcard » pour récupérer les détails de paiement. Définissez le champ « paymentoption » sur l’identifiant du moyen de paiement et assurez-vous que le champ de déclenchement de l’événement de paiement (par exemple, « chargeit ») est défini sur « T » afin de garantir que les prélèvements sur la carte de crédit soient effectivement effectués.
Scénario
Après avoir activé les fonctionnalités « Instruments de paiement » et « Lien de paiement » de NetSuite, les organisations disposant de processus de création de paiements personnalisés, en particulier celles utilisant des scripts planifiés, peuvent rencontrer des problèmes. Les scripts conçus pour d’anciens modes de paiement peuvent ne pas parvenir à créer les événements de paiement, ce qui peut entraîner des situations où les paiements sont enregistrés dans NetSuite mais où les transactions par carte bancaire ne sont pas réellement effectuées, d’où un manque à gagner.
Solution
Pour garantir le bon fonctionnement des scripts avec les moyens de paiement NetSuite, les modifications suivantes sont nécessaires :
Lorsque vous lisez les informations de carte de crédit à partir d’une fiche client, utilisez la sous-liste « paymentinstruments » à la place de la sous-liste « creditcard », désormais obsolète. Pour SuiteScript 2.x, cela implique d’utiliser :
record.getSublistValue('paymentinstruments', ...)Lors de la définition de l’option de paiement pour une transaction, attribuez la valeur du champ « id » du moyen de paiement au champ « paymentoption ». Cette approche diffère de la précédente, où le champ « paymentmethod » était utilisé pour les types génériques tels que VISA ou le chèque.
Assurez-vous que le champ concerné chargé de déclencher les événements de paiement (qui peut s’intituler « chargeit » ou un nom similaire, selon la version et la configuration de NetSuite) est défini sur « T ». Si vous ne le faites pas, la création des événements de paiement sera empêchée, ce qui signifie que la carte de crédit ne sera pas réellement débitée.
Tout code SuiteScript existant qui tente de lire ou de faire référence au champ « paymentmethod » devra être mis à jour pour lire le champ « paymentoption » à la place.
Ces ajustements sont essentiels pour garantir que les paiements traités via un script génèrent correctement des événements de paiement et mènent à bien la transaction financière lorsque la fonctionnalité « Instruments de paiement » est active.
Support expert NetSuite
Besoin d’aide pour cet enjeu NetSuite ?
Accompagnement-conseil et configuration pour Développement SuiteScript