Разработчикам

Встройте виджет BayChange

Добавьте нашу форму обмена на свой сайт одной строкой HTML. Обмены, начатые в ней, засчитываются на ваш партнёрский код.

Публичного REST API пока нет. Сейчас BayChange можно интегрировать с помощью виджета ниже и партнёрских ссылок. Партнёрский код можно получить в аккаунте — там же есть конструктор кода с живым предпросмотром.

Быстрый старт

Вставьте этот код туда, где должна появиться форма. Замените your-code на свой партнёрский код. Высоты по умолчанию (720 px) форме хватает. Чтобы iframe точно совпадал с ней по высоте, добавьте скрипт подстройки, приведённый ниже.

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>

Параметры

Все параметры передаются в адресе iframe: https://baychange.com/embed?ref=…&from=…. Все они необязательны.

Параметр	Пример	Что делает
ref	k7m2qxa	Ваш партнёрский код (из аккаунта). Обмены, начатые в виджете, засчитываются вам. Без него виджет работает, но ничего не засчитывается.
from	usdt.tron	Монета, которую отдаёт посетитель, в формате SYMBOL.NETWORK. Регистр не важен. По умолчанию — USDT в сети Tron.
to	btc.btc	Монета, которую он получает. По умолчанию — BTC.
amount	250	Сумма к отправке в единицах монеты из параметра «from». Посетитель может её изменить.
theme	light	Фон вокруг формы: light (белый, по умолчанию) или transparent (прозрачный).
locale	ru	Язык интерфейса: en, es, pt-br, tr, ru, uk, kk, uz, az, de, fr, it, pl, ja, zh, id, vi. По умолчанию — en. Виджет при этом открывается по адресу /<язык>/embed (этот адрес можно использовать и напрямую, например https://baychange.com/ru/embed?ref=your-code).

События

Виджет отправляет вашей странице сообщения через postMessage. Всегда проверяйте, что event.origin равен https://baychange.com.

type	Данные	Когда
baychange:ready	—	Виджет загрузился.
baychange:resize	{ height }	Высота содержимого виджета в пикселях. По ней можно менять высоту iframe.
baychange:order_created	{ order: { id, from, to, amountIn } }	Посетитель создал заявку. Страница заявки открывается на baychange.com в новой вкладке.

Автоматическая высота 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>

Отслеживание новых заявок

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

Что видит ваш посетитель

Получает расчётВыбирает монеты и сумму и ещё до отправки видит комиссию и сколько получит.
Вводит свои адресаАдрес получения и адрес возврата проверяются прямо в форме, как на нашем сайте.
Открывает страницу заявкиКнопка «Начать обмен» создаёт заявку и открывает её страницу на baychange.com в новой вкладке — с адресом депозита и статусом в реальном времени.

Ограничения и правила

Публичного REST API пока нет. Сейчас для интеграции есть только виджет и партнёрские ссылки.
Не используйте для iframe атрибут sandbox. Если без него не обойтись, добавьте в него allow-scripts, allow-same-origin, allow-forms, allow-popups и allow-popups-to-escape-sandbox, иначе форма и страница заявки не будут работать.
Ширина iframe — не меньше 320 px. Форма рассчитана на 360–480 px.
Не перекрывайте, не обрезайте и не меняйте оформление формы и не запрашивайте у посетителей адреса кошельков за её пределами.
Страница заявки с адресом депозита всегда открывается на baychange.com, а не внутри вашего сайта.
Действуют обычные ограничения: минимальные суммы для каждой монеты, лимиты запросов для каждого посетителя и регионы, где сервис недоступен.
Номер заявки из события baychange:order_created открывает страницу заявки. Не раскрывайте его: не публикуйте и не записывайте в логи, которые видят другие.

Вознаграждение, выплаты и правила для партнёров: партнёрская программа и Условия партнёрской программы.

Получить партнёрский код