Afin d'aider les intégrateurs partenaires des APIs Wish à mieux comprendre la documentation des APIs Wish et les actions qui peuvent être effectuées via une API en rapport à Merchant Dashboard et les fonctionnalités essentielles à la prise en charge de l'intégration Wish, nous avons créé le guide suivant pour guider les partenaires API à créer une application publique via une API. Veuillez suivre chacune de ces étapes :
1. Inscrivez-vous pour une application publique sur l'environnement sandbox Wish :
1). Le partenaire s'inscrit en tant qu'ERP via la page d'inscription des ERP dans l'environnement de sandbox de Wish. Le partenaire peut passer en revue la documentation de Wish.
2) Le partenaire envoie un email à partner-api@wish.com pour informer Wish qu'il s'est inscrit pour l'accès à l'environnement sandbox Wish des partenaires API.
3) Wish approuve la candidature du partenaire.
4) Une fois le partenaire approuvé, le partenaire doit se connecter.
5) Cliquez sur Compte > Créer une application.
Créez un nom d'application (utilisez un nom que vous voulez que les vendeurs voient). Une URL de redirection est nécessaire pour OAuth (c'est l'endroit où l'autorisation est envoyée, vous pouvez la modifier à tout moment).
Veuillez noter que les détails de la page ci-dessus dans l'environnement sandbox ne seront pas accessibles aux vendeurs.
6). Le partenaire recevra un identifiant client et un secret client, qui seront utilisés par le partenaire pour tester le compte du vendeur sur le sandbox Wish (le processus OAuth de l'API Wish sur le sandbox nécessite un identifiant client et un secret client).
2. Le partenaire devra créer un deuxième identifiant sur Sandbox en tant que vendeur. Puisqu'il s’agit d'un environnement sandbox, il n’est pas nécessaire que les informations saisies par le partenaire soient celles d’un vrai vendeur.
1). Le partenaire utilisera une adresse email différente de l'inscription ERP pour se connecter à Wish et commencer le développement de l'application publique en tant que vendeur.
2). Associez le faux compte vendeur au partenaire ERP.
a). Lorsqu'il est connecté en tant que vendeur dans la sandbox, le vendeur doit modifier l'URL comme suit : https://sandbox.merchant.wish.com/v3/oauth/authorize?client_id={client_id}, {client_id} étant le client_id généré par l'ERP lors de la création de l'appli publique. Ceci déclenchera une invite demandant au vendeur d'autoriser l'ERP à avoir un accès complet au magasin du vendeur.
b) Lorsque le vendeur autorise la permission, l'URL deviendra https://example.redirect.uri.com?code={authorization_code } où la redirection a été spécifiée lorsque l'ERP a créé l'application publique.
c). À ce stade, les processus typiques de oAuth peuvent être suivis
d). Toutes les demandes d'API doivent inclure le jeton d'accès (access_token). Les jetons d'accès sont valables 30 jours.
e). Pour obtenir de nouveaux jetons d'accès, l'option actualiser_jetons (refresh_token) peut être utilisée. Cette action annulera le jeton précédent.
3). Le partenaire effectuera tous les tests dans l'environnement sandbox Wish.
4). Aucune autorisation supplémentaire de Wish n'est requise pour continuer
3. Inscrivez-vous pour une application publique sur l'environnement de production Wish
1). Le partenaire s'inscrit en tant qu'ERP en production via la page d'inscription des ERP dans l'environnement de production de Wish.
2). Le partenaire envoie un email à partner-api@wish.com pour informer Wish qu'il s'est inscrit pour l'accès à l'environnement production Wish des partenaires API.
3). Wish approuve la candidature du partenaire ou informe le partenaire des problèmes identifiés.
4). Après approbation, vous pouvez vous connecter et sélectionner Compte > Créer une application.
Le partenaire saisit les informations à publier dans l'App Store de Wish. Le nom de l'application et l'URL de redirection sont des champs obligatoires. Le partenaire peut également saisir des informations supplémentaires, telles que le logo de l'application, la proposition de valeur, la description, le site Web et/ou l'email du service clientèle, qui doivent faire l'objet d'un processus de vérification dans la mesure où elles seront visibles par les vendeurs.
S'il saisit de telles informations, la création de l'application sera maintenue et elle pourra être intégrée à l'API. Toutefois, ces champs ne seront publiés dans le Wish App Store qu'une fois qu'ils auront été approuvés. En attendant, le statut d'approbation de ces champs d'informations supplémentaires peut être consulté comme indiqué ci-dessous.
Vous pouvez voir et modifier toutes les informations envoyées ci-dessus (obligatoires ou additionnelles) en accédant à Compte > Paramètres de l'application. Si les détails des champs d'informations supplémentaires sont modifiés ou supprimés, ils devront de nouveau faire l'objet d'un processus de vérification.
5). Consultez la documentation de l'environnement Wish Production.
6). Le partenaire complète le processus OAuth.
7). Les partenaires doivent activer leur intégration dans l'environnement de production Wish et ne pas oublier de pointer les appels d'API sur l'environnement de production Wish et non sur l'environnement sandbox.
4. Les vendeurs doivent créer un compte unique sur le Merchant Dashboard Wishet autoriser l'ERP à envoyer / recevoir des données vers / depuis le magasin Wish du vendeur.
1). Dans le cadre de l'enregistrement du compte du vendeur, les vendeurs devront soumettre des informations de vérification de leur licence commerciale et d'identité qui seront approuvées par Wish.
2). Les comptes vendeurs seront approuvés par un chargé de comptes Wish.
3). Les vendeurs doivent ensuite autoriser l'ERP selon l'une des méthodes suivantes :
a). Le vendeur ouvre un compte auprès de l'ERP de son choix.
(i) Le vendeur sélectionne le lien d'autorisation Wish dans l'interface ERP, qui le dirige vers une page OAuth où il peut autoriser l'ERP.
• Le lien devrait être le suivant avec l'ID client unique de production de l'ERP : https://merchant.wish.com/v3/oauth/authorize?client_id={PRODUCTION_CLIENT_ID}
(ii) Le vendeur clique sur « Autoriser », puis est redirigé vers l'« URI de redirection» spécifiée par l'ERP avec un code d'autorisation. L'ERP utilisera ce code d'autorisation pour appeler les API Wish afin d'obtenir un jeton d'accès.
b). Le vendeur découvre l'ERP sur le Wish App Store (REMARQUE : ce processus n'a pas encore été lancé, mais les ERP doivent pouvoir le gérer en prévision du futur) :
(i) Le vendeur sélectionne « Ajouter une application », puis est redirigé vers une page OAuth lui permettant d'autoriser l'ERP.
(ii) Le vendeur clique sur « Autoriser », puis est redirigé vers l'« URI de redirection» spécifiée par l'ERP avec un code d'autorisation. L'ERP utilisera ce code d'autorisation pour appeler les API Wish afin d'obtenir un jeton d'accès.
• Il se peut que la connexion ne soit pas complète si la page « URI de redirection » spécifiée par l’ERP n'est pas en mesure de traiter le cas où le vendeur n'est pas connecté et/ou ne possède pas de compte auprès de l'ERP.
• Pour finaliser la connexion, demandez au vendeur de se connecter ou de s'inscrire sur votre ERP. Ensuite, reportez le code d'autorisation dans l'url et complétez le processus OAuth une fois que le vendeur s'est connecté ou a créé un compte.
c). L'autorisation est désormais terminée.
d). Si, à un moment quelconque, le vendeur souhaite retirer l'autorisation de l'ERP, il peut le faire à partir du Wish Merchant Dashboard depuis Compte > Paramètres > Paramètres API.
Veuillez noter que pour renforcer la sécurité des applications publiques, les partenaires peuvent désormais ajouter jusqu'à deux secrets clients OAuth à leurs applications. Pour ce faire, rendez-vous simplement sur la page des paramètres de votre application et cliquez sur « Ajouter une deuxième clé » sous le premier secret client :
Si nécessaire, les partenaires peuvent également supprimer un secret client et en ajouter un autre si sa sécurité n'est plus garantie.
Remarque : pour obtenir des liens vers la documentation, des conseils, des tutoriels et plus encore, consultez la page des développeurs Wish.
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.