> For the complete documentation index, see [llms.txt](https://guide.ston.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.ston.fi/guides/id/menukar-di-ston.fi/cara-mendapatkan-biaya-referral-dari-swap.md).

# Cara mendapatkan biaya referral dari swap?

[STON.fi](https://ston.fi/) menawarkan program referral yang mendorong pengguna untuk membagikan tautan referral dan mendapatkan komisi. Struktur komisi referral berbeda antara pool V1 dan V2.

#### Perbedaan Utama Komisi Referral antara Pool V1 dan V2

| **Parameter**                           | **V1**                                                               | **V2**                                                                            |
| --------------------------------------- | -------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| Persentase referral default             | 0.1%                                                                 | Dapat disesuaikan (0,0% – 1,0%)                                                   |
| Distribusi komisi                       | Otomatis ke dompet                                                   | Terakumulasi di vault                                                             |
| Memerlukan penarikan manual             | Tidak                                                                | Ya                                                                                |
| Fleksibilitas dalam persentase referral | Tidak                                                                | Ya                                                                                |
| Biaya transaksi                         | Lebih tinggi (biaya referral dikirim segera ke referrer selama swap) | Lebih rendah (biaya referral terakumulasi di vault; tidak ditransfer selama swap) |

### Komisi referral V1

**Komisi referral default**\
Di V1, pengguna dapat membagikan tautan referral untuk menerima komisi default 0,1% dari setiap swap yang dilakukan melalui tautan mereka.\
\
**Contoh tautan referral:** <https://app.ston.fi/swap?chartVisible=false\\&ft=GRAM\\&tt=STON\\&referral\\_address=\\>\<referral\_address>

1. Distribusi otomatis\
   Komisi secara otomatis dikreditkan ke dompet yang memiliki referral\_address. Tidak diperlukan tindakan tambahan.<br>
2. Alur kerja sederhana\
   Komisi ditransfer segera, yang memberikan hadiah instan bagi referrer. Namun, pengguna yang melakukan swap membayar biaya gas/pemrosesan sedikit lebih tinggi karena transfer token referral terjadi di dalam transaksi swap.

### Komisi referral V2

**Persentase referral yang dapat disesuaikan**\
Di V2, komisi referral dapat diatur dengan menambahkan parameter referral\_percent ke tautan. Nilainya dapat berkisar dari 0% (0 bps) hingga 1% (100 bps).\
Catatan: referral\_percent adalah desimal (misalnya, 0.1 = 0,1%).\
\
**Contoh tautan referral (komisi kustom):** <https://app.ston.fi/swap?chartVisible=false\\&ft=TON\\&tt=STON\\&referral\\_address=\\>\<referral\_address>\&referral\_percent=0.1

1. Komisi yang terakumulasi di vault\
   Komisi tidak didistribusikan secara otomatis. Sebaliknya, komisi menumpuk di kontrak vault yang terkait dengan pool. Akibatnya, pengguna yang melakukan swap membayar lebih sedikit karena tidak ada transfer referral langsung.
2. Penarikan manual, cara klaim:

Buka:[ https://sdk-demo-app.ston.fi/vault](https://sdk-demo-app.ston.fi/vault)

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfzA9rxKUvaUFgZ0JbjpBT2S75oxvIOwQ5pOPOqYUfhwDEhgs7YLbtPhFgcWTEEyY9uPdv_qGi-0QfLH8a3XaYebGvBvKr_L38QdwM3E2eX0erKRMKfuERWNcm_aqNH0QxgshnqJQ?key=STuDSp5_1IJXT_GYc1PK7g" alt=""><figcaption></figcaption></figure>

Hubungkan dompet Anda dan tinjau biaya referral yang tersedia untuk alamat Anda lalu klik Claim pada yang ingin Anda klaim.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeP-jZv008oQAk6W_ywvvAW4z3Iz1Ape5qklznsyzE8Ha65fUsnFxsNH7I0Ug2VgcLq-iIW-HmNoq4QZjQjRwV_pAJpx1dr8YyOJyJNCVQMHY9KNAc_d74wFCtUc0Yhhu3gW2Bu?key=STuDSp5_1IJXT_GYc1PK7g" alt=""><figcaption></figcaption></figure>

Setujui transaksi di dompet Anda.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc6nqjC9vsfUcCjE1bSsf4NyhbjxzcT1bH1Vx8JqUHUnBm4mCqJzzJ4grqG6wlY7D6-5wxSVauo3LBykXOlXfOMBOctD8qwvdx0lLruqQszGMqPQHfq8y-xDhVvMNRCGbbvRoJn?key=STuDSp5_1IJXT_GYc1PK7g" alt=""><figcaption></figcaption></figure>

Setelah konfirmasi, biaya yang diklaim akan muncul di dompet Anda.

3. Penarikan

Para referrer harus secara manual meminta komisi yang terakumulasi dari vault.

Ini dilakukan dengan mengirim permintaan penarikan ke kontrak vault.

*Dokumen:* [*https://docs.ston.fi/developer-section/omniston/omniston-referral-fees#id-2-withdrawing-your-fees*](https://docs.ston.fi/developer-section/omniston/omniston-referral-fees#id-2-withdrawing-your-fees)

4. Fleksibilitas yang meningkat\
   Referrer dapat menetapkan komisi agar sesuai dengan strategi mereka (misalnya, 0% untuk pertumbuhan, 0,05%–0,2% untuk insentif ringan, hingga 1% untuk kampanye yang lebih intensif).

### Penerapan program referral

* Program referral berlaku untuk semua swap yang dilakukan setelah membuka DEX melalui tautan referral.
* Konteks referral direset jika halaman dimuat ulang, aplikasi ditutup, atau pengguna beroperasi di tab/sesi lain.

### FAQ

* **Apakah komisi referral 0,1% menambah biaya ekstra atau dibayarkan dari biaya protokol?**\
  Komisi referral selalu ditambahkan di atasnya, sehingga pertukaran menjadi lebih mahal bagi pengguna sebesar jumlah komisi referral.
* **Apa yang terjadi jika parameter \&referral\_percent= digunakan untuk pool V1?**\
  Parameter ini diabaikan. Untuk pool V1, persentase referral selalu 0,1% jika referral\_address ditentukan.
* **Dalam token apa komisi referral diakumulasikan?**\
  Dalam token input.\
  Contoh: untuk USDT → STON, token input adalah USDT, jadi komisi terakumulasi dalam USDT.
* **Apakah komisi referral berlaku untuk satu swap atau beberapa swap?**\
  Komisi ini berlaku untuk semua swap yang dilakukan setelah membuka DEX melalui tautan referral, sampai konteks referral direset (penyegaran halaman, penutupan aplikasi, tab/sesi lain).
* **Apa yang terjadi jika nilai lebih besar dari 1% diatur untuk referral\_percent?**\
  Sistem secara otomatis menerapkan nilai maksimum yang diizinkan sebesar 1%.
* **Apa yang terjadi jika \&referral\_percent= tidak ditentukan?**\
  Nilai default 0,1% diterapkan.
* **Apakah siapa pun dapat meminta penarikan komisi referral?**\
  Siapa pun dapat mengirim permintaan penarikan, tetapi hanya pemilik vault yang menerima hadiah. Pesan klaim hanya memicu distribusi ke pemilik vault.
* **Apa yang terjadi jika non-pemilik meminta penarikan?**\
  Non-pemilik tidak menerima apa pun. Semua hadiah dikirim ke pemilik vault.

#### Sekilas: membuat tautan

* Tautan minimum V1\
  <https://app.ston.fi/swap?ft=\\><FROM>\&tt=\<TO>\&referral\_address=\<WALLET>
* Tautan minimum V2 dengan tarif kustom\
  <https://app.ston.fi/swap?ft=\\><FROM>\&tt=\<TO>\&referral\_address=\<WALLET>\&referral\_percent=<0.0–1.0>
* Pengingat: Jika Anda memerlukan panduan visual atau tangkapan layar untuk mengklaim hadiah V2, gunakan tutorialnya.