Migration ou importation d'abonnements récurrents automatiques

Avant de lire cette page, assurez-vous d'avoir pris connaissance de notre  Aperçu de la migration page en premier !

Quand importer des abonnements récurrents

Présentation vidéo

Veuillez noter que les vidéos de cette page montrent l'ancien identifiant Stripe que nous utilisions pour les abonnements (cus_xxxxxxxxxxx). Les identifiants corrects que vous devez utiliser maintenant pour toutes les importations futures sont les identifiants d'abonnement (sub_xxxxxxxxxxx).

Instructions générales

Vous devez UNIQUEMENT importer des abonnements récurrents pour les raisons suivantes :

1. Vous migrez des profils récurrents automatisés (pour PayPal, Authorize.Net ARB ou Stripe) à partir d'un autre système. 
2. Vous devez importer manuellement un abonnement qui n'a pas été ajouté correctement à MemberPress en raison d'une défaillance de la passerelle.

Cela signifie que, quels que soient les abonnements récurrents que vous importez MUST être des abonnements réels et actifs actuellement trouvés dans votre processeur de passerelle (PayPal, Authorize.Net ARB ou Stripe). L'importation ne crée PAS et ne peut pas créer d'abonnements ou de frais réels. L'importation est utilisée pour ajouter simplement des données existantes. 

Remarque importante : Avant d'importer les fichiers décrits, vous devez vous assurer que vous avez d'abord créé les adhésions dans MemberPress auxquelles ces abonnements seront associés. ET que les utilisateurs auxquels ils seront attribués se trouvent dans votre tableau de bord WordPress > section Utilisateurs. 

Pour importer des abonnements récurrents, vous devez importer deux distincts les fichiers CSV dans l'ordre suivant :

1. Fichier CSV des abonnements
2. Fichier CSV des transactions (si vous n'avez pas besoin d'importer un grand nombre de transactions, veuillez noter qu'il peut être plus facile et plus rapide pour vous de créer simplement un fichier transactions manuelles pour le(s) abonnement(s) que vous importez - vous ne pouvez pas créer manuellement des abonnements).

Veillez à respecter scrupuleusement le formatage indiqué ci-dessous. Si vous ne le faites pas EXACTEMENT volonté votre fichier ne sera pas importé correctement. 

Retour en haut de la page

Format de fichier CSV pour les abonnements

Cliquez ici pour un exemple de fichier CSV d'abonnements. Sur la base de ce modèle, vous trouverez ci-dessous les colonnes obligatoires et facultatives de votre fichier CSV.

Instructions vidéo

Veuillez noter que les vidéos de cette page montrent l'ancien identifiant Stripe que nous utilisions pour les abonnements (cus_xxxxxxxxxxx). Les identifiants corrects que vous devez utiliser maintenant pour toutes les importations futures sont les identifiants d'abonnement (sub_xxxxxxxxxxx).

Colonnes obligatoires :

• nom d'utilisateur OU email - Vous pouvez saisir 'nom d'utilisateur' OU 'email' pour l'en-tête de votre colonne (les deux ne sont PAS pris en charge dans un même fichier). Si vous utilisez 'username', utilisez le nom d'utilisateur de l'utilisateur qui doit être associé à la transaction. Si vous utilisez 'email', entrez l'email de l'utilisateur. Votre sélection doit appartenir à un utilisateur existant dans la base de données. (Remarque : depuis la version MemberPress Importer 1.6.8, vous pouvez également utiliser user_email au lieu de email)
• product_id - L'identifiant de l'adhésion pour laquelle cet abonnement est souscrit. Il doit s'agir de l'identifiant d'une adhésion déjà existante dans la base de données.
• sub_num ou subscr_id - Le numéro d'abonnement qui fait référence à l'abonnement. Remarque : pour Stripe, nous utilisons l'ID de l'abonnement pour le sous-numéro (sub_xxxxxxxxxx). Pour PayPal, nous utilisons l'ID du profil (I-xxxxxxxxxx).
• montant ou prix - Prix de l'adhésion. Il peut s'agir de n'importe quel nombre au format décimal sans symbole monétaire - par exemple 5.99
• total - Prix incluant les taxes (le cas échéant). total = (montant + tax_amount). S'il n'y a pas de taxe, cette valeur doit être la même que celle du champ "montant".
• period - Nombre de semaines, de mois ou d'années. Il peut s'agir de n'importe quel nombre entier valide si le period_type='months' ou le period_type='weeks', mais dans tous les autres cas, il ne peut s'agir que de 1.
• period_type - Il s'agit du type de période. Il peut s'agir de "semaines", "mois", "années" ou "vie entière".
• mode de paiement ou gateway - L'identifiant unique de la méthode de paiement. Cet identifiant se trouve dans le champ onglet paiements de la page MemberPress Settings. Elle doit faire référence à la passerelle réelle où le profil récurrent du client existe. Ainsi, si vous utilisez PayPal Express Checkout, par exemple, assurez-vous que l'identifiant de cette passerelle est défini ici.

Colonnes optionnelles :

• id - Met à jour les informations relatives à l'abonnement existant correspondant à l'id. S'il est laissé vide, cela créera un nouveau abonnement. Veillez à utiliser l'identifiant figurant dans la colonne "Id" de la page MemberPress > Abonnements, comme indiqué ci-dessous. ici. Ce champ nécessite la version MemberPress Importer 1.6.0 ou une version plus récente.
• trial - Définit si l'adhésion est assortie ou non d'une période d'essai. La valeur peut être 1 pour true (vrai) ou 0 pour false (faux). La valeur par défaut est 0.
• trial_days - Nombre de jours que durera l'essai. Il peut s'agir de n'importe quel nombre entier. La valeur par défaut est 0.
• trial_amount - Le montant qui sera facturé pour démarrer l'essai. Il peut s'agir de n'importe quel nombre au format décimal sans symbole monétaire - par exemple 5.99
• limit_cycles - Limite ou non le nombre de cycles de paiement. Doit être 1 pour oui ou 0 pour non. La valeur par défaut est 0.
• limit_cycles_num - Nombre de cycles de paiement réguliers avant que l'abonnement ne soit annulé. Ce nombre n'inclut pas le paiement de la période d'essai. Si limit_cycles est fixé à 0 ou laissé vide, ce paramètre n'a aucun effet. Il peut s'agir de n'importe quel nombre supérieur ou égal à 1. La valeur par défaut est 2.
• limit_cycles_action - Que faire après l'annulation de l'abonnement. Il peut être défini sur "expire" ou "lifetime". La valeur par défaut est "expire".
• prorated_trial - Indique si la période d'essai a été calculée au prorata dans le cadre d'une mise à niveau ou d'un déclassement. Doit être 1 pour oui ou 0 pour non. La valeur par défaut est 0.
• status - L'état de l'abonnement. Il peut être "en attente", "actif" ou "annulé". La valeur par défaut est "actif".
• started_at ou created_at - Date de début de l'abonnement. Doit être au format "YYYY-MM-DD hh:mm:ss". La valeur par défaut est l'heure actuelle. NOTE IMPORTANTE: Pour les abonnements mensuels, il est important que cette date soit fixée au même jour du mois que celui de la facturation. Ainsi, si l'abonnement est facturé le 12 de chaque mois, assurez-vous que cette date est également le 12 du mois. Sinon, les dates d'expiration de votre transaction seront incorrectes lors des renouvellements après l'importation.
• coupon_code - Le code du coupon appliqué à cette transaction. Doit faire référence à un coupon qui existe déjà dans la base de données. La valeur par défaut est "blank".
• tax_rate - Le taux d'imposition en %. Exemple 5% doit être saisi comme 5.000. La valeur par défaut est 0.
• tax_amount - Le montant de la taxe appliqué au total. tax_amount = (amount*(tax_rate/100)). La valeur par défaut est 0.
• tax_desc - Description de la taxe. La valeur par défaut est "pas de description".
• tax_class - Non utilisé dans MemberPress actuellement. La valeur par défaut est "standard".
• cc_last4 - Les 4 derniers chiffres de la carte de crédit utilisée pour acheter l'abonnement. Non pris en charge par toutes les passerelles.
• cc_exp_month - Le mois (1-12) au cours duquel la carte de crédit utilisée pour acheter cet abonnement expire. Non pris en charge par toutes les passerelles.
• cc_exp_year - L'année (20xx) d'expiration de la carte de crédit utilisée pour acheter cet abonnement. Cette option n'est pas compatible avec toutes les passerelles.

Veuillez noter que vous ne pouvez pas utiliser le même fichier CSV pour importer simultanément des abonnements et des transactions. Ceux-ci doivent être importés séparément.

Retour en haut de la page

Format CSV des transactions

Instructions vidéo

Veuillez noter que les vidéos de cette page montrent l'ancien identifiant Stripe que nous utilisions pour les abonnements (cus_xxxxxxxxxxx). Les identifiants corrects que vous devez utiliser maintenant pour toutes les importations futures sont les identifiants d'abonnement (sub_xxxxxxxxxxx).

Veillez à respecter scrupuleusement le formatage indiqué ci-dessous. Si vous ne le faites pas EXACTEMENT volonté votre fichier ne sera pas importé correctement. 

Cliquez ici pour un exemple de fichier CSV sur les transactions. Sur la base de ce modèle, vous trouverez ci-dessous les colonnes obligatoires et facultatives de votre fichier CSV.

Colonnes obligatoires :

• nom d'utilisateur ou adresse électronique - Le nom d'utilisateur ou l'adresse électronique de l'utilisateur qui doit être associé à la transaction. Il doit s'agir d'un utilisateur existant dans la base de données. (Remarque : depuis la version MemberPress Importer 1.6.8, vous pouvez également utiliser user_email au lieu de email)
• product_id - L'identifiant de l'adhésion pour laquelle cette transaction est effectuée. Il doit s'agir de l'identifiant d'un membre existant dans la base de données. L'identifiant peut être trouvé dans l'URL lors de la modification de l'adhésion. Par exemple, l'identifiant de l'adhésion dans cette URL : http://awesomesite.com/wp-admin/post.php?post=10&action=edit est de 10.
• montant - Prix de l'adhésion. Il peut s'agir de n'importe quel nombre au format décimal sans symbole monétaire - par exemple 5,99.
• total - Prix incluant les taxes (le cas échéant). total = (montant + tax_amount). S'il n'y a pas de taxe, cette valeur doit être la même que celle du champ "montant".
• sub_num ou subscr_id - cette colonne n'est pas nécessaire mais il est nécessaire afin de référencer une transaction à l'abonnement importé dans la base de données Importation d'abonnements au format CSV. Voir ci-dessous.

Colonnes optionnelles :

• id - Met à jour les informations relatives à la transaction existante correspondant à l'id. Si ce champ est laissé vide, une nouvelle transaction sera créée. Veillez à utiliser l'identifiant figurant dans la colonne "Id" de la page MemberPress > Transactions, comme indiqué ci-dessous. ici. Ce champ nécessite la version MemberPress Importer 1.6.0 ou une version plus récente.
• sub_num ou subscr_id - Le numéro d'abonnement qui fait référence à l'abonnement. Ce numéro doit faire référence à un abonnement existant dans la base de données. La valeur par défaut est "blank".
• mode de paiement ou gateway_id - L'identifiant unique de la méthode de paiement. Il se trouve dans l'onglet "Paiements" de la page "Paramètres" de MemberPress. La valeur par défaut est "manual". Si vous importez des membres gratuits, vous pouvez également définir ce paramètre sur "free".
• code_coupon ou coupon - Le code du coupon appliqué à cette transaction. Doit faire référence à un coupon qui existe déjà dans la base de données. La valeur par défaut est "blank".
• send_welcome - Contrôle si l'utilisateur recevra un courriel de bienvenue avec la transaction nouvellement créée. Il peut prendre la valeur 1 pour "true" (vrai) ou 0 pour "false" (faux). La valeur par défaut est 0.
• send_receipt - Contrôle si l'utilisateur recevra un e-mail de reçu avec la transaction nouvellement créée. La valeur peut être 1 pour true (vrai) ou 0 pour false (faux). La valeur par défaut est 0.
• trans_num - Numéro de transaction de la passerelle. Il peut s'agir de n'importe quelle petite chaîne de texte. S'il est vide, un numéro aléatoire sera généré.
• tax_rate - Le taux d'imposition en %. Exemple 5% doit être saisi comme 5.000. La valeur par défaut est 0.
• tax_amount - Le montant de la taxe appliqué au total. tax_amount = (amount*(tax_rate/100)). La valeur par défaut est 0.
• tax_desc - Description de la taxe. La valeur par défaut est "pas de description".
• tax_class - Non utilisé dans MemberPress actuellement. La valeur par défaut est "standard".
• status - Le statut de la transaction. Il peut être "en attente", "complet" ou "remboursé". La valeur par défaut est "complet".
• created_at - Date de création de la transaction. Doit être au format "YYYY-MM-DD hh:mm:ss". La date par défaut est la date du jour.
• expires_at - Date d'expiration de la transaction. Lorsqu'une transaction expire, elle doit être renouvelée par l'utilisateur pour qu'il puisse continuer à y avoir accès. La date doit être au format "YYYY-MM-DD hh:mm:ss". Les règles d'expiration habituelles de l'adhésion s'appliquent par défaut si elles sont laissées en blanc. Pour un accès à vie, utilisez 0000-00-00 00:00:00 comme date d'expiration. NOTE IMPORTANTE : Si vous ne souhaitez pas que votre utilisateur ait un accès à vie sur la base de cette importation, vous devez doivent ajouter une date d'expiration dans cette colonne.

Messages de l'importateur

Après avoir importé votre fichier, l'importateur vous montrera quelques lignes et cases différentes pour vous indiquer comment s'est déroulée l'importation. Vous trouverez ci-dessous un aperçu de ces éléments.

X lignes importées avec succès - Ici, l'importateur vous indiquera combien de lignes (à la place de X) ont été importées avec succès.

X Les lignes n'ont pas été importées - Ici, l'importateur vous indiquera le nombre de lignes (à la place de X) qui n'ont pas été importées.

X Total des lignes traitées - Ici, l'importateur vous indiquera le nombre total de lignes (à la place de X) qui ont été traitées.

Messages de réussite de la rangée : - Dans cette boîte, vous verrez tous les messages de réussite liés à votre dernière importation. 

Erreurs de ligne : - Dans cette boîte, vous verrez toutes les erreurs liées aux lignes de votre dernière importation. Le message doit être suffisamment détaillé pour que vous sachiez ce que vous devez corriger afin que votre fichier fonctionne correctement lors de l'importation. 

CSV pour les lignes qui ont échoué ... copiez-les, corrigez-les et réimportez-les : - Vous y trouverez les lignes exactes qui doivent être corrigées. Notez-les afin de corriger les lignes contenant des erreurs. 

Retour en haut de la page