Für Entwickler

BayChange-Widget einbinden

Bau unser Tauschformular mit einer einzigen HTML-Zeile auf deiner Website ein. Darin gestartete Tausche werden deinem Partnercode gutgeschrieben.

Öffentliche REST-API: noch nicht verfügbar. Vorerst kannst du BayChange über das Widget unten und über Partnerlinks einbinden. Deinen Partnercode findest du in deinem Konto – dort gibt es auch einen Code-Generator mit Live-Vorschau.

Schnellstart

Füge diesen Code dort ein, wo das Formular erscheinen soll. Ersetze your-code durch deinen Partnercode. Die Standardhöhe (720 px) reicht für das Formular; damit es genau passt, ergänze das Skript zur Höhenanpassung weiter unten.

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

Alle Parameter kommen in die iframe-Adresse: https://baychange.com/embed?ref=…&from=…. Alle sind optional.

Parameter	Beispiel	Funktion
ref	k7m2qxa	Dein Partnercode (aus deinem Konto). Im Widget gestartete Tausche zählen für dich. Ohne ihn funktioniert das Widget auch, es wird aber nichts gutgeschrieben.
from	usdt.tron	Coin, den du sendest, im Format SYMBOL.NETWORK. Groß- und Kleinschreibung spielt keine Rolle. Standard: USDT auf Tron.
to	btc.btc	Coin, den du erhältst. Standard: BTC.
amount	250	Zu sendender Betrag in Einheiten des „from“-Coins. Dein Besucher kann ihn ändern.
theme	light	Hintergrund um das Formular: light (weiß, Standard) oder transparent.
locale	de	Sprache der Oberfläche: en, es, pt-br, tr, ru, uk, kk, uz, az, de, fr, it, pl, ja, zh, id, vi. Standard: en. Das Widget öffnet sich dann unter /<Sprache>/embed (du kannst diese Adresse auch direkt verwenden, z. B. https://baychange.com/de/embed?ref=your-code).

Events

Das Widget sendet per postMessage Nachrichten an deine Seite. Prüfe immer, ob event.origin gleich https://baychange.com ist.

type	Daten	Wann
baychange:ready	—	Das Widget ist geladen.
baychange:resize	{ height }	Höhe des Widget-Inhalts in Pixeln. Damit kannst du die Höhe des iframes anpassen.
baychange:order_created	{ order: { id, from, to, amountIn } }	Dein Besucher hat einen Auftrag erstellt. Die Auftragsseite öffnet sich auf baychange.com in einem neuen Tab.

iframe-Höhe automatisch anpassen

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>

Auf neue Aufträge reagieren

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

Was dein Besucher sieht

Erhält ein AngebotWählt Coins und Betrag und sieht die Gebühr und den Betrag, den er erhält, bevor etwas gesendet wird.
Gibt seine Adressen einEmpfangs- und Rückerstattungsadresse werden im Formular geprüft – genau wie auf unserer Website.
Öffnet die Auftragsseite„Tausch starten“ erstellt den Auftrag und öffnet seine Seite auf baychange.com in einem neuen Tab – mit Einzahlungsadresse und Live-Status.

Einschränkungen und Regeln

Eine öffentliche REST-API gibt es noch nicht. Widget und Partnerlinks sind vorerst die einzigen Integrationswege.
Pack das iframe nicht in eine Sandbox. Wenn es sein muss, ergänze dort allow-scripts, allow-same-origin, allow-forms, allow-popups und allow-popups-to-escape-sandbox, sonst funktionieren das Formular und die Auftragsseite nicht.
Das iframe sollte mindestens 320 px breit sein. Das Formular ist für 360–480 px ausgelegt.
Verdecke das Formular nicht, schneide es nicht ab und gestalte es nicht um – und frag Besucher nicht außerhalb des Formulars nach ihren Wallet-Adressen.
Die Auftragsseite mit der Einzahlungsadresse öffnet sich immer auf baychange.com, nicht innerhalb deiner Website.
Es gelten die üblichen Grenzen: Mindestbeträge je Coin, Anfragelimits pro Besucher und Regionen, in denen der Dienst nicht verfügbar ist.
Die Auftragsnummer im Event baychange:order_created öffnet die Auftragsseite. Behandle sie vertraulich: Veröffentliche oder logge sie nicht dort, wo andere sie sehen können.

Provisionen, Auszahlungen und Partnerregeln: Partnerprogramm und Partnerbedingungen.

Hol dir deinen Partnercode