Passer au contenu principal

​
Introduction

Synchronisez vos données de paiement directement dans HubSpot CRM. Créez des contacts à partir de paiements réussis, suivez le cycle de vie des abonnements et construisez des profils clients complets—le tout déclenché automatiquement par les événements de Dodo Payments.
Cette intégration nécessite un accès administrateur HubSpot pour configurer les portées OAuth et les autorisations API.

​
Commencer

1

Open the Webhook Section

Dans le tableau de bord Dodo Payments, allez à Webhooks → + Ajouter un point de terminaison et développez le menu déroulant des intégrations.
Ajouter un point de terminaison et le menu déroulant des intégrations
2

Select HubSpot

Choisissez la carte d’intégration HubSpot.
3

Connect HubSpot

Cliquez sur Se connecter à HubSpot et autorisez les portées OAuth requises.
4

Configure Transformation

Modifiez le code de transformation pour mapper les données de paiement aux objets CRM HubSpot.
5

Test & Create

Testez avec des charges utiles d’exemple et cliquez sur Créer pour activer la synchronisation.
6

Done!

🎉 Les événements de paiement créeront/ mettront à jour automatiquement des enregistrements dans votre CRM HubSpot.

​
Exemples de code de transformation

​
Créer un contact à partir d’un paiement

create_contact.js
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.hubapi.com/crm/v3/objects/contacts";
    webhook.payload = {
      properties: {
        email: p.customer.email,
        firstname: p.customer.name.split(' ')[0] || '',
        lastname: p.customer.name.split(' ').slice(1).join(' ') || '',
        phone: p.customer.phone || '',
        company: p.customer.company || '',
        amount: (p.total_amount / 100).toString(),
        payment_method: p.payment_method || '',
        currency: p.currency || 'USD'
      }
    };
  }
  return webhook;
}

​
Mettre à jour un contact avec un abonnement

update_contact.js
function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = `https://api.hubapi.com/crm/v3/objects/contacts/${s.customer.customer_id}`;
    webhook.method = "PATCH";
    webhook.payload = {
      properties: {
        subscription_status: "active",
        subscription_amount: (s.recurring_pre_tax_amount / 100).toString(),
        subscription_frequency: s.payment_frequency_interval,
        next_billing_date: s.next_billing_date,
        product_id: s.product_id
      }
    };
  }
  return webhook;
}

​
Créer une affaire à partir d’un paiement

create_deal.js
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.hubapi.com/crm/v3/objects/deals";
    webhook.payload = {
      properties: {
        dealname: `Payment - ${p.customer.email}`,
        amount: (p.total_amount / 100).toString(),
        dealstage: "closedwon",
        closedate: new Date().toISOString(),
        hs_currency: p.currency || "USD"
      },
      associations: [
        {
          to: {
            id: p.customer.customer_id
          },
          types: [
            {
              associationCategory: "HUBSPOT_DEFINED",
              associationTypeId: 3
            }
          ]
        }
      ]
    };
  }
  return webhook;
}

​
Conseils

  • Utilisez l’explorateur API de HubSpot pour tester la création d’objets
  • Mapper les montants de paiement aux champs de devise HubSpot
  • Inclure les identifiants clients pour des associations appropriées
  • Définir les étapes d’affaires appropriées en fonction du statut de paiement

​
Dépannage

  • Vérifiez que les portées OAuth incluent les autorisations d’écriture
  • Assurez-vous que les propriétés HubSpot requises existent
  • Vérifiez que l’e-mail du client est valide et unique
  • Passez en revue les limites de taux de l’API HubSpot
  • Validez que la structure JSON correspond au format de l’API HubSpot
  • Vérifiez que toutes les propriétés requises sont incluses
  • Assurez-vous que les noms de propriétés correspondent exactement aux noms de champs HubSpot