GET Réclamation de transaction (liste)
Les éditeurs peuvent extraire des réclamations de transactions individuelles, vérifier l’état de la réclamation de transaction, créer leurs propres rapports et extraire des informations supplémentaires qui peuvent être partagées entre les éditeurs et les annonceurs via un clickref (de l'éditeur à l'annonceur).
Qui peut l’utiliser
Les éditeurs
Comment l’appeler
En tant qu’éditeur :
https://api.awin.com/publisher/votreIdediteur/transactionqueries?startDate=yyyy-MM-ddThh%3Amm%3Ass&endDate=yyyy-MM-ddThh%3Amm%3Ass&timezone=UTC&dateType=transactionDate&statuses=approved&advertiserId=<Idannonceur>
Exemple :
https://api.awin.com/publisher/154870/transactionqueries?startDate=2020-11-11T00:00:00&endDate=2020-11-13T23:59:59&timezone=UTC&dateType=transactionDate&statuses=approved&advertiserId=1001
Ajoutez le paramètre accessToken pour fournir votre clé d’accès comme décrit dans Authentification et autorisation de l’API.
Remarque : la plage de dates maximale entre startDate et endDate actuellement prise en charge est de 31 jours.
| Paramètre | Format | obligatoire/optionnel |
| startDate | yyyy-MM-ddThh:mm:ss | obligatoire |
| endDate | yyyy-MM-ddThh:mm:ss | obligatoire |
| dateType | enquiryDate
transactionDate
validationDate | optionnel (renvoie à « transactionDate » s’il n’est pas défini) |
| timezone | Europe/Berlin
Europe/Paris
Europe/London
Europe/Dublin
Canada/Eastern
Canada/Central
Canada/Mountain
Canada/Pacific
US/Eastern
US/Central
US/Mountain
US/Pacific
UTC | obligatoire |
| publisherId | 12345 | obligatoire |
| advertiserId | 12345 ou 12345,67890 pour plusieurs | optionnel, disponible pour les éditeurs |
| Statuses | pending
approved
declined
deleted or pending,declined pour plusieurs | optionnel |
| clickRefs | clickRef1 or clickRef1 (valeur2),clickRef1 (valeur3) pour plusieurs | optionnel |
| pageNumber | 3 | optionnel (valeur par défaut 1 s’il n’est pas fourni) |
| Pagesize | 20 | optionnel (100 par défaut s’il n’est pas fourni) |
À quoi ressemble la réponse
[
{
"enquiryId": 44562,
"advertiserId": 100,
"advertiserName": "ExampleAdvertiser",
"enquiryDate": "2020-10-03T12:18:00",
"enquiryStatus": "approved",
"commissionAmount": {
"amount": 5.59,
"currency": "GBP"
},
"saleAmount": {
"amount": 55.96,
"currency": "GBP"
},
"orderRef": "14523698",
"clickRef": "customerClickId",
"enquiryType": "approved",
"transactionDate": "2020-10-01T11:45:00",
"validationDate": "2020-10-02T15:30:00",
"declineReason": "null",
"description": "approved",
},
{
.... Next transaction query data here .....
}
]
(...)
Messages d’erreur courants
Certaines erreurs qui apparaissent lorsque des valeurs d’API incorrectes sont analysées :
| Scénario d’erreur | Message d'erreur |
| Date de début après date de fin | endDate ne peut pas être avant startDate |
| Date de début supérieure à 31 jours | Ce paramètre ne prend en charge qu'une plage de dates de 31 jours. Veuillez ajuster votre date de début ou votre date de fin. |
| Utilisation d’un type de date non valide | Type de données incorrect pour le paramètre 'dateType' |
| Utilisation d’un type de statut non valide | Type de données incorrect pour le paramètre 'statuses' |
