Application de paiement personnalisée

Le Stripe Connector for NetSuite vous permet de rapprocher l’activité de paiement Stripe de votre intégration tierce personnalisée ou pré-construite avec NetSuite. À l’aide des outils suivants, vous pouvez personnaliser la façon dont le connecteur enregistre et rapproche les paiements dans NetSuite :

• Métadonnées Stripe
• Factures pour les paiements
• Produits additionnels du connecteur

Métadonnées Stripe

Vous pouvez utiliser les métadonnées Stripe pour vous assurer que votre activité Stripe est correctement représentée dans NetSuite.

Relier un objet Stripe à un enregistrement NetSuite

Ajoutez des métadonnées aux objets Stripe pour les relier aux enregistrements NetSuite existants. Vous pouvez ajouter ces métadonnées au moment de la synchronisation, avant que l’objet Stripe ne soit synchronisé avec NetSuite ou en conjonction avec des contrôles qui modifient le délai de synchronisation.

Vous pouvez relier les enregistrements de la manière suivante :

• Ajoutez netsuite_invoice_id: 12345 à un paiement Stripe afin que le connecteur applique le paiement client à la facture NetSuite portant l’ID interne 12345.
• Ajoutez netsuite_credit_memo_id: 67890 à un remboursement Stripe pour que le connecteur applique le remboursement du client à la note de crédit NetSuite portant l’ID interne 67890.
• Ajoutez netsuite_customer_id: 101010 à un paiement Stripe pour que le connecteur crée le paiement client sous le client NetSuite portant l’ID interne 101010.

Remplacer le délai de synchronisation

Vous pouvez choisir de remplacer le délai de synchronisation par défaut en contrôlant de manière programmatique le moment où un enregistrement est synchronisé avec NetSuite. Il existe deux façons de modifier le délai de synchronisation des enregistrements : ajouter des enregistrements à une liste de rejet ou ajouter des enregistrements à une liste d’autorisation.

Ajouter des enregistrements à une liste de rejet

Vous pouvez ajouter des métadonnées pour empêcher temporairement le connecteur de synchroniser un enregistrement avec NetSuite. Cela est utile si votre intégration back-end avec Stripe nécessite d’ajouter des données à un enregistrement avant de le synchroniser avec NetSuite.

Utilisez une liste de rejet pour contrôler le moment de synchronisation d’un client avec NetSuite :

1. Demandez à votre partenaire d’implémentation d’activer la fonction Paiements et remboursements de la liste de rejet dans les paramètres de votre application Stripe. Consultez votre partenaire d’implémentation pour comprendre toutes les implications financières et techniques.
2. Ajoutez netsuite_block_integration: true aux métadonnées de tout objet Stripe.
3. Pour autoriser à nouveau la synchronisation des enregistrements, remplacez true par nil.

Vous ne pouvez pas ajouter un paiement ou un enregistrement lié à un paiement à la liste de rejet de façon permanente. Au bout de 2 jours, le connecteur tente automatiquement de créer un versement bancaire pour le virement Stripe. Tant que vous ne supprimez pas le paiement ou l’enregistrement de la liste de rejet, l’automatisation du versement échoue et le paiement ou l’enregistrement ne peut pas être synchronisé avec NetSuite.

Exemples

Les exemples suivants illustrent les cas dans lesquels il est possible d’utiliser une liste de rejet :

Exemple 1 : vous pouvez avoir un enregistrement client que votre système a créé lorsqu’un client Stripe a commencé le processus d’inscription et a effectué un prépaiement. Plus tard, vous collectez des données d’adresse de ce client. En règle générale, le connecteur synchronise immédiatement les données relatives au client et au paiement avec NetSuite. Vous pouvez toutefois retarder la synchronisation avec NetSuite jusqu’à ce que vous ayez fini de collecter toutes les données relatives à un client.

Exemple 2 : votre compte Stripe comprend Stripe Billing et une application de e-commerce. Vous souhaitez associer les paiements de l’application de e-commerce à vos commandes NetSuite et synchroniser automatiquement les factures d’abonnement et les paiements. Pour ce faire, ajoutez des métadonnées aux paiements provenant de l’application de e-commerce. Le connecteur synchronise les factures et les paiements Stripe Billing avec NetSuite. Les paiements de l’application de e-commerce sans identifiant de commande ou de facture NetSuite ne sont pas synchronisés tant que la commande ou la facture associée n’est pas importée dans votre compte NetSuite. Une fois les informations de la commande ajoutées, vous pouvez supprimer les métadonnées de la liste de rejet et ajouter l’identifiant de la facture NetSuite pour associer les enregistrements.

Ajouter des enregistrements à une liste blanche

Vous pouvez ajouter des métadonnées pour empêcher le connecteur de synchroniser un enregistrement avec NetSuite tant qu’il n’en a pas reçu l’autorisation. Cela s’avère utile si vous disposez d’un système de e-commerce qui utilise Stripe pour traiter les paiements avant que la facture ne soit créée dans NetSuite.

Utilisez une liste d’autorisation pour contrôler la synchronisation d’un enregistrement avec NetSuite :

1. Demandez à votre partenaire d’implémentation d’activer la fonction Paiements de la liste d’autorisation dans les paramètres de votre application Stripe. Consultez votre partenaire d’implémentation pour comprendre toutes les implications financières et techniques.
2. Ajoutez netsuite_allow_integration: true aux métadonnées d’un enregistrement.

N’utilisez pas de liste d’autorisation si l’une des situations suivantes s’applique :

• Vous utilisez Stripe Billing. Dans la plupart des cas, Stripe génère automatiquement des factures, ce qui peut entraîner des difficultés à s’assurer que les factures sont ajoutées à la liste d’autorisation. Au lieu de cela, vous pouvez utiliser une liste de rejet pour les paiements qui ne sont pas liés à Stripe Billing.
• Vous ne disposez pas d’un système personnalisé complet qui tient compte de chaque paiement dans votre compte Stripe. Si un paiement de votre compte Stripe n’est pas synchronisé avec NetSuite, l’automatisation des versements échoue jusqu’à ce que le paiement soit synchronisé.

Ignorer la création d’enregistrements NetSuite

Remplacez n’importe quelle partie du processus de synchronisation des enregistrements du connecteur en ajoutant des métadonnées aux objets Stripe pour les relier aux enregistrements NetSuite existants. Vous pouvez ajouter ces métadonnées au moment de la synchronisation, avant que l’objet Stripe ne soit synchronisé avec NetSuite, ou en combinaison avec des contrôles qui modifient le délai de synchronisation. Cela empêche le connecteur de créer des enregistrements dans NetSuite.

Par exemple, vous avez un système existant qui crée des clients que vous souhaitez utiliser avec le connecteur. Vous pouvez transmettre l’ID interne du client NetSuite au client Stripe pour permettre au connecteur de créer un lien entre les deux, plutôt que de créer un nouveau client. Vous pouvez également utiliser le même processus pour lier les tarifs Stripe aux éléments NetSuite existants.

Consultez ci-dessous la liste des clés de métadonnées permettant de lier les enregistrements et d’annuler la création d’un enregistrement.

Si vous utilisez le paramètre de garantie du meilleur prix, celui remplace la méthode d’ajout de la clé de métadonnées netsuite_service_sale_item_id à l’objet prix.

Clés de métadonnées du connecteur

Le connecteur utilise des clés de métadonnées pour relier les objets Stripe aux enregistrements NetSuite existants. Vous pouvez ajouter ces métadonnées au moment de la synchronisation, avant que l’objet Stripe ne soit synchronisé avec NetSuite, ou en combinaison avec des contrôles qui modifient le délai de synchronisation.

Factures pour les paiements

Si votre système utilise Stripe pour traiter les paiements et qu’il crée un paiement dans Stripe qui n’est pas associé à une facture, vous pouvez autoriser le connecteur à créer une facture à partir des informations du paiement. Le connecteur applique ensuite un paiement client pour représenter le revenu et la trésorerie de cette transaction.

Ce flux de travail ne prend pas en charge les ristournes, les postes multiples et autres intégrations complexes.

Fonctionnement

1. Le connecteur crée une facture NetSuite pour chaque paiement dans Stripe et inclut la description de ce paiement dans une note sur la facture. Vous pouvez choisir d’ajouter les données issues des champs de métadonnées de Stripe à la facture en utilisant des mappages de champs.
2. La facture utilise un seul poste pour représenter les revenus générées par l’ensemble du paiement Stripe. Par défaut, tous les paiements sur le compte Stripe utilisent le même élément NetSuite. Vous pouvez personnaliser ce comportement.
3. Le connecteur crée un paiement et l’applique à la facture. Le paiement est automatiquement rapproché d’un versement bancaire et les frais sont enregistrés.
4. Les remboursements et les litiges se présentent automatiquement sous la forme d’une note de crédit et d’un remboursement.

Personnaliser le poste de facture NetSuite

Toutes les factures générées à partir de paiements utilisent par défaut le même poste NetSuite (poste de facture générique Stripe). Si les paiements sont utilisés pour acheter plusieurs types de produits dans votre appli, vous devez enregistrer les revenus pour les différents produits avec des éléments NetSuite uniques. Cela vous permet d’avoir des rapports détaillés dans NetSuite basés sur les revenus par élément, la quantité d’éléments vendus et plus encore.

Vous ne pouvez pas avoir plusieurs postes de facture provenant de paiements. Le connecteur ne peut pas répartir les revenus sur des éléments distincts à partir des informations de métadonnées sur les paiements Stripe. Si vous devez utiliser plusieurs postes sur votre facture NetSuite, vous pouvez utiliser une facture Stripe pour synchroniser les informations des postes.

Vous pouvez utiliser des métadonnées ou un champ standard sur le paiement Stripe pour sélectionner un élément NetSuite. Le connecteur utilise les métadonnées ou les champs Stripe pour rechercher un champ sur l’élément NetSuite. Si le connecteur ne trouve pas de correspondance, il utilise le poste de facture générique de Stripe. Les correspondances ne sont pas sensibles à la casse.

Par exemple, vous créez un paiement Stripe et ajoutez les métadonnées product_name qui incluent le nom d’un élément NetSuite. Le connecteur recherche un élément dans NetSuite qui correspond au product_name dans Stripe. Si le connecteur trouve une correspondance, il utilise cet élément sur la facture créée pour ce paiement.

Utiliser les factures pour le tunnel de paiements :

1. Demandez à votre partenaire d’implémentation d’activer la fonction Créer des factures pour les paiements dans les paramètres de votre application Stripe. Consultez votre partenaire d’implémentation pour comprendre toutes les implications financières et techniques.
2. Faites ce qui suit pour que le connecteur puisse effectuer la mise en correspondance :
   • Ajoutez un champ NetSuite à l’enregistrement de l’élément
   • Ajoutez le champ Stripe correspondant à l’objet Charge

Par exemple, vous pouvez ajouter une clé de métadonnées sur un paiement Stripe et ajouter les champs itemid ou displayName sur l’élément NetSuite.

Produits additionnels du connecteur

Le connecteur fournit des produits additionnels NetSuite (bundles) pour prendre en charge les cas d’usage courants et permettre un fonctionnement transparent avec des flux de travail de base. Vous pouvez travailler avec un partenaire d’implémentation officiel pour personnaliser votre intégration avec ces modules produits additionnels, qui existent exclusivement dans NetSuite.

Vous pouvez personnaliser les produits additionnels en développant de nouveaux flux de travail ou en modifiant les flux existants pour les adapter aux besoins de votre entreprise. Par exemple, vous pouvez aligner les processus de paiement et de rapprochement sur votre configuration NetSuite unique tout en continuant à utiliser les automatisations de base du connecteur.

Produit additionnel Autopay

Utilisez le produit addditionnel Autopay pour facturer automatiquement le mode de paiement enregistré par votre client et payer les factures en cours dans NetSuite. Vous pouvez modifier les détails de facturation, tels que la cadence et les paramètres, pour vous assurer que les bonnes factures sont facturées.

Produit additionnel NetSuite Initiated Refunds

Utilisez le produit additionnel NetSuite Initiated Refunds pour déclencher des remboursements Stripe à partir de NetSuite, au lieu du Dashboard ou de l’API Stripe. Les enregistrements NetSuite sont liés ou créés automatiquement dans divers scénarios pour représenter pleinement le remboursement Stripe.

Produit additionnel Payment Linker

Si vous intégrez Stripe à un service tiers, tel qu’un site d’e-commerce, vous pouvez utiliser le produit additionnel Payment Linker pour synchroniser automatiquement les paiements Stripe en tant que versements clients appliqués aux commandes NetSuite, ou en tant que paiements appliqués aux factures NetSuite. Stripe prend en charge les flux de capture initiale totale ou de capture d’authentification.