Postback URL | Astral Messenger Affiliates

Fonctionnement

Quand un événement est attribué à l'un de vos liens, Astral Messenger appelle la Postback URL configurée sur ce lien. L'appel est un GET en HTTPS, avec les informations ajoutées en query string. Les paramètres que contenait déjà votre URL (un jeton par exemple) sont conservés.

Méthode : GET, en HTTPS uniquement.
Délai d'attente : 3 secondes.
Les redirections ne sont pas suivies.
Un seul appel par événement : aucune relance en cas d'échec ou d'erreur HTTP.

À retenir Le postback est envoyé après attribution de l'événement. Une erreur de votre endpoint ne bloque pas vos statistiques Astral Messenger, mais l'événement ne vous sera pas renvoyé.

Événements envoyés

Événement	Déclenchement
`conversion.user.hit`	Clic attribué sur le lien.
`conversion.user.created`	Inscription attribuée.
`conversion.user.verified`	Première vérification d'email attribuée.
`conversion.purchase.bill`	Achat ou renouvellement attribué.
`conversion.purchase.refund`	Remboursement total, remboursement partiel ou litige bancaire, envoyé avec des montants négatifs. Le détail est dans `conversion_type`.

Paramètres envoyés

Les paramètres vides ou absents ne sont pas envoyés : n'attendez pas une clé systématiquement présente. Les montants exposés correspondent à votre commission affiliée, en centimes.

Toujours présents

event : type d'événement.
event_id : identifiant unique de l'événement source.
occurred_at : date ISO 8601.
click_id : identifiant public du lien.
smartlink_id : identifiant technique du lien.
affiliate_id : identifiant technique de votre compte.

Tracking (si renseignés au clic)

utm_source, utm_medium, utm_campaign.
utm_term, utm_content.
sub1, sub2, sub3, sub4, sub5.

Achat et remboursement

product_code et product_type : le produit concerné.
purchase_type : bill ou rebill.
conversion_type : purchase, refund, partial_refund ou chargeback.
source_order_id : commande source.
currency : devise.

Commission

conversion_id : identifiant de la conversion.
commission_amount_cents : commission affiliée, en centimes.
commission_rate_bps : taux appliqué, en points de base.
Ces trois paramètres ne sont envoyés que lorsqu'une conversion est rattachée à l'événement. Un remboursement ou un litige est envoyé avec une commission négative.

UTM et SubID

Ajoutez vos paramètres à la fin de votre lien de suivi. Ils sont transmis à la destination finale, puis réutilisés dans vos statistiques et dans les postbacks attribués.

https://go.astralmessenger.com/{click_id}?utm_source=meta&utm_campaign=mai_2026&sub1=creative_a&sub2=adset_12

Paramètre	Usage recommandé
`utm_source`	Source du trafic : Meta, TikTok, Google, newsletter.
`utm_medium`	Canal : paid, email, social, referral.
`utm_campaign`	Nom de campagne.
`utm_term`	Mot-clé ou audience.
`utm_content`	Variation de contenu, créa ou message.
`sub1` à `sub5`	Dimensions libres pour vos propres identifiants : créa, adset, placement, campagne interne, source secondaire.

Limites et sécurité

La Postback URL doit être en HTTPS ; les hôtes privés ou réservés sont refusés.
Aucune signature n'est ajoutée à l'appel : si vous devez authentifier la source, mettez un jeton secret dans votre propre URL de postback et vérifiez-le.
Aucune relance n'est effectuée : un endpoint indisponible perd l'événement. Traitez les appels rapidement et répondez en moins de 3 secondes.
Un même événement peut vous parvenir en double en cas de retraitement : dédupliquez sur event_id.
Aucun email, mot de passe, jeton de session ni payload brut n'est envoyé.
Aucun montant de commande, montant HT, TTC ou TVA n'est envoyé : seule votre commission l'est.
Un endpoint en erreur n'empêche pas l'enregistrement de vos statistiques.

Exemple d'appel reçu

GET https://tracker.example.com/postback?token=abc&event=conversion.purchase.bill&event_id=evt_123&occurred_at=2026-09-25T10%3A12%3A00%2B00%3A00&click_id=019eb19a-b4f7-700d-9321-9c2155a42b10&smartlink_id=019eb19a-b4f7-7123-9321-9c2155a42b10&affiliate_id=019eb19a-b4f7-7999-9321-9c2155a42b10&utm_source=meta&sub1=creative_a&product_code=pack_50&product_type=pack&purchase_type=bill&conversion_type=purchase&source_order_id=order_456&currency=eur&conversion_id=019eb19a-b4f7-7aaa-9321-9c2155a42b10&commission_amount_cents=433&commission_rate_bps=3333