Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

Einführung

Synchronisieren Sie Ihre Zahlungsdaten direkt mit HubSpot CRM. Erstellen Sie Kontakte aus erfolgreichen Zahlungen, verfolgen Sie den Lebenszyklus von Abonnements und erstellen Sie umfassende Kundenprofile – alles automatisch ausgelöst durch Dodo Payments-Ereignisse.
Für diese Integration ist HubSpot-Administratorzugriff erforderlich, um OAuth-Bereiche und API-Berechtigungen zu konfigurieren.

Erste Schritte

1

Open the Webhook Section

In Ihrem Dodo Payments-Dashboard, gehen Sie zu Webhooks → + Endpunkt hinzufügen und erweitern Sie das Integrations-Dropdown.
Endpunkt hinzufügen und Integrations-Dropdown
2

Select HubSpot

Wählen Sie die HubSpot-Integrationskarte aus.
3

Connect HubSpot

Klicken Sie auf Mit HubSpot verbinden und autorisieren Sie die erforderlichen OAuth-Bereiche.
4

Configure Transformation

Bearbeiten Sie den Transformationscode, um Zahlungsdaten auf HubSpot-CRM-Objekte abzubilden.
5

Test & Create

Testen Sie mit Beispiel-Payloads und klicken Sie auf Erstellen, um die Synchronisierung zu aktivieren.
6

Done!

🎉 Zahlungsereignisse erstellen/aktualisieren nun automatisch Datensätze in Ihrem HubSpot-CRM.

Transformationscode-Beispiele

Kontakt aus Zahlung erstellen

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;
}

Kontakt mit Abonnement aktualisieren

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;
}

Deal aus Zahlung erstellen

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;
}

Tipps

  • Verwenden Sie den API-Explorer von HubSpot, um die Objekterstellung zu testen
  • Ordnen Sie Zahlungsbeträge den Währungsfeldern von HubSpot zu
  • Fügen Sie Kunden-IDs für die richtige Zuordnung hinzu
  • Setzen Sie geeignete Deal-Stufen basierend auf dem Zahlungsstatus

Fehlersuche

  • Stellen Sie sicher, dass die OAuth-Bereiche Schreibberechtigungen enthalten
  • Überprüfen Sie, dass die erforderlichen HubSpot-Eigenschaften vorhanden sind
  • Stellen Sie sicher, dass die Kunden-E-Mail gültig und eindeutig ist
  • Überprüfen Sie die HubSpot-API-Rate-Limits
  • Validieren Sie, dass die JSON-Struktur dem HubSpot-API-Format entspricht
  • Überprüfen Sie, dass alle erforderlichen Eigenschaften enthalten sind
  • Stellen Sie sicher, dass Eigenschaftsnamen exakt mit den HubSpot-Feldnamen übereinstimmen
Last modified on April 20, 2026