Dla deweloperów

Osadź widżet BayChange

Dodaj nasz formularz wymiany na swoją stronę jedną linią HTML. Wymiany rozpoczęte w widżecie są przypisywane do Twojego kodu partnerskiego.

Publiczne REST API: jeszcze niedostępne. Na razie możesz zintegrować BayChange za pomocą poniższego widżetu i linków partnerskich. Kod partnerski znajdziesz na swoim koncie – jest tam też generator kodu z podglądem na żywo.

Szybki start

Wklej ten kod tam, gdzie ma się pojawić formularz. Zamień your-code na swój kod partnerski. Domyślna wysokość (720 px) mieści formularz; aby dopasować ją dokładnie, dodaj poniższy skrypt zmiany wysokości.

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>

Parametry

Wszystkie parametry umieszczasz w adresie iframe: https://baychange.com/embed?ref=…&from=…. Wszystkie są opcjonalne.

Parametr	Przykład	Co robi
ref	k7m2qxa	Twój kod partnerski (z konta). Wymiany rozpoczęte w widżecie liczą się jako Twoje. Bez niego widżet działa, ale nic nie jest naliczane.
from	usdt.tron	Kryptowaluta, którą wysyłasz, w formacie SYMBOL.NETWORK. Wielkość liter nie ma znaczenia. Domyślnie: USDT w sieci Tron.
to	btc.btc	Kryptowaluta, którą otrzymujesz. Domyślnie: BTC.
amount	250	Kwota do wysłania, w jednostkach kryptowaluty „from”. Odwiedzający może ją zmienić.
theme	light	Tło wokół formularza: light (białe, domyślnie) lub transparent.
locale	pl	Język interfejsu: en, es, pt-br, tr, ru, uk, kk, uz, az, de, fr, it, pl, ja, zh, id, vi. Domyślnie: en. Widżet otwiera się wtedy pod adresem /<język>/embed (możesz też użyć tego adresu bezpośrednio, np. https://baychange.com/pl/embed?ref=your-code).

Zdarzenia

Widżet wysyła wiadomości do Twojej strony przez postMessage. Zawsze sprawdzaj, czy event.origin to https://baychange.com.

type	Dane	Kiedy
baychange:ready	—	Widżet się załadował.
baychange:resize	{ height }	Wysokość zawartości widżetu w pikselach. Użyj jej, aby dopasować wysokość iframe.
baychange:order_created	{ order: { id, from, to, amountIn } }	Odwiedzający tworzy zlecenie. Strona zlecenia otwiera się na baychange.com w nowej karcie.

Automatyczne dopasowanie wysokości iframe

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>

Nasłuchiwanie nowych zleceń

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

Co widzi odwiedzający

Otrzymuje wycenęWybiera kryptowaluty i kwotę, widzi prowizję i to, ile otrzyma, zanim cokolwiek wyśle.
Podaje swoje adresyAdres odbioru i adres zwrotu są sprawdzane w formularzu, tak jak na naszej stronie.
Otwiera stronę zlecenia„Rozpocznij wymianę” tworzy zlecenie i otwiera jego stronę na baychange.com w nowej karcie, z adresem wpłaty i bieżącym statusem.

Ograniczenia i zasady

Publicznego REST API jeszcze nie ma. Na razie jedyną formą integracji są widżet i linki partnerskie.
Nie umieszczaj iframe w sandboksie. Jeśli musisz, dodaj do niego allow-scripts, allow-same-origin, allow-forms, allow-popups i allow-popups-to-escape-sandbox – inaczej formularz i strona zlecenia nie będą działać.
Iframe powinien mieć co najmniej 320 px szerokości. Formularz jest zaprojektowany na 360–480 px.
Nie zasłaniaj, nie przycinaj i nie zmieniaj wyglądu formularza ani nie proś odwiedzających o adresy portfeli poza nim.
Strona zlecenia z adresem wpłaty zawsze otwiera się na baychange.com, a nie w Twojej witrynie.
Obowiązują standardowe ograniczenia: minimalne kwoty dla każdej kryptowaluty, limity żądań na odwiedzającego i regiony, w których usługa jest niedostępna.
Numer zlecenia w zdarzeniu baychange:order_created otwiera stronę zlecenia. Traktuj go jako poufny: nie publikuj go i nie zapisuj w logach tam, gdzie inni mogą go zobaczyć.

Zarobki, wypłaty i zasady dla partnerów: program partnerski i Warunki programu partnerskiego.

Odbierz swój kod partnerski