Desenvolvedores

Incorpore o widget da BayChange

Adicione nosso formulário de troca ao seu site com uma única linha de HTML. As trocas iniciadas nele são creditadas ao seu código de parceiro.

API REST pública: ainda não disponível. Por enquanto, você pode integrar a BayChange com o widget abaixo e com links de parceiro. Pegue seu código de parceiro na sua conta — lá também há um gerador de código com prévia ao vivo.

Início rápido

Cole isto onde o formulário deve aparecer. Substitua your-code pelo seu código de parceiro. A altura padrão (720 px) comporta o formulário; para um ajuste exato, adicione o script de ajuste de altura mais abaixo.

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 os parâmetros vão na URL do iframe: https://baychange.com/embed?ref=…&from=…. Todos são opcionais.

Parâmetro	Exemplo	O que faz
ref	k7m2qxa	Seu código de parceiro (está na sua conta). As trocas iniciadas no widget contam como suas. Sem ele, o widget funciona, mas nada é creditado.
from	usdt.tron	Moeda que você envia, no formato SYMBOL.NETWORK. Não diferencia maiúsculas de minúsculas. Padrão: USDT na rede Tron.
to	btc.btc	Moeda que você recebe. Padrão: BTC.
amount	250	Valor a enviar, em unidades da moeda de “from”. Seu visitante pode alterá-lo.
theme	light	Fundo ao redor do formulário: light (branco, padrão) ou transparent.
locale	pt-br	Idioma da interface: en, es, pt-br, tr, ru, uk, kk, uz, az, de, fr, it, pl, ja, zh, id, vi. Padrão: en. O widget passa a abrir em /<idioma>/embed (você também pode usar esse endereço diretamente, por exemplo, https://baychange.com/pt-br/embed?ref=your-code).

Eventos

O widget envia mensagens para a sua página com postMessage. Sempre confira se event.origin é https://baychange.com.

type	Dados	Quando
baychange:ready	—	O widget terminou de carregar.
baychange:resize	{ height }	Altura do conteúdo do widget em pixels. Use para redimensionar o iframe.
baychange:order_created	{ order: { id, from, to, amountIn } }	Seu visitante criou um pedido. A página do pedido abre em baychange.com em uma nova aba.

Redimensionar o 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>

Escutar novos pedidos

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

O que seu visitante vê

Recebe uma cotaçãoEscolhe as moedas e o valor e vê a taxa e quanto vai receber antes de enviar qualquer coisa.
Informa os endereçosO endereço de recebimento e o endereço de reembolso são verificados no formulário, como no nosso site.
Abre a página do pedido“Iniciar troca” cria o pedido e abre a página dele em baychange.com em uma nova aba, com o endereço de depósito e o status em tempo real.

Limites e regras

Ainda não há API REST pública. Por enquanto, o widget e os links de parceiro são a única forma de integração.
Não coloque o iframe em sandbox. Se precisar, adicione allow-scripts, allow-same-origin, allow-forms, allow-popups e allow-popups-to-escape-sandbox a ele; caso contrário, o formulário e a página do pedido não vão funcionar.
Mantenha o iframe com pelo menos 320 px de largura. O formulário foi pensado para 360–480 px.
Não cubra, corte nem altere o estilo do formulário, e não peça aos visitantes os endereços de carteira fora dele.
A página do pedido com o endereço de depósito sempre abre em baychange.com, não dentro do seu site.
Os limites de sempre continuam valendo: valores mínimos por moeda, limites de solicitações por visitante e regiões onde o serviço não está disponível.
O número do pedido no evento baychange:order_created abre a página do pedido. Trate-o como informação privada: não o publique nem o registre em logs que outras pessoas possam ver.

Ganhos, pagamentos e regras para parceiros: programa de parceiros e Termos de parceria.

Obtenha seu código de parceiro