Rekomi

​

Giới thiệu

​

Cách hoạt động

1. Khách truy cập nhấp vào liên kết affiliate và đến website của bạn, nơi script của Rekomi lưu thông tin giới thiệu trong trình duyệt của họ.
2. Họ đi đến checkout, và bạn đính kèm thông tin giới thiệu đó vào khoản thanh toán dưới dạng rekomi_ref metadata.
3. Dodo Payments xử lý khoản thanh toán và gửi một payment.succeeded webhook đã ký đến endpoint do Rekomi tạo.
4. Rekomi đối chiếu thông tin giới thiệu với affiliate, tính hoa hồng trên số tiền bán hàng trước thuế và ghi nhận khoản đó.

​

Điều kiện tiên quyết

1. Một tài khoản Dodo Payments ở live mode
2. Một tài khoản Rekomi
3. Một Dodo Payments API key đã bật write access (key chỉ có quyền đọc không thể tạo webhook)

​

Bắt đầu

1

Create an API Key with Write Access

Trong dashboard Dodo Payments, đi đến Developer → API Keys và tạo một key (đặt tên là “Rekomi”) với tùy chọn Enable write access được bật. Xem hướng dẫn API key để biết hướng dẫn chi tiết.

Bật write access cho key: key chỉ có quyền đọc sẽ vượt qua bước xác thực nhưng không thể tạo webhook endpoint, vì vậy kết nối sẽ bị lỗi giữa chừng.

2

Paste the Key into Rekomi

Trong Rekomi, mở Setup → Connect payment processor, chọn Dodo Payments và dán key. Rekomi xác thực key theo thời gian thực, tạo webhook endpoint trong tài khoản của bạn và tự lấy signing secret.

Sau khi kết nối, key chỉ được dùng để quản lý webhook endpoint và thực hiện các lần kiểm tra tình trạng định kỳ. Doanh số của bạn được gửi qua signed webhook, không bao giờ thông qua API.

3

Install the Rekomi Script

Thêm Rekomi tracking script vào website marketing của bạn để ghi nhận các lượt nhấp vào liên kết affiliate. Đoạn snippet đã điền sẵn program ID nằm trong Setup → Install trên Rekomi.

<script
  async
  src="https://api.rekomi.com/api/v1/r/loader.js"
  data-program-id="YOUR_PROGRAM_ID"
></script>

4

Pass the Referral into Checkout

Đính kèm thông tin giới thiệu đã ghi nhận vào mỗi khoản thanh toán dưới dạng rekomi_ref metadata. Xem các ví dụ triển khai bên dưới.

5

Done!

Doanh số, gia hạn, hoàn tiền và tranh chấp giờ đây sẽ tự động ghi nhận và thu hồi hoa hồng affiliate, còn Rekomi sẽ xử lý việc thanh toán cho các affiliate của bạn.

​

Hướng dẫn triển khai

​

Checkout Sessions qua API

import DodoPayments from 'dodopayments';

const client = new DodoPayments();

export async function createCheckout(productId: string, rekomiRef?: string) {
  const session = await client.checkoutSessions.create({
    product_cart: [{ product_id: productId, quantity: 1 }],
    customer: {
      email: 'customer@example.com',
      name: 'John Doe',
    },
    return_url: 'https://yoursite.com/success',
    metadata: {
      ...(rekomiRef ? { rekomi_ref: rekomiRef } : {}),
    },
  });

  return session.checkout_url;
}

​

Payments API

import DodoPayments from 'dodopayments';

const client = new DodoPayments();

export async function createPayment(productId: string, rekomiRef?: string) {
  const payment = await client.payments.create({
    billing: {
      city: 'New York',
      country: 'US',
      state: 'NY',
      street: '123 Main St',
      zipcode: '10001',
    },
    customer: {
      email: 'customer@example.com',
      name: 'John Doe',
    },
    product_cart: [{ product_id: productId, quantity: 1 }],
    payment_link: true,
    metadata: {
      ...(rekomiRef ? { rekomi_ref: rekomiRef } : {}),
    },
  });

  return payment;
}

​

Static Payment Links

const ref = window.Rekomi?.getReferral?.();
let url = 'https://checkout.dodopayments.com/buy/YOUR_PRODUCT_ID';
if (ref) url += `?metadata_rekomi_ref=${encodeURIComponent(ref)}`;
// use url as the href on your Buy button

​

Những gì được theo dõi

​

Lưu ý quan trọng

• Rekomi đăng ký webhook endpoint với chính xác các event cần thiết. Tránh chỉnh sửa danh sách event của endpoint đó trong dashboard Dodo Payments; các lần kiểm tra tình trạng của Rekomi sẽ đánh dấu kết nối nếu có event bị xóa.
• Trial không phát sinh thanh toán cho đến khi kết thúc, vì vậy không có hoa hồng cho đến khoản phí thực tế đầu tiên.
• Ngắt kết nối trong Rekomi sẽ xóa webhook endpoint khỏi tài khoản Dodo Payments của bạn.

​

Tài nguyên bổ sung