Chuyển đến nội dung chính

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.

​
Giới thiệu

Đồng bộ dữ liệu thanh toán của bạn trực tiếp đến HubSpot CRM. Tạo liên hệ từ các khoản thanh toán thành công, theo dõi vòng đời đăng ký và xây dựng hồ sơ khách hàng toàn diện—tất cả đều được kích hoạt tự động bởi các sự kiện Dodo Payments.
Tích hợp này yêu cầu quyền truy cập quản trị HubSpot để cấu hình phạm vi OAuth và quyền API.

​
Bắt đầu

1

Open the Webhook Section

Trong bảng điều khiển Dodo Payments của bạn, đi đến Webhooks → + Thêm Điểm cuối và mở rộng danh sách tích hợp.
Add Endpoint and integrations dropdown
2

Select HubSpot

Chọn thẻ tích hợp HubSpot.
3

Connect HubSpot

Nhấp vào Connect to HubSpot và ủy quyền các phạm vi OAuth cần thiết.
4

Configure Transformation

Chỉnh sửa mã chuyển đổi để ánh xạ dữ liệu thanh toán đến các đối tượng CRM của HubSpot.
5

Test & Create

Kiểm tra với các payload mẫu và nhấp vào Create để kích hoạt đồng bộ.
6

Done!

🎉 Các sự kiện thanh toán sẽ tự động tạo/cập nhật các bản ghi trong CRM HubSpot của bạn.

​
Ví dụ Mã Biến đổi

​
Tạo Liên hệ từ Thanh toán

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

​
Cập nhật Liên hệ với Đăng ký

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

​
Tạo Giao dịch từ Thanh toán

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

​
Mẹo

  • Sử dụng trình khám phá API của HubSpot để kiểm tra việc tạo đối tượng
  • Ánh xạ số tiền thanh toán đến các trường tiền tệ của HubSpot
  • Bao gồm ID khách hàng để đảm bảo liên kết chính xác
  • Đặt các giai đoạn giao dịch phù hợp dựa trên trạng thái thanh toán

​
Khắc phục sự cố

  • Xác minh rằng phạm vi OAuth bao gồm quyền ghi
  • Kiểm tra rằng các thuộc tính HubSpot bắt buộc tồn tại
  • Đảm bảo email khách hàng hợp lệ và duy nhất
  • Xem lại giới hạn tốc độ API của HubSpot
  • Xác minh cấu trúc JSON khớp định dạng API của HubSpot
  • Kiểm tra rằng tất cả các thuộc tính bắt buộc được bao gồm
  • Đảm bảo tên thuộc tính khớp chính xác với tên trường của HubSpot
Last modified on April 20, 2026