Nhúng widget BayChange
Thêm biểu mẫu đổi coin của chúng tôi vào trang web của bạn chỉ với một dòng HTML. Các lệnh đổi bắt đầu trong đó được ghi nhận cho mã đối tác của bạn.
REST API công khai: chưa có. Hiện tại bạn có thể tích hợp BayChange bằng widget bên dưới và liên kết đối tác. Lấy mã đối tác trong tài khoản của bạn — ở đó còn có công cụ tạo mã với bản xem trước trực tiếp.
Bắt đầu nhanh
Dán đoạn mã này vào nơi bạn muốn biểu mẫu hiển thị. Thay your-code bằng mã đối tác của bạn. Chiều cao mặc định (720 px) vừa với biểu mẫu; để khớp chính xác, hãy thêm script tự điều chỉnh chiều cao bên dưới.
<iframe
src="https://baychange.com/embed?ref=your-code&from=usdt.tron&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>Tham số
Mọi tham số đều nằm trong địa chỉ iframe: https://baychange.com/embed?ref=…&from=…. Tất cả đều không bắt buộc.
| Tham số | Ví dụ | Tác dụng |
|---|---|---|
| ref | k7m2qxa | Mã đối tác của bạn (lấy trong tài khoản). Các lệnh đổi bắt đầu trong widget được tính cho bạn. Không có mã này widget vẫn hoạt động, nhưng không có gì được ghi nhận cho bạn. |
| from | usdt.tron | Coin gửi đi, theo dạng SYMBOL.NETWORK. Không phân biệt chữ hoa và chữ thường. Mặc định: USDT trên Tron. |
| to | btc.btc | Coin nhận về. Mặc định: BTC. |
| amount | 250 | Số lượng gửi đi, tính theo đơn vị của coin “from”. Khách truy cập có thể thay đổi. |
| theme | light | Nền quanh biểu mẫu: light (trắng, mặc định) hoặc transparent (trong suốt). |
| locale | vi | Ngôn ngữ giao diện: en, es, pt-br, tr, ru, uk, kk, uz, az, de, fr, it, pl, ja, zh, id, vi. Mặc định: en. Khi đó widget mở tại /<ngôn-ngữ>/embed (bạn cũng có thể dùng trực tiếp địa chỉ này, ví dụ https://baychange.com/vi/embed?ref=your-code). |
Sự kiện
Widget gửi tin nhắn đến trang của bạn bằng postMessage. Luôn kiểm tra event.origin có đúng là https://baychange.com không.
| type | Dữ liệu | Khi nào |
|---|---|---|
| baychange:ready | — | Widget đã tải xong. |
| baychange:resize | { height } | Chiều cao nội dung widget, tính bằng pixel. Dùng giá trị này để điều chỉnh chiều cao iframe. |
| baychange:order_created | { order: { id, from, to, amountIn } } | Khách truy cập đã tạo lệnh đổi. Trang lệnh đổi mở trên baychange.com trong thẻ mới. |
Tự động điều chỉnh chiều cao iframe
<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>Lắng nghe lệnh đổi mới
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);
}
});Khách truy cập của bạn sẽ thấy gì
- Nhận báo giáChọn coin và số lượng, thấy phí và số coin sẽ nhận trước khi gửi bất cứ thứ gì.
- Nhập địa chỉĐịa chỉ nhận và địa chỉ hoàn tiền được kiểm tra ngay trong biểu mẫu, như trên trang của chúng tôi.
- Mở trang lệnh đổi“Bắt đầu đổi” tạo lệnh đổi và mở trang của lệnh trên baychange.com trong thẻ mới, kèm địa chỉ nạp và trạng thái cập nhật trực tiếp.
Giới hạn và quy tắc
- Hiện chưa có REST API công khai. Widget và liên kết đối tác là cách tích hợp duy nhất ở thời điểm này.
- Đừng đặt iframe trong sandbox. Nếu bắt buộc, hãy thêm
allow-scripts,allow-same-origin,allow-forms,allow-popupsvàallow-popups-to-escape-sandbox, nếu không biểu mẫu và trang lệnh đổi sẽ không hoạt động. - Giữ iframe rộng tối thiểu 320 px. Biểu mẫu được thiết kế cho chiều rộng 360–480 px.
- Đừng che, cắt xén hay thay đổi giao diện biểu mẫu, và đừng hỏi địa chỉ ví của khách truy cập bên ngoài biểu mẫu.
- Trang lệnh đổi có địa chỉ nạp luôn mở trên baychange.com, không mở bên trong trang web của bạn.
- Các giới hạn thông thường vẫn áp dụng: số lượng tối thiểu theo từng coin, giới hạn số yêu cầu cho mỗi khách truy cập và những khu vực không cung cấp dịch vụ.
- Mã lệnh trong sự kiện
baychange:order_createdmở được trang lệnh đổi. Hãy giữ kín mã này: đừng công khai hay ghi vào log mà người khác có thể xem.
Hoa hồng, thanh toán và quy tắc đối tác: chương trình đối tác và Điều khoản đối tác.