Partenaires

Suivi des conversions DoctoSpa × tubs.fr

DoctoSpa envoie chaque mois des centaines de visiteurs qualifiés vers tubs.fr : propriétaires de spa ayant identifié une panne précise et cherchant la pièce exacte pour leur modèle. Cette page documente les 3 façons d'attribuer les commandes issues de ce trafic.

1. Identifier notre trafic — déjà en place

Tous les liens sortants de DoctoSpa vers tubs.fr contiennent le paramètre ref=doctospa. Exemple d'URL générée par nos fiches modèles et rapports de diagnostic :

https://www.tubs.fr/fr/advanced_search_result.php?q=pressostat+balboa&ref=doctospa

Il vous suffit de stocker ce paramètre en session/cookie à l'arrivée du visiteur pour attribuer sa commande à DoctoSpa (fenêtre d'attribution suggérée : 30 jours).

2. Postback automatique — recommandé

À chaque commande attribuée à ref=doctospa, votre serveur appelle notre endpoint. Une seule requête HTTP — aucune librairie requise.

Endpoint

POST https://doctospa.fr/api/affiliate/postback
Header : X-Partner-Key: <clé secrète fournie séparément>
Content-Type : application/json

Champs du payload JSON

Champ	Type	Requis	Description
order_id	string	Oui	Identifiant unique de la commande côté tubs.fr (ex. numéro de commande)
order_total_eur	number	Oui	Montant total TTC de la commande en euros
commission_eur	number	Non	Commission calculée par vos soins. Si absent : montant × taux convenu
currency	string	Non	Devise (défaut : EUR)
ref	string	Non	Référence d'affiliation reçue (défaut : doctospa)
status	string	Non	confirmed (défaut) ou cancelled (annulation / remboursement)
occurred_at	string ISO 8601	Non	Date/heure de la commande (défaut : réception du postback)

Exemple cURL

curl -X POST https://doctospa.fr/api/affiliate/postback \
  -H "X-Partner-Key: VOTRE_CLE_SECRETE" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "TUBS-2026-08451",
    "order_total_eur": 189.90,
    "commission_eur": 9.50,
    "ref": "doctospa"
  }'

Exemple PHP (hook post-commande)

if (($_SESSION['affiliate_ref'] ?? '') === 'doctospa') {
    $ch = curl_init('https://doctospa.fr/api/affiliate/postback');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'X-Partner-Key: VOTRE_CLE_SECRETE',
            'Content-Type: application/json',
        ],
        CURLOPT_POSTFIELDS => json_encode([
            'order_id'        => $order->reference,
            'order_total_eur' => (float) $order->total_paid,
        ]),
    ]);
    curl_exec($ch);
    curl_close($ch);
}

Idempotent — renvoyer le même order_id met simplement la conversion à jour, aucun doublon possible.

Annulation — en cas de remboursement, renvoyez le même order_id avec "status": "cancelled".

3. Alternatives sans développement

Code promo dédié — créez un code type DOCTOSPA5 (-5 %) : chaque commande l'utilisant est attribuée à DoctoSpa, sans aucune intégration.
Rapport mensuel — un simple export (nombre de commandes + CA ref=doctospa) envoyé chaque début de mois à contact@doctospa.fr.

Contact

Questions techniques ou commerciales, demande de clé secrète, taux de commission :contact@doctospa.fr

DoctoSpa — Le diagnostic technique de votre spa en 2 minutes · doctospa.fr