Sviluppatori

Integra il widget BayChange

Aggiungi il nostro modulo di scambio al tuo sito con una sola riga di HTML. Gli scambi avviati lì vengono attribuiti al tuo codice partner.

API REST pubblica: non ancora disponibile. Per ora puoi integrare BayChange con il widget qui sotto e con i link partner. Trovi il tuo codice partner nel tuo account, dove c’è anche un generatore di codice con anteprima dal vivo.

Avvio rapido

Incolla questo codice dove vuoi che compaia il modulo. Sostituisci your-code con il tuo codice partner. L’altezza predefinita (720 px) basta per il modulo; per un’altezza esatta, aggiungi lo script di ridimensionamento qui sotto.

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>

Parametri

Tutti i parametri vanno nell’indirizzo dell’iframe: https://baychange.com/embed?ref=…&from=…. Sono tutti facoltativi.

Parametro	Esempio	Cosa fa
ref	k7m2qxa	Il tuo codice partner (dal tuo account). Gli scambi avviati nel widget contano come tuoi. Senza, il widget funziona, ma non ti viene attribuito nulla.
from	usdt.tron	Crypto da inviare, nel formato SYMBOL.NETWORK. Maiuscole e minuscole sono indifferenti. Valore predefinito: USDT su Tron.
to	btc.btc	Crypto da ricevere. Valore predefinito: BTC.
amount	250	Importo da inviare, espresso nella crypto «from». Il tuo visitatore può modificarlo.
theme	light	Sfondo attorno al modulo: light (bianco, predefinito) o transparent.
locale	it	Lingua dell’interfaccia: en, es, pt-br, tr, ru, uk, kk, uz, az, de, fr, it, pl, ja, zh, id, vi. Valore predefinito: en. Il widget si apre quindi su /<lingua>/embed (puoi anche usare direttamente quell’indirizzo, ad es. https://baychange.com/it/embed?ref=your-code).

Eventi

Il widget invia messaggi alla tua pagina con postMessage. Verifica sempre che event.origin sia https://baychange.com.

type	Dati	Quando
baychange:ready	—	Il widget è stato caricato.
baychange:resize	{ height }	Altezza del contenuto del widget in pixel. Usala per ridimensionare l’iframe.
baychange:order_created	{ order: { id, from, to, amountIn } }	Il tuo visitatore ha creato un ordine. La pagina dell’ordine si apre su baychange.com in una nuova scheda.

Ridimensiona l’iframe automaticamente

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>

Ascolta i nuovi ordini

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

Cosa vede il tuo visitatore

Riceve una quotazioneSceglie crypto e importo e vede la commissione e quanto riceverà prima di inviare qualsiasi cosa.
Inserisce i suoi indirizziL’indirizzo di ricezione e un indirizzo di rimborso vengono verificati nel modulo, come sul nostro sito.
Apre la pagina dell’ordine«Avvia lo scambio» crea l’ordine e ne apre la pagina su baychange.com in una nuova scheda, con l’indirizzo di deposito e lo stato in tempo reale.

Limiti e regole

Non esiste ancora un’API REST pubblica. Per ora il widget e i link partner sono l’unica integrazione possibile.
Non mettere l’iframe in sandbox. Se proprio devi, aggiungi allow-scripts, allow-same-origin, allow-forms, allow-popups e allow-popups-to-escape-sandbox, altrimenti il modulo e la pagina dell’ordine non funzioneranno.
Assicurati che l’iframe sia largo almeno 320 px. Il modulo è pensato per 360–480 px.
Non coprire, ritagliare o modificare lo stile del modulo e non chiedere ai visitatori gli indirizzi dei loro wallet al di fuori di esso.
La pagina dell’ordine con l’indirizzo di deposito si apre sempre su baychange.com, non all’interno del tuo sito.
Valgono i limiti consueti: importi minimi per ogni crypto, limiti di richieste per visitatore e regioni in cui il servizio non è disponibile.
Il numero d’ordine nell’evento baychange:order_created apre la pagina dell’ordine. Trattalo come un dato riservato: non pubblicarlo e non registrarlo in log visibili ad altri.

Guadagni, pagamenti e regole per i partner: programma partner e Termini del programma partner.

Ottieni il tuo codice partner