FAQ


API Amazon Incentives - FAQ

Spécifications techniques de l’intégration - FAQ

L’API Incentives permet aux partenaires de créer et de distribuer rapidement des codes chèques-cadeaux Amazon via Internet.

FAQ non destiné aux développeurs

Voir aussi : Pour plus de réponses aux questions fréquentes de niveau supérieur sur l’API Incentives, consultez la FAQ sur l’API Incentives sur la page d’inscription.

Q. Qu’est-ce qu’un ID de partenaire ?

R : Un ID de partenaire est un identifiant unique que nous vous fournissons et que vous utiliserez avec l’API Incentives. Dans le cadre de l’intégration, vous recevrez un ID de partenaire.


Q. Qu’est-ce que la gestion des clés en libre-service ?

R : La gestion des clés en libre-service est un outil en libre-service qui vous permet de générer et de gérer à la fois les clés d’accès et les clés secrètes dans le portail API Incentives. Pour gérer vos clés, accédez au portail API Incentives de votre site de vente national. Dans le portail, cliquez sur Informations d’identification de sécurité de l’API. Remarque : seul le compte disposant d’un accès administrateur peut voir la page Informations d’identification de sécurité de l’API. Vous pouvez solliciter un accès d’administrateur de compte en nous envoyant un e-mail à incentives-api@amazon.com.)


Q: Quelles sont les instructions relatives au stockage des codes chèques-cadeaux ? Quelles informations sommes-nous autorisés à stocker ?

R : Les partenaires ne sont pas autorisés à stocker les codes de demande. Voir la sectionTraitement des codes chèques-cadeaux.

FAQ pour les développeurs

Quelle est la durée recommandée pour les paramètres de délai d’expiration ?

Pour l’application côté client, nous recommandons un délai d’expiration de 6 secondes.


Après avoir créé un code, existe-t-il une limite de temps pour l’annuler ?

Nous ne recommandons pas d’annuler les codes une fois qu’ils ont été émis. Cependant, si vous pensez qu’il est nécessaire d’annuler un code, l’opération d’annulation doit être effectuée dans les 15 minutes suivant sa création.


À quelle fréquence un compte partenaire peut-il appeler un point de terminaison ?

Les appels vers un point de terminaison ne doivent pas dépasser 10 par seconde, ou un ThrottlingException sera retourné. Pour plus de détails, voir Taux d’accélération.


Que se passe-t-il s’il n’y a pas suffisamment de fonds sur le compte pour couvrir une demande ?

S’il n’y a pas suffisamment de fonds, l’opération de l’API Incentives renverra une erreur F300 et n’activera pas le chèque-cadeau. Il est important de prévoir avec précision les volumes de vos chèques-cadeaux et d’établir un plan de réserve en cas de demande imprévue. Déterminez la meilleure approche en collaboration avec votre responsable de compte.


Je reçois l’erreur « F300 - Dépassement du plafond d’émission » lorsque j’essaie de créer un code de chèque-cadeau.

Cela peut être dû au dépassement du plafond d’émission pour les partenaires de prépaiement non FPS si rien d’autre n’a changé du côté du partenaire. Si vous recevez cette erreur dans un environnement de production, elle est probablement liée au dépassement du montant des fonds que vous avez sur votre compte. Pour en savoir plus, contactez votre responsable de compte. Si vous recevez cette erreur dans un environnement sandbox, contactez Amazon pour obtenir de l’aide.


Je reçois l’erreur « Montant maximal dépassé » lorsque j’essaie de créer un code chèque-cadeau.

Assurez-vous que le montant du chèque-cadeau que vous activez ne dépasse pas 2 000 $ aux États-Unis, conformément aux restrictions imposées par la loi. Les limites peuvent être différentes dans d’autres pays. Consultez la liste des limites des montants de transactions applicables dans neuf pays.


Je reçois cette erreur : F200 Incompatibilité de prédénomination

Ceci est souvent causé par un deuxième appel à CreateGiftCard en utilisant une valeur creationRequestId qui a été utilisée précédemment dans une demande de CreateGiftCard qui a spécifié une valeur de montant différente. Si votre demande utilise le même creationRequestId et la même valeur de montant, l’appel signale le succès et renvoie les résultats renvoyés précédemment par la demande d’origine. Cela est dû au fait que ce point de terminaison est idempotent : plusieurs appels identiques vers le point de terminaison équivalent à un seul appel.


Je reçois de nombreuses erreurs F500/F200, mais je ne comprends pas quel est le problème de mon côté. Que se passe-t-il ?

Les erreurs F500 sont généralement causées par des délais d’expiration du côté d’Amazon. Si ce problème se produit fréquemment, contactez Amazon. Les erreurs F200 sont généralement liées à la soumission d’informations non valides. Si les informations soumises ont été vérifiées, contactez Amazon pour obtenir de l’aide.


Je reçois cette erreur : La chaîne aurait dû être « AWS4-HMAC-SHA256/…./us-east-1/AGCODService/aws4_request….. »

Cela peut être dû à une clé d’accès non valide. Vérifiez que la clé d’accès est correcte et adaptée à votre environnement (sandbox ou production), et confirmez les paramètres régionaux du point de terminaison utilisé. Veillez également à préfixer le qualificateur de clé « AWS4 » à la clé secrète lors de la création de la clé de signature dérivée (kSecret) par http://docs.aws.amazon.com/general/latest/gr/sigv4-calculate-signature.html.


Je reçois cette erreur : <Message>Jeton d’authentification manquant</Message>

Cela peut être dû à la spécification d’un point de terminaison incorrect (par exemple, https://agcod-v2.amazon.com instead of https://agocd-v2-gamma.amazon.com ou un point de terminaison correspondant à vos paramètres régionaux). Vérifiez que le point de terminaison utilisé est correct et adapté à votre environnement (sandbox ou production) ainsi que les paramètres régionaux.


Je reçois cette erreur : HTTP Status 400 - There was an error while processing the request. The request does not match any of the supported protocols.

Ce problème est souvent lié à une demande au point de terminaison incorrect. Vérifiez que vous utilisez le point de terminaison approprié.


L’API Incentives prend-elle en charge les opérations HTTP GET ?

Non. Seul POST est pris en charge


Je reçois l’erreur « L’ID de demande doit commencer par le nom du partenaire », mais j’ai vérifié et le nom du partenaire est correct.

L’ID de partenaire est sensible à la casse. En outre, vérifiez que le point de terminaison et les paramètres régionaux sont corrects (sandbox/ production et NA/ EU).


L’API Incentives prend-elle en charge le protocole SOAP ou les requêtes ?

Non. Seules les demandes RESTful sont prises en charge.


Je reçois l’erreur « javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target » lorsque j’exécute l’exemple de code.

Cela peut être dû à l’absence dans votre keystore Java du certificat de l’autorité de certification « VeriSign Class 3 Public Primary Certificate Authority – G5 » et/ou « VeriSign Class 3 Secure Server CA – G3 » (voir la capture d’écran ci-dessous) qui est le signataire de l’autorité de certification racine/intermédiaire du certificat SSL utilisé sur nos points de terminaison.

Résultat :

Le certificat doit être rempli automatiquement lors de l’installation de l’environnement JRE/JDK sur la machine sur laquelle vous avez installé Eclipse (ou un autre environnement IDE). Vous pouvez utiliser le keytool Java intégré (uniquement disponible dans JDK, pas JRE) pour importer le certificat dans le keystore Java ou exécuter l’exemple de code à partir d’une autre machine avec le certificat de signature de l’autorité de certification racine/intermédiaire installé. L’importation du certificat de l’autorité de certification n’est pas prise en charge par le service AGCOD. Pour plus d’informations, consultez les liens ci-dessous. En cas de doute sur les méthodes suivantes, consultez également votre documentation Java/Eclipse.

Méthode 1 : cette méthode est relativement complexe, mais elle a fait ses preuves pour résoudre le problème.

Méthode 2 : cette méthode est plus simple.

Vous pouvez également importer le certificat dans le keystore Java à l’aide d’un keytool d’appel du plug-in Eclipse :

Une fois le plug-in installé, configurez l’emplacement du keystore. Cet emplacement peut varier en fonction de votre système d’exploitation. Le mot de passe du keystore par défaut est Changeit.


Je reçois cette erreur : <Message>The security token included in the request is invalid.</Message>.

Cela peut être dû à une clé d’accès de sécurité non valide. Vérifiez que votre clé d’accès est correcte et adaptée à votre environnement (sandbox ou production), et confirmez les paramètres régionaux du point de terminaison utilisé.