Transactions

Liste des transactions générées pour chaque programme et diffuseur.

Point d'accès

curl -X GET "https://advibe.fr/api/advertiser/transactions" \
     -H "Authorization: Bearer <token>"

Paramètres

Paramètres à utiliser pour filtrer les résultats du point d’accès.

Nom	Type	Description	Obligatoire
type	string	impressions, clics, dbclicks, leads, sales	Oui
start_date	string	Date au format anglais : YYYY-MM-DD	Oui
end_date	string	Date au format anglais : YYYY-MM-DD	Oui
program_id	int	Identifiant du programme	Non

Réponses

Exemple de réponse renvoyée par l'API

{
	"transaction_id": 12345,
	"program_id": 678,
	"support_id": 1234,
	"invoice_id": 123,
	"turnover": 150.00,
	"total": 10,
	"ip_address": "192.168.1.1",
	"country": "fr",
	"device_type": "Desktop",
	"device_os": "Windows",
	"browser": "Chrome",
	"status": 1,
	"status_label": "Validé",
	"validation_date": "2026-03-03 12:00:00",
	"created_at": "2026-03-01 12:00:00",
	"updated_at": "2026-03-03 14:30:00"
}

Détails des champs

Description des champs renvoyés par l’API.

Nom	Type	Description
transaction_id	int	Identifiant unique de la transaction
program_id	int	Identifiant du programme
support_id	int	Identifiant du support
invoice_id	string	Identifiant de la facture, si disponible
turnover	float	Chiffre d’affaires pour le programme
total	int	Nombre total si type impressions, clics, dbclicks
ip_address	string	Adresse IP de l’action, si disponible
country	string	Pays de l’adresse IP
device_type	string	Type d’appareil (mobile, desktop…)
device_os	string	Système d’exploitation de l’appareil
browser	string	Navigateur utilisé
status	string	Statut de la transaction
status_label	string	Libellé correspondant au statut
validation_date	string	Date de validation
created_at	string	Date de création
updated_at	string	Date de mise à jour

Statut des transactions

Correspondance entre la valeur retournée par l’API et son libellé.

status	status_label	validation_date
0	Refusé	Aucune date
1	Validé	Date et heure de validation
2	En attente	Aucune date

Note

Le champ status_label est traduit selon la langue de l’utilisateur. Si la langue est définie en anglais, le libellé sera retourné en anglais.