Vérifier les adresses e-mail de vos clients Paddle

1. 1
   Dans Paddle

   Exporter les adresses de vos clients depuis Paddle

   1. Ouvrez Paddle puis Reports.
   2. Dans l'onglet Build reports, repérez Subscriptions, puis cliquez sur Build report.
   3. Choisissez avec les filtres les abonnements à inclure, par exemple selon leur statut.
   4. Cliquez sur Generate report.
   5. Guettez l'e-mail de Paddle, puis cliquez sur Download report dans cet e-mail.

   Astuce

   Vous vendez aussi des produits à achat unique ? Générez de la même façon le rapport Transactions : il compte une ligne par transaction, avec la même colonne customer_email. PricklyMails n'a besoin que des adresses : gardez le rapport tel quel, puisque sa colonne customer_id sert à ramener le résultat, et copiez seulement la colonne customer_email dans un nouveau fichier pour le lot.

   À noter

   La documentation de Paddle n'existe qu'en anglais : les libellés cités sur cette page sont ceux qu'elle donne. Cette page couvre Paddle Billing. Les données des rapports peuvent avoir jusqu'à 24 heures de retard : un client créé la veille peut manquer au fichier. Un rapport reste téléchargeable pendant 14 jours.

   SourceAide officielle de Paddle

   • Generate reports (nouvel onglet)developer.paddle.com
   • Subscriptions reports (nouvel onglet)developer.paddle.com
   • Transaction reports (nouvel onglet)developer.paddle.com
2. 2
   Dans PricklyMails

   Vérifier le fichier dans PricklyMails

   1. Dans le tableau de bord, ouvrez Lots et cliquez sur Nouveau lot.
   2. Déposez le fichier exporté depuis Paddle : un .csv ou un .txt, avec une adresse par ligne, sans ligne d'en-tête ni guillemets. Une ligne d'en-tête compterait comme une adresse dans l'estimation, sans jamais être facturée, et une adresse entre guillemets ne serait pas vérifiée : le rapport les signale toutes deux comme mal formées. Vous pouvez aussi coller la liste.
   3. Le tableau de bord compte les adresses et affiche le coût estimé en jetons avant tout envoi, puis vous cliquez sur Envoyer le lot. Un lot compte au moins 20 adresses, et sa taille maximale dépend de votre abonnement.
   4. La liste est vérifiée en arrière-plan. Une fois le lot terminé, ouvrez-le et cliquez sur Télécharger le rapport : vous obtenez un CSV avec une ligne par adresse de votre fichier, qui donne son verdict, sa raison, son score et sa recommandation, avec les libellés du tableau de bord.

   À noter

   Téléchargez le rapport depuis le navigateur qui a envoyé la liste : c'est lui qui garde les adresses, pour les 16 derniers lots au plus. Nos serveurs, en Allemagne, n'en conservent qu'une empreinte à sens unique.

   Ce que dit le rapport

   Chaque adresse reçoit une recommandation : l'action à mener. Le rapport l'écrit avec le libellé du tableau de bord ; l'API en renvoie une forme courte.

   À envoyer

   L'adresse est valide, ou hébergée chez un grand fournisseur qui accepte toutes les adresses sans rien confirmer. Vous envoyez normalement.

   À revoir

   Domaine qui accepte tout (catch-all), adresse générique comme contact@, boîte pleine, ou serveur qui n'a pas répondu, ou a refusé de répondre. Un coup d'œil s'impose avant l'envoi.

   À retirer

   L'adresse n'existe pas, son domaine ne reçoit pas d'email, elle est jetable, contient une faute de frappe ou est mal formée. Vous la retirez.

   À noter

   Une adresse mal formée n'est jamais vérifiée : le lot la compte dans « Adresses mal formées », et le rapport la reprend quand même, avec le verdict « Invalide », la raison « Adresse mal formée » et la recommandation « À retirer » : vous la retirez de Paddle avec les autres. Une adresse en double, comptée dans « Doublons retirés », n'y figure qu'une fois.

   Derrière chaque recommandation, il y a un verdict (Valide, Risqué, Invalide ou Non vérifiable), une raison et un score de 0 à 100, chacun dans sa colonne du rapport. Quand un serveur ne répond pas, l'adresse revient « Non vérifiable » et les tests restés sans réponse vous sont rendus.

3. 3
   Dans Paddle

   Ramener le résultat dans Paddle

   Ouvrez le rapport dans un tableur et filtrez la colonne Recommandation.

   À retirer

   Paddle ne supprime pas de client : donnez une adresse qui fonctionne à ceux que vous facturez encore, et archivez ceux dont vous n'avez plus besoin.

   Paddle envoie à l'adresse du client ses reçus, ses rappels de facturation et ses avis d'échec de paiement. Sa documentation décrit le changement de cette adresse, ou l'archivage d'un client, par l'API, avec l'identifiant du client.

   1. Ouvrez Paddle puis My account puis Settings puis Authentication, puis cliquez sur l'onglet API keys.
   2. Cliquez sur New API key, saisissez un nom, puis donnez à la clé la permission customer.write, que demande Update a customer.
   3. Fixez une date d'expiration, cliquez sur Save, puis copiez la clé : Paddle ne l'affiche qu'une fois.
   4. Dans le rapport exporté, repérez le customer_id de chaque adresse à retirer.
   5. Pour un client que vous facturez encore, demandez-lui une adresse qui fonctionne.
   6. Envoyez la requête Update a customer, PATCH /customers/{customer_id}, avec la nouvelle adresse dans email.
   7. Pour un client dont vous n'avez plus besoin, envoyez plutôt la même requête avec status à archived.

   À revoir

   Elles méritent un coup d'œil avant leur prochain renouvellement. Pour en consulter une dans Paddle, ouvrez Paddle puis Customers, cliquez sur le bouton à trois points à côté du client, puis choisissez View customer. Si l'adresse semble mal saisie, demandez la bonne au client et mettez-la à jour comme une adresse à retirer.

   À envoyer

   Elles gardent leur adresse : rien à faire.

   À noter

   Une nouvelle adresse met à jour le client, pas ses transactions passées : les transactions facturées ou terminées sont des documents financiers, et gardent les informations avec lesquelles elles ont été facturées.

   Astuce

   Plus de colonne customer_id sous la main ? La requête List customers accepte jusqu'à 100 adresses à la fois, séparées par des virgules dans son paramètre email, et renvoie le client de chacune avec son id.

   SourceAide officielle de Paddle

   • Authentication (nouvel onglet)developer.paddle.com
   • Update a customer (nouvel onglet)developer.paddle.com
   • Create or update customers (nouvel onglet)developer.paddle.com
   • List customers (nouvel onglet)developer.paddle.com
   • Delete entities (nouvel onglet)developer.paddle.com

Vérifier chaque adresse avant qu'elle n'entre dans Paddle

Votre application ou votre backend crée des clients dans Paddle avec son API, par l'appel Create a customer (nouvel onglet), par exemple pour leur envoyer une facture ? Interrogez PricklyMails juste avant. Si la recommandation est remove, demandez une autre adresse avant de créer le client.

curl -s https://api.pricklymails.com/api/verify \
  -H "Authorization: Bearer pm_live_9f3a..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "ana.silva@gmail.con" }' \
  | jq '{job_uuid, suggestion}'

{
  "job_uuid": "8f1c2a9e-4b7d-4e2a-9c61-3d5f0b7a2e18",
  "suggestion": "ana.silva@gmail.com"
}

curl -s https://api.pricklymails.com/api/verify/$JOB_UUID \
  -H "Authorization: Bearer pm_live_9f3a..." \
  | jq '.verifications[0] | {status, reason, score, recommendation}'

{
  "status": "invalid",
  "reason": "no_mx_records",
  "score": 0,
  "recommendation": "remove"
}

Questions fréquentes