Développeurs

Intégrer le widget BayChange

Ajoutez notre formulaire d’échange à votre site avec une seule ligne de HTML. Les échanges lancés depuis ce formulaire sont attribués à votre code partenaire.

API REST publique : pas encore disponible. Pour l’instant, vous pouvez intégrer BayChange avec le widget ci-dessous et les liens partenaires. Récupérez votre code partenaire dans votre compte – vous y trouverez aussi un générateur de code avec aperçu en direct.

Démarrage rapide

Collez ce code à l’endroit où le formulaire doit apparaître. Remplacez your-code par votre code partenaire. La hauteur par défaut (720 px) suffit pour le formulaire ; pour un ajustement exact, ajoutez le script de redimensionnement ci-dessous.

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>

Paramètres

Tous les paramètres se placent dans l’adresse de l’iframe : https://baychange.com/embed?ref=…&from=…. Ils sont tous facultatifs.

Paramètre	Exemple	Rôle
ref	k7m2qxa	Votre code partenaire (dans votre compte). Les échanges lancés dans le widget vous sont attribués. Sans ce paramètre, le widget fonctionne, mais rien ne vous est attribué.
from	usdt.tron	Crypto envoyée, au format SYMBOL.NETWORK. Majuscules et minuscules sont indifférentes. Par défaut : USDT sur Tron.
to	btc.btc	Crypto reçue. Par défaut : BTC.
amount	250	Montant à envoyer, exprimé dans la crypto « from ». Votre visiteur peut le modifier.
theme	light	Fond autour du formulaire : light (blanc, par défaut) ou transparent.
locale	fr	Langue de l’interface : en, es, pt-br, tr, ru, uk, kk, uz, az, de, fr, it, pl, ja, zh, id, vi. Par défaut : en. Le widget s’ouvre alors à l’adresse /<langue>/embed (vous pouvez aussi utiliser directement cette adresse, par ex. https://baychange.com/fr/embed?ref=your-code).

Événements

Le widget envoie des messages à votre page avec postMessage. Vérifiez toujours que event.origin vaut https://baychange.com.

type	Données	Quand
baychange:ready	—	Le widget est chargé.
baychange:resize	{ height }	Hauteur du contenu du widget, en pixels. Utilisez-la pour redimensionner l’iframe.
baychange:order_created	{ order: { id, from, to, amountIn } }	Votre visiteur a créé une commande. La page de la commande s’ouvre sur baychange.com dans un nouvel onglet.

Redimensionner l’iframe automatiquement

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>

Écouter les nouvelles commandes

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

Ce que voit votre visiteur

Il obtient un devisIl choisit les cryptos et le montant, puis voit les frais et ce qu’il va recevoir avant tout envoi.
Il saisit ses adressesL’adresse de réception et une adresse de remboursement sont vérifiées dans le formulaire, comme sur notre site.
Il ouvre la page de la commande« Lancer l’échange » crée la commande et ouvre sa page sur baychange.com dans un nouvel onglet, avec l’adresse de dépôt et le statut en temps réel.

Limites et règles

Il n’existe pas encore d’API REST publique. Pour l’instant, le widget et les liens partenaires sont les seuls moyens d’intégration.
Ne placez pas l’iframe dans un sandbox. Si c’est indispensable, ajoutez-lui allow-scripts, allow-same-origin, allow-forms, allow-popups et allow-popups-to-escape-sandbox, sinon le formulaire et la page de la commande ne fonctionneront pas.
Prévoyez une largeur d’iframe d’au moins 320 px. Le formulaire est conçu pour 360–480 px.
Ne masquez pas, ne recadrez pas et ne modifiez pas le style du formulaire, et ne demandez pas aux visiteurs leurs adresses de portefeuille en dehors de celui-ci.
La page de la commande avec l’adresse de dépôt s’ouvre toujours sur baychange.com, et non à l’intérieur de votre site.
Les limites habituelles s’appliquent : montants minimums par crypto, nombre de requêtes limité par visiteur et régions où le service n’est pas disponible.
Le numéro de commande transmis dans l’événement baychange:order_created permet d’ouvrir la page de la commande. Traitez-le comme une donnée privée : ne le publiez pas et ne l’enregistrez pas dans des journaux visibles par d’autres.

Gains, versements et règles pour les partenaires : programme partenaires et Conditions du programme partenaires.

Obtenir votre code partenaire