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

​
Giới thiệu

Hướng dẫn này sẽ hướng dẫn bạn cách theo dõi các giới thiệu từ đối tác, xử lý các sự kiện hoa hồng và tăng doanh thu của bạn với các mối quan hệ đối tác liên kết đáng tin cậy thông qua Dodo Payments.

​
Tính năng chính

Phân bổ hoa hồng tự động

Không cần bảng tính hay theo dõi thủ công. Các giới thiệu sẽ được tự động phân bổ và ghi lại khi có giao dịch mua hàng.

Báo cáo theo thời gian thực

Cả bạn và các đối tác của bạn đều có thể theo dõi hiệu suất và khách hàng tiềm năng từ các bảng điều khiển riêng biệt.

Tùy chọn theo dõi linh hoạt

Sử dụng các script theo dõi, trường metadata và sự kiện webhook để thu thập dữ liệu giới thiệu qua các lần đăng ký và giao dịch.

Hoàn toàn mã hóa & An toàn

Tất cả thông tin nhạy cảm và dữ liệu webhook đều được trao đổi và lưu trữ một cách an toàn bằng cách sử dụng mã hóa hàng đầu.

Cài đặt nhanh chóng

Khởi chạy chương trình liên kết của bạn chỉ trong vài phút—không cần thay đổi mã ngoài việc sao chép và dán các đoạn script và token API.

Tích hợp liền mạch

Kết nối theo dõi đối tác trực tiếp vào quy trình thanh toán của bạn bằng cách sử dụng tích hợp của chúng tôi với Affonso, một nền tảng tiếp thị liên kết hàng đầu.

​
Các bước tích hợp

Chúng tôi đã hợp tác với Affonso, một nền tảng quản lý đối tác hàng đầu để thúc đẩy doanh số của bạn. Hãy làm theo các bước dưới đây để kết nối tài khoản Dodo Payments của bạn với Affonso và bắt đầu theo dõi doanh số từ đối tác.
1

Kết nối với Dodo Payments

Để bắt đầu, hãy kết nối tài khoản Dodo Payments của bạn bằng cách thêm khóa API của bạn.

​
Cách lấy khóa API Dodo Payments của bạn

  • Đăng nhập vào Bảng điều khiển Dodo Payments của bạn
  • Đi đến phần Nhà phát triển trong menu bên trái
  • Nhấp vào Khóa API
  • Chọn Thêm Khóa API
  • Đặt tên cho nó (ví dụ: “Tích hợp Affonso”)
  • Nhấp Tạo và sao chép khóa API của bạn

​
Thêm khóa API của bạn vào Affonso

  • Mở Bảng điều khiển Affonso qua affonso.io
  • Đi đến Chi tiết chương trình > Kết nối
  • Nhấp vào thẻ tích hợp Dodo Payments
  • Dán khóa API Dodo Payments của bạn
  • Nhấp Kết nối
Khóa API của bạn sẽ được mã hóa an toàn bởi Affonso.
2

Thêm Webhook vào Dodo Payments

Khi đã kết nối, bạn sẽ nhận được một URL webhook duy nhất từ Affonso. Điều này cho phép theo dõi thanh toán và kích hoạt hoa hồng đối tác.

​
Thêm URL Webhook trong Dodo Payments

  • Trong Bảng điều khiển Dodo Payments của bạn, đi đến Nhà phát triển → Webhooks
  • Nhấp Thêm Webhook
  • Dán URL webhook Affonso của bạn (từ cài đặt chương trình của bạn)
  • Lưu webhook

​
Thêm bí mật Webhook vào Affonso

  • Sau khi lưu webhook trong Dodo Payments, sao chép khóa ký được cung cấp
  • Dán lại vào Affonso dưới cài đặt webhook Dodo Payments
Điều này cho phép Affonso xác minh an toàn các sự kiện đến từ Dodo Payments.
3

Thêm script theo dõi

Đặt pixel Affonso trên trang web của bạn để bắt đầu theo dõi lượt truy cập và chuyển đổi từ đối tác.
<!-- Place in <head> tag -->
<script async defer
src="https://affonso.io/js/pixel.min.js"
data-affonso="YOUR_PUBLIC_PROGRAM_ID"
data-cookie_duration="YOUR_COOKIE_DURATION">
</script>
Script này:
  • Theo dõi lượt truy cập từ đối tác
  • Thiết lập cookie với ID giới thiệu (affonso_referral)
  • Kích hoạt theo dõi đăng ký và thanh toán
Đặt điều này trên tất cả các miền mà người dùng truy cập hoặc chuyển đổi (ví dụ: trang marketing, ứng dụng).
4

Theo dõi đăng ký người dùng

Để có cái nhìn rõ hơn về quy trình và tối ưu hóa hiệu suất của đối tác, hãy theo dõi đăng ký người dùng như là khách hàng tiềm năng.
// After successful registration
window.Affonso.signup(userEmail);
Điều này sẽ:
  • Ghi lại một giới thiệu mới là KHÁCH HÀNG TIỀM NĂNG nếu người dùng đến qua liên kết đối tác
  • Hiển thị nó trong bảng điều khiển của bạn và thống kê của đối tác
Thực hành tốt nhất: Kích hoạt điều này sau khi đăng ký thành công hoặc xác nhận kép (DOI).
5

Chuyển dữ liệu giới thiệu đến Dodo Payments

Để phân bổ hoa hồng một cách chính xác, hãy chuyển ID giới thiệu từ Affonso đến Dodo Payments trong quá trình thanh toán.

​
Tích hợp thanh toán

import DodoPayments from 'dodopayments';

const referralId = window.affonso_referral;

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

async function main() {
  const payment = await client.payments.create({
    payment_link: true,
    billing: { city: 'city', country: 'AF', state: 'state', street: 'street', zipcode: 0 },
    customer: { email: '[email protected]', name: 'name' },
    product_cart: [{ product_id: 'product_id', quantity: 0 }],
    metadata: {
      affonso_referral: referralId,
    },
  });

  console.log(payment.payment_id);
}

main();

​
Tích hợp đăng ký

import DodoPayments from 'dodopayments';

const referralId = window.affonso_referral;

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

async function main() {
  const subscription = await client.subscriptions.create({
    billing: { city: 'city', country: 'IN', state: 'state', street: 'street', zipcode: 89789 },
    customer: { customer_id: 'customer_id' },
    product_id: 'product_id',
    payment_link: true,
    return_url: 'https://example.com/success',
    quantity: 1,
    metadata: {
      affonso_referral: referralId,
    },
  });

  console.log(subscription.subscription_id);
}

main();

​
Liên kết thanh toán

// Original Dodo Payments Link
const originalLink = 'https://checkout.dodopayments.com/buy/<YOUR_PRODUCT_ID>';

// Append referral ID as reference_id
const linkWithReferral = `${originalLink}?metadata_affonso_referral=${window.affonso_referral}`;
Để biết thêm chi tiết, xem tài liệu API Dodo Payments
6

Kiểm tra tích hợp của bạn

Trước khi công khai, hãy kiểm tra thiết lập của bạn với các liên kết đối tác trực tiếp và các giao dịch thử nghiệm.Danh sách kiểm tra thử nghiệm:
  • ✅ Tạo một đối tác và tạo một liên kết theo dõi
  • ✅ Truy cập trang web của bạn qua liên kết đối tác
  • ✅ Đảm bảo script Affonso được tải và cookie affonso_referral được thiết lập
  • ✅ Hoàn thành một đăng ký (tùy chọn)
  • ✅ Hoàn thành một thanh toán qua Dodo Payments
  • ✅ Xác nhận theo dõi và phân bổ trong bảng điều khiển Affonso của bạn

​
Cần giúp đỡ?

Nếu bạn gặp bất kỳ vấn đề nào hoặc cần hỗ trợ trong quá trình tích hợp:

Hỗ trợ Affonso

Hỗ trợ Dodo Payments

Đối với các câu hỏi API cụ thể về Dodo Payments, hãy tham khảo docs.dodopayments.com hoặc liên hệ với đội ngũ hỗ trợ của chúng tôi.