Розробникам

Вбудуйте віджет 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	uk	Мова інтерфейсу: en, es, pt-br, tr, ru, uk, kk, uz, az, de, fr, it, pl, ja, zh, id, vi. За замовчуванням — en. Віджет тоді відкривається за адресою /<мова>/embed (цю адресу можна використовувати й напряму, наприклад https://baychange.com/uk/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 відкриває сторінку заявки. Не розголошуйте його: не публікуйте й не записуйте в логи, які бачать інші.

Винагорода, виплати й правила для партнерів: партнерська програма та Умови партнерської програми.

Отримати партнерський код