Desarrolladores

Integra el widget de BayChange

Agrega nuestro formulario de intercambio a tu sitio con una sola línea de HTML. Los intercambios que se inician en él se acreditan a tu código de socio.

API REST pública: todavía no disponible. Por ahora puedes integrar BayChange con el widget de abajo y con enlaces de socio. Obtén tu código de socio en tu cuenta: ahí también hay un generador de código con vista previa en vivo.

Inicio rápido

Pega esto donde quieras que aparezca el formulario. Reemplaza your-code por tu código de socio. La altura predeterminada (720 px) alcanza para el formulario; para un ajuste exacto, agrega el script de ajuste de altura que está más abajo.

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>

Parámetros

Todos los parámetros van en la URL del iframe: https://baychange.com/embed?ref=…&from=…. Todos son opcionales.

Parámetro	Ejemplo	Qué hace
ref	k7m2qxa	Tu código de socio (lo encuentras en tu cuenta). Los intercambios que se inician en el widget cuentan como tuyos. Sin él, el widget funciona, pero no se acredita nada.
from	usdt.tron	La moneda que envías, en formato SYMBOL.NETWORK. No distingue mayúsculas de minúsculas. Predeterminado: USDT en la red Tron.
to	btc.btc	La moneda que recibes. Predeterminado: BTC.
amount	250	Monto a enviar, en unidades de la moneda de «from». Tu visitante puede cambiarlo.
theme	light	Fondo alrededor del formulario: light (blanco, predeterminado) o transparent.
locale	es	Idioma de la interfaz: en, es, pt-br, tr, ru, uk, kk, uz, az, de, fr, it, pl, ja, zh, id, vi. Predeterminado: en. El widget se abre entonces en /<idioma>/embed (también puedes usar esa dirección directamente, por ejemplo, https://baychange.com/es/embed?ref=your-code).

Eventos

El widget envía mensajes a tu página con postMessage. Verifica siempre que event.origin sea https://baychange.com.

type	Datos	Cuándo
baychange:ready	—	El widget terminó de cargar.
baychange:resize	{ height }	Altura del contenido del widget en píxeles. Úsala para ajustar el tamaño del iframe.
baychange:order_created	{ order: { id, from, to, amountIn } }	Tu visitante creó una orden. La página de la orden se abre en baychange.com en una pestaña nueva.

Ajustar la altura del iframe automáticamente

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>

Escuchar las órdenes nuevas

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

Lo que ve tu visitante

Obtiene una cotizaciónElige las monedas y el monto, y ve la comisión y cuánto va a recibir antes de enviar nada.
Ingresa sus direccionesLa dirección de recepción y la de reembolso se verifican en el formulario, igual que en nuestro sitio.
Abre la página de la orden«Iniciar intercambio» crea la orden y abre su página en baychange.com en una pestaña nueva, con la dirección de depósito y el estado en tiempo real.

Límites y reglas

Todavía no hay una API REST pública. Por ahora, el widget y los enlaces de socio son la única forma de integración.
No pongas el iframe en un sandbox. Si no tienes otra opción, agrégale allow-scripts, allow-same-origin, allow-forms, allow-popups y allow-popups-to-escape-sandbox; si no, el formulario y la página de la orden no van a funcionar.
Mantén el iframe con un ancho de al menos 320 px. El formulario está pensado para 360–480 px.
No tapes, recortes ni cambies el estilo del formulario, y no pidas a los visitantes sus direcciones de billetera fuera de él.
La página de la orden con la dirección de depósito siempre se abre en baychange.com, no dentro de tu sitio.
Se aplican los límites habituales: montos mínimos por moneda, límites de solicitudes por visitante y regiones donde el servicio no está disponible.
El número de orden del evento baychange:order_created abre la página de la orden. Trátalo como un dato privado: no lo publiques ni lo guardes en registros que otros puedan ver.

Ganancias, pagos y reglas para socios: programa de socios y Términos para socios.

Obtén tu código de socio