Couvert dans cet article :
Quand importer des abonnements récurrents
Présentation vidéo
Instructions générales
Vous devez UNIQUEMENT importer des abonnements récurrents pour les raisons suivantes :
- Vous migrez des profils récurrents automatisés (pour PayPal, Authorize.Net Square ou Stripe) à partir d'un autre système.
- 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 qui se trouvent actuellement dans le processeur de votre passerelle (PayPal, Authorize.net, Square 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 :
- Fichier CSV des abonnements
- Fichier CSV des transactions (if you don’t need to import a large batch of transactions, please note that it may be easier and faster for you to just create 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.
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
Colonnes obligatoires :
- username OR email — You can enter ‘username’ OR ’email’ for your column header (does NOT support both in one file). If you use ‘username’, use the username of the user that should be associated with the transaction. If you use ’email’, enter the user’s email. Your selection must belong to an already existing user in the database. (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 — Number of weeks, months or years. Can be any valid whole number if the period_type=’months’ or period_type=’weeks’ but anything else, this can only be 1.
- period_type — This is the period type. Can be ‘weeks’, ‘months’, ‘years’ or ‘lifetime’.
- mode de paiement ou gateway - L'identifiant unique de la méthode de paiement. Cet identifiant se trouve dans le champ onglet paiements of the MemberPress Settings page. This must reference the actual gateway where the customer’s recurring profile exists. So if you’re using PayPal Express Checkout, for example; be sure that the ID for that gateway is what gets set here.
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 — What to do after the subscription is cancelled. It can be set to ‘expire’ or ‘lifetime’. Defaults to ‘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 — The status of the subscription. Can either be ‘pending’, ‘active’ or ‘cancelled’. Defaults to ‘active’.
- 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: For monthly subscriptions, it’s important that this gets set to the same day of the month as the billing is currently happening. So if the subscription is billed on the 12th of each month, make sure this is the 12th of a month also. Otherwise, your transaction’s expiration dates will be incorrect on renewals after importing.
- 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 — Not used in MemberPress currently. Defaults to ‘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.
Format CSV des transactions
Instructions vidéo
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 courriel - Le nom d'utilisateur ou l'adresse électronique de l'utilisateur qui doit être associé à la transaction. Doit appartenir à un utilisateur déjà 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)
- produit_id - L'identifiant de l'adhérent pour lequel 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 l'édition de l'adhésion. Par exemple, l'identifiant de l'adhérent 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 TTC (le cas échéant). total = (montant + montant_de_la_taxe). 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'identifiant. 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 ID de la passerelle — The unique id of the payment method. This can be found in the payments tab of the MemberPress Settings page. Defaults to ‘manual’. If you’re importing Free members, you can also set this to ‘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.
- envoyer_recevoir - Contrôle si l'utilisateur recevra un courriel de réception avec cette 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 — The gateway’s transaction number. It can be any small string of text. If blank, a random id will be generated.
- taux d'imposition - Le taux d'imposition dans %. Exemple 5% doit être saisi comme 5.000. La valeur par défaut est 0.
- montant de la taxe - 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. Par défaut, il n'y a pas de description.
- classe_d'impôt — Not used in MemberPress currently. Defaults to ‘standard’.
- statut — The status of the transaction. Can either be ‘pending’, ‘complete’ or ‘refunded’. Defaults to ‘complete’.
- date_de_création - La date de création de cette transaction. Doit être au format "YYYY-MM-DD hh:mm:ss". La date par défaut est la date du jour.
- expires_at — The expiration date of the transaction. When a transaction expires, it must be renewed by the user for them to continue to have access. Must be in the format “YYYY-MM-DD hh:mm:ss”. Defaults to the Membership’s regular expiration rules if left blank. For lifetime access, use 0000-00-00 00:00:00 as the expires_at date.
Téléchargement des fichiers
Pour télécharger les fichiers que vous avez créés, il suffit de suivre les étapes suivantes :
- Allez dans MemberPress Plugin > Import. Une fois sur place, sélectionnez Abonnements ou Transactions dans le menu déroulant du type de fichier à importer.
- Ensuite, utilisez le bouton "Choisir un fichier" pour télécharger votre fichier (vous ne pouvez importer qu'un seul fichier à la fois).
- Enfin, cliquez sur le bouton de téléchargement.
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.