Pengembang

Pasang widget BayChange

Tambahkan formulir penukaran kami ke situs Anda dengan satu baris HTML. Penukaran yang dimulai di sana dicatat untuk kode mitra Anda.

REST API publik: belum tersedia. Untuk saat ini Anda bisa mengintegrasikan BayChange lewat widget di bawah dan tautan mitra. Dapatkan kode mitra Anda di akun Anda — di sana juga ada pembuat kode dengan pratinjau langsung.

Mulai cepat

Tempel kode ini di tempat formulir harus muncul. Ganti your-code dengan kode mitra Anda. Tinggi bawaan (720 px) sudah cukup untuk formulir; agar pas persis, tambahkan skrip penyesuaian tinggi di bawah.

HTML

<iframe
  src="https://baychange.com/embed?ref=your-code&amp;from=usdt.tron&amp;to=btc.btc"
  title="Crypto exchange by BayChange"
  width="100%" height="720"
  style="display:block;width:100%;max-width:480px;border:0;color-scheme:light"
  allow="clipboard-read; clipboard-write" loading="lazy"></iframe>

Parameter

Semua parameter ditulis di alamat iframe: https://baychange.com/embed?ref=…&from=…. Semuanya opsional.

Parameter	Contoh	Fungsinya
ref	k7m2qxa	Kode mitra Anda (dari akun Anda). Penukaran yang dimulai di widget dihitung sebagai milik Anda. Tanpa kode ini widget tetap berfungsi, tetapi tidak ada yang dicatat untuk Anda.
from	usdt.tron	Koin yang dikirim, dalam format SYMBOL.NETWORK. Huruf besar atau kecil tidak berpengaruh. Bawaan: USDT di Tron.
to	btc.btc	Koin yang diterima. Bawaan: BTC.
amount	250	Jumlah yang dikirim, dalam satuan koin “from”. Pengunjung Anda bisa mengubahnya.
theme	light	Latar di sekitar formulir: light (putih, bawaan) atau transparent.
locale	id	Bahasa antarmuka: en, es, pt-br, tr, ru, uk, kk, uz, az, de, fr, it, pl, ja, zh, id, vi. Bawaan: en. Widget lalu terbuka di /<bahasa>/embed (Anda juga bisa memakai alamat itu langsung, misalnya https://baychange.com/id/embed?ref=your-code).

Event

Widget mengirim pesan ke halaman Anda dengan postMessage. Selalu periksa bahwa event.origin adalah https://baychange.com.

type	Data	Kapan
baychange:ready	—	Widget sudah dimuat.
baychange:resize	{ height }	Tinggi konten widget dalam piksel. Gunakan untuk menyesuaikan tinggi iframe.
baychange:order_created	{ order: { id, from, to, amountIn } }	Pengunjung Anda membuat pesanan. Halaman pesanan terbuka di baychange.com di tab baru.

Sesuaikan tinggi iframe otomatis

HTML

<iframe
  src="https://baychange.com/embed?ref=your-code"
  title="Crypto exchange by BayChange"
  width="100%" height="720"
  style="display:block;width:100%;max-width:480px;border:0;color-scheme:light"
  allow="clipboard-read; clipboard-write" loading="lazy"></iframe>
<script>
window.addEventListener("message", function (e) {
  if (e.origin !== "https://baychange.com" || !e.data || e.data.type !== "baychange:resize") return;
  document.querySelectorAll('iframe[src^="https://baychange.com/embed"]').forEach(function (f) {
    if (f.contentWindow === e.source) f.style.height = e.data.height + "px";
  });
});
</script>

Pantau pesanan baru

JavaScript

window.addEventListener("message", function (e) {
  if (e.origin !== "https://baychange.com" || !e.data) return;
  if (e.data.type === "baychange:order_created") {
    // e.data.order = { id, from, to, amountIn }
    console.log("BayChange order created", e.data.order.id);
  }
});

Yang dilihat pengunjung Anda

Mendapat penawaranMemilih koin dan jumlah, lalu melihat biaya dan jumlah yang diterima sebelum mengirim apa pun.
Memasukkan alamatAlamat penerima dan alamat pengembalian dicek di formulir, sama seperti di situs kami.
Membuka halaman pesanan“Mulai tukar” membuat pesanan dan membuka halamannya di baychange.com di tab baru, lengkap dengan alamat deposit dan status langsung.

Batasan dan aturan

Belum ada REST API publik. Untuk saat ini, widget dan tautan mitra adalah satu-satunya cara integrasi.
Jangan masukkan iframe ke dalam sandbox. Jika terpaksa, tambahkan allow-scripts, allow-same-origin, allow-forms, allow-popups, dan allow-popups-to-escape-sandbox, karena tanpa itu formulir dan halaman pesanan tidak akan berfungsi.
Lebar iframe minimal 320 px. Formulir dirancang untuk lebar 360–480 px.
Jangan menutupi, memotong, atau mengubah tampilan formulir, dan jangan meminta alamat dompet pengunjung di luar formulir.
Halaman pesanan dengan alamat deposit selalu terbuka di baychange.com, bukan di dalam situs Anda.
Batasan biasa tetap berlaku: jumlah minimum per koin, batas permintaan per pengunjung, dan wilayah tempat layanan tidak tersedia.
Nomor pesanan dalam event baychange:order_created bisa membuka halaman pesanan. Jaga kerahasiaannya: jangan memublikasikannya atau mencatatnya di log yang bisa dilihat orang lain.

Komisi, pembayaran, dan aturan mitra: program mitra dan Ketentuan Mitra.

Dapatkan kode mitra Anda