Rekomi

Pendahuluan

Rekomi adalah platform pelacakan dan manajemen afiliasi dengan integrasi native Dodo Payments. Seorang afiliasi membagikan tautan, dan Rekomi mencatat klik tersebut. Saat pengunjung itu membeli, Dodo Payments mengirimkan penjualan tersebut ke Rekomi, yang memberikan kredit kepada afiliasi yang tepat. Rekomi menghitung komisi dan membayar afiliasi Anda untuk Anda, di lebih dari 150 negara, termasuk formulir pajak. Untuk menghubungkan, Anda menempelkan satu Dodo Payments API key dengan akses write ke Rekomi. Rekomi memvalidasi key tersebut, membuat endpoint webhook di akun Dodo Payments Anda, dan mengambil signing secret endpoint tersebut. Anda tidak perlu mengisi formulir webhook atau menempelkan apa pun kembali ke Dodo Payments.

Rekomi memberikan kredit penjualan kepada afiliasi saat pelanggan yang dirujuk menyelesaikan pembayaran satu kali, memulai langganan berbayar, atau membayar perpanjangan. Refund dan sengketa secara otomatis menarik kembali komisi tersebut.

Cara Kerjanya

Dodo Payments meng-host checkout di domainnya sendiri, sehingga rujukan afiliasi masuk ke penjualan sebagai metadata checkout:

Pengunjung mengeklik tautan afiliasi dan membuka situs Anda, tempat skrip Rekomi menyimpan referral di browser mereka.
Saat checkout, Anda melampirkan referral tersebut ke pembayaran sebagai metadata rekomi_ref.
Dodo Payments memproses pembayaran dan mengirimkan webhook bertanda tangan payment.succeeded ke endpoint yang dibuat Rekomi.
Rekomi mencocokkan referral dengan afiliasi, menghitung komisi berdasarkan jumlah penjualan sebelum pajak, dan mencatatnya.

Perpanjangan langganan tiba dengan cara yang sama, sehingga komisi berulang tidak memerlukan pekerjaan tambahan. Refund dan sengketa juga tiba melalui endpoint yang sama.

Prasyarat

Sebelum menyiapkan integrasi ini, Anda memerlukan:

Akun Dodo Payments dalam mode live
Akun Rekomi
Dodo Payments API key dengan akses write yang diaktifkan, karena key read-only tidak dapat membuat webhook

Memulai

Create an API Key with Write Access

Aktifkan akses write pada key. Key read-only berhasil melewati validasi, tetapi tidak dapat membuat endpoint webhook, sehingga koneksi gagal di tengah proses.

Di dashboard Dodo Payments, buka Developer → API Keys dan klik Add API Key. Beri nama key tersebut Rekomi dan pastikan Enable write access tetap dicentang. Untuk detailnya, lihat Authentication.

Paste the Key into Rekomi

Di Rekomi, buka Setup → Connect payment processor, pilih Dodo Payments, lalu tempelkan key tersebut. Rekomi memvalidasinya, membuat endpoint webhook di akun Anda, dan mengambil signing secret endpoint tersebut.

Halaman penyiapan Dodo Payments Rekomi dengan satu kolom API key dan tombol koneksi

Setelah terhubung, Rekomi menggunakan key tersebut hanya untuk mengelola endpoint webhook dan menjalankan pemeriksaan kesehatan berkala. Penjualan Anda tiba melalui webhook bertanda tangan, bukan melalui API.

Install the Rekomi Script

Tambahkan skrip pelacakan Rekomi ke situs marketing Anda untuk menangkap klik afiliasi. Rekomi menampilkan snippet Anda, dengan ID program yang sudah diisi, di Setup → Install.

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

Pass the Referral into Checkout

Lampirkan referral yang ditangkap ke setiap pembayaran sebagai metadata rekomi_ref. Implementation Guide menunjukkan caranya untuk setiap jenis checkout.

Done

Penjualan, perpanjangan, refund, dan sengketa kini secara otomatis memberikan dan menarik kembali kredit komisi afiliasi, dan Rekomi membayar afiliasi Anda.

Panduan Implementasi

Checkout Sessions melalui API

Di frontend, baca referral menggunakan window.Rekomi.getReferral() dan kirimkan ke backend bersama permintaan checkout. Di backend, tetapkan referral tersebut di metadata:

Node.js

import DodoPayments from 'dodopayments';

// Reads DODO_PAYMENTS_API_KEY from the environment and defaults to live mode.
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;
}

Field metadata.rekomi_ref yang sama juga berfungsi pada produk langganan, sehingga tagihan pertama dan setiap perpanjangan memberikan kredit kepada afiliasi yang sama.

Payments API

Contoh di bawah menggunakan POST /payments, yang deprecated. Contoh tersebut masih berfungsi untuk integrasi yang sudah ada. Integrasi baru sebaiknya menggunakan Checkout Sessions (POST /checkouts), yang menerima metadata dengan cara yang sama.

Node.js

import DodoPayments from 'dodopayments';

// Reads DODO_PAYMENTS_API_KEY from the environment and defaults to live mode.
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;
}

Tautan Pembayaran Statis

Tambahkan referral ke tautan sebagai parameter query metadata_rekomi_ref datar, bukan dalam bentuk tanda kurung siku:

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

Dodo Payments menambahkan parameter query metadata_* ke metadata pembayaran, tempat Rekomi membacanya.

Yang Dilacak

Rekomi menangani setiap jenis event penjualan sebagai berikut:

Event	Yang terjadi
Pembayaran satu kali	Komisi diberikan berdasarkan jumlah penjualan sebelum pajak
Perpanjangan langganan	Komisi berulang, setiap tagihan tiba sebagai event pembayaran tersendiri
Refund	Komisi secara otomatis ditarik kembali, hingga sejumlah kredit yang diberikan
Sengketa	Komisi ditarik kembali segera setelah sengketa dibuka

Rekomi menghitung komisi berdasarkan jumlah penjualan sebelum pajak. Dodo Payments adalah Merchant of Record dan memungut pajak, sehingga afiliasi Anda mendapatkan penghasilan dari penjualan itu sendiri, bukan dari pajak yang ditambahkan oleh negara pembeli.

Catatan Penting

Rekomi mendaftarkan endpoint webhook hanya dengan event yang diperlukan. Jangan mengedit daftar event endpoint tersebut di dashboard Dodo Payments: pemeriksaan kesehatan Rekomi akan menandai koneksi jika ada event yang dihapus.
Uji coba gratis tidak membuat pembayaran hingga masa uji coba berakhir, sehingga tidak ada komisi sampai tagihan pertama. Uji coba berbayar menagihkan jumlah uji coba di muka.
Memutuskan koneksi di Rekomi akan menghapus endpoint webhook dari akun Dodo Payments Anda.

Sumber Daya Tambahan

Rekomi's Dodo Payments Guide

Panduan penyiapan lengkap, pemecahan masalah, dan detail keamanan dalam dokumentasi Rekomi.

Affiliates Feature Guide

Semua opsi integrasi afiliasi untuk Dodo Payments.

Untuk bantuan terkait integrasi, hubungi dukungan Rekomi di support@rekomi.com atau dukungan Dodo Payments di support@dodopayments.com.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Pendahuluan

Cara Kerjanya

Prasyarat

Memulai

Panduan Implementasi

Checkout Sessions melalui API

Payments API

Tautan Pembayaran Statis

Yang Dilacak

Catatan Penting

Sumber Daya Tambahan

Rekomi's Dodo Payments Guide

Affiliates Feature Guide

​Pendahuluan

​Cara Kerjanya

​Prasyarat

​Memulai

​Panduan Implementasi

​Checkout Sessions melalui API

​Payments API

​Tautan Pembayaran Statis

​Yang Dilacak

​Catatan Penting

​Sumber Daya Tambahan

Rekomi's Dodo Payments Guide

Affiliates Feature Guide

Pendahuluan

Cara Kerjanya

Prasyarat

Memulai

Panduan Implementasi

Checkout Sessions melalui API

Payments API

Tautan Pembayaran Statis

Yang Dilacak

Catatan Penting

Sumber Daya Tambahan