Әзірлеушілерге

BayChange виджетін сайтыңызға орнатыңыз

Бір жол HTML кодымен айырбастау формамызды сайтыңызға қосыңыз. Онда басталған айырбастаулар серіктестік кодыңызға есептеледі.

Ашық REST API: әзірге жоқ. Қазір BayChange-ті төмендегі виджет және серіктестік сілтемелер арқылы интеграциялай аласыз. Серіктестік кодыңызды аккаунтыңыздан алыңыз — онда нәтижені бірден көрсететін код құрастырғыш та бар.

Жылдам бастау

Мұны форма шығатын жерге қойыңыз. your-code орнына серіктестік кодыңызды жазыңыз. Әдепкі биіктік (720 px) формаға жеткілікті; дәл сәйкес болуы үшін төмендегі биіктікті реттейтін скриптті қосыңыз.

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 түрінде. Әріп регистрі маңызды емес. Әдепкі: Tron желісіндегі USDT.
to	btc.btc	Алынатын монета. Әдепкі: BTC.
amount	250	Жіберілетін сома, «from» монетасының бірлігімен. Келушіңіз оны өзгерте алады.
theme	light	Форманың айналасындағы фон: light (ақ, әдепкі) немесе transparent (мөлдір).
locale	kk	Интерфейс тілі: en, es, pt-br, tr, ru, uk, kk, uz, az, de, fr, it, pl, ja, zh, id, vi. Әдепкі: en. Сонда виджет /<тіл>/embed мекенжайында ашылады (бұл мекенжайды тікелей де қолдануға болады, мысалы: https://baychange.com/kk/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 оқиғасындағы өтінім нөмірі өтінім бетін ашады. Оны құпия ұстаңыз: басқалар көре алатын жерде жарияламаңыз және логтарға жазбаңыз.

Табыс, төлемдер және серіктестік ережелері: серіктестік бағдарлама және Серіктестік шарттары.

Серіктестік кодты алу