Tərtibatçılar üçün

BayChange vidjetini yerləşdirin

Bir sətir HTML ilə mübadilə formamızı saytınıza əlavə edin. Orada başlanan mübadilələr tərəfdaş kodunuza hesablanır.

Açıq REST API: hələ mövcud deyil. Hazırda BayChange-i aşağıdakı vidjet və tərəfdaş keçidləri ilə inteqrasiya edə bilərsiniz. Tərəfdaş kodunuzu kabinetinizdə əldə edin — orada canlı baxışlı kod konstruktoru da var.

Sürətli başlanğıc

Bunu formanın görünməli olduğu yerə yapışdırın. your-code əvəzinə tərəfdaş kodunuzu yazın. Standart hündürlük (720 px) formaya uyğundur; dəqiq uyğunluq üçün aşağıdakı hündürlük skriptini əlavə edin.

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>

Parametrlər

Bütün parametrlər iframe ünvanına yazılır: https://baychange.com/embed?ref=…&from=…. Hamısı istəyə bağlıdır.

Parametr	Nümunə	Nə edir
ref	k7m2qxa	Tərəfdaş kodunuz (kabinetinizdən). Vidjetdə başlanan mübadilələr sizə hesablanır. Kodsuz da vidjet işləyir, lakin heç nə hesablanmır.
from	usdt.tron	Göndərilən kriptovalyuta, SYMBOL.NETWORK formatında. Böyük-kiçik hərf fərq etmir. Standart: Tron şəbəkəsində USDT.
to	btc.btc	Alınan kriptovalyuta. Standart: BTC.
amount	250	Göndəriləcək məbləğ, «from» kriptovalyutasının vahidləri ilə. Ziyarətçiniz onu dəyişə bilər.
theme	light	Formanın ətrafındakı fon: light (ağ, standart) və ya transparent.
locale	az	İnterfeys dili: en, es, pt-br, tr, ru, uk, kk, uz, az, de, fr, it, pl, ja, zh, id, vi. Standart: en. Bu halda vidjet /<dil>/embed ünvanında açılır (bu ünvandan birbaşa da istifadə edə bilərsiniz, məsələn, https://baychange.com/az/embed?ref=your-code).

Hadisələr

Vidjet postMessage vasitəsilə səhifənizə mesajlar göndərir. Həmişə event.origin dəyərinin https://baychange.com olduğunu yoxlayın.

type	Məlumat	Nə vaxt
baychange:ready	—	Vidjet yükləndi.
baychange:resize	{ height }	Vidjet məzmununun piksellə hündürlüyü. iframe ölçüsünü dəyişmək üçün istifadə edin.
baychange:order_created	{ order: { id, from, to, amountIn } }	Ziyarətçiniz sifariş yaratdı. Sifariş səhifəsi yeni tabda, baychange.com saytında açılır.

iframe hündürlüyünün avtomatik tənzimlənməsi

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>

Yeni sifarişlərin izlənməsi

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);
  }
});

Ziyarətçiniz nə görür

Hesablamanı görürKriptovalyutaları və məbləği seçir, heç nə göndərilməzdən əvvəl komissiyanı və alacağı məbləği görür.
Ünvanlarını daxil edirAlıcı ünvanı və qaytarma ünvanı, saytımızda olduğu kimi, formada yoxlanılır.
Sifariş səhifəsini açır«Mübadiləyə başla» sifarişi yaradır və onun səhifəsini depozit ünvanı və canlı statusla birlikdə yeni tabda, baychange.com saytında açır.

Məhdudiyyətlər və qaydalar

Hələ açıq REST API yoxdur. Hazırda yeganə inteqrasiya üsulu vidjet və tərəfdaş keçidləridir.
iframe-ə sandbox atributu əlavə etməyin. Əgər bu, mütləq lazımdırsa, sandbox-a allow-scripts, allow-same-origin, allow-forms, allow-popups və allow-popups-to-escape-sandbox daxil edin, əks halda forma və sifariş səhifəsi işləməyəcək.
iframe-in eni ən azı 320 px olmalıdır. Forma 360–480 px en üçün nəzərdə tutulub.
Formanı örtməyin, kəsməyin və onun üslubunu dəyişməyin, ziyarətçilərdən pulqabı ünvanlarını formadan kənarda soruşmayın.
Depozit ünvanı olan sifariş səhifəsi həmişə saytınızın içində deyil, baychange.com saytında açılır.
Adi məhdudiyyətlər qüvvədədir: hər kriptovalyuta üçün minimum məbləğlər, hər ziyarətçi üçün sorğu limitləri və xidmətin əlçatan olmadığı regionlar.
baychange:order_created hadisəsindəki sifariş nömrəsi sifariş səhifəsini açır. Onu məxfi saxlayın: başqalarının görə biləcəyi yerdə dərc etməyin və loglara yazmayın.

Qazanc, ödənişlər və tərəfdaş qaydaları: tərəfdaşlıq proqramı və Tərəfdaşlıq şərtləri.

Tərəfdaş kodunu al