Per aiutare i partner che integreranno Wish API a capire meglio la documentazione API Wish, quali azioni possono essere svolte con API rispetto al Dashboard Commerciante e quali funzionalità fondamentali sono da supportare quando si creano integrazioni con Wish, abbiamo creato la seguente guida che mostra ai partner API come creare un'app pubblica via API. Si prega di seguire i seguenti step:
1. Iscriviti all'app pubblica nell'ambiente sandbox di Wish:
1). Partner registers as ERP via the ERP Signup page on Wish sandbox environment. Partner can review Wish API documentation.
2). Il partner invia una email all'indirizzo API di Wish Partner (partner-api@wish.com) per comunicare di essersi iscritti per ottenere l'accesso API Partner all'ambiente sandbox di Wish.
3). Wish approverà la richiesta di iscrizione del Partner.
4). Una volta approvati, i Partner devono effettuare l'accesso.
5). Clicca su Account > Crea App.
Crea un nome app (usa un nome che vuoi che i commercianti visualizzino). È necessario l'URL di reindirizzamento per OAuth (dove l'autorizzazione viene inviata, puoi modificarlo in qualsiasi momento).
Si prega di tenere presente che i dettagli sulla pagina sopra in Sandbox non saranno visibili dai commercianti.
6). Al Partner verrà fornito un ID client e un client segreto che verranno utilizzati per eseguire il test dell'account commerciante sulla sandbox Wish (il processo Wish API OAuth su sandbox richiede ID client e client segreto).
2. Il partner deve effettuare un secondo accesso su Sandbox come commerciante. Poiché si tratta di un ambiente sandbox, le informazioni commerciante inserite dal Partner non devono essere quelle di un commerciante effettivo.
1). Per accedere a Wish, i Partner devono usare un indirizzo email diverso da quello della registrazione ERP e iniziare a sviluppare un'app pubblica come Commercianti.
2). Associa l'account Commerciante finto al Partner ERP.
a). Una volta effettuato l'accesso come Commerciante nella sandbox, il Commerciante deve cambiare la URL con https://sandbox.merchant.wish.com/v3/oauth/authorize?client_id={client_id} dove {client_id} è l'ID cliente che ERP ha generato alla creazione dell'app pubblica. Questo attiverà una richiesta di autorizzazione per il commerciante ad approvare l'ERP per avere accesso completo al negozio.
b). Quando il Commerciante autorizzerà il permesso, l'URL cambierà in https://example.redirect.uri.com?code={authorization_code}. Il reindirizzamento è stato specificato quando l'ERP ha creato l'App pubblica.
c). A questo punto possono essere seguiti i tipici processi oAuth
d). Tutte le richieste API devono includere l'access_token. I token di accesso sono validi per 30 giorni.
e). Per ottenere nuovi token di accesso è possibile usare refresh_token . Questa azione annullerà il token precedente.
3). Il Partner svolgerà tutti i test nell'ambiente sandbox di Wish.
4). Non sono richieste altre approvazioni da parte di Wish per procedere
3. Iscriviti all'app pubblica in ambiente di produzione Wish
1). Partner registers as ERP in production via the ERP Signup page on Wish production environment.
2). Il partner invia una email all'indirizzo API di Wish Partner (partner-api@wish.com) per comunicare di essersi iscritti per ottenere l'accesso API Partner all'ambiente di produzione Wish.
3). Wish approverà la richiesta di iscrizione del Partner o lo notificherà di problemi specifici.
4). Una volta approvato, potrai effettuare l'accesso e selezionare Account > Crea App.
Partner enters information to be published in the Wish App Store. App name and Redirect URL are required fields. Partner may also enter additional information, such as app logo, value proposition, description, website and/or support email, which need to undergo a review process as they will be visible to merchants.
If this additional information is entered, the app will still be created and be able to integrate with the API, however, these fields will only be published in the Wish App Store once they are approved. In the meantime, the approval status of these additional information fields can be viewed as shown below.
Puoi prendere visione e modificare tutte le informazioni inserite sopra (sia richieste che aggiuntive) andando su Account > Impostazioni app. Se i dettagli nei campi delle informazioni aggiuntive vengono modificati o eliminati, dovranno essere sottoposti nuovamente al processo di revisione.
5). Esaminare la documentazione API in ambiente Wish Production
6). Il partner completa il processo OAuth.
7. I partner devono attivare l'integrazione nell'ambiente di produzione di Wish e ricordare di dirigere le chiamate API all'ambiente di produzione Wish invece che a quello sandbox.
4. I commercianti possono registrare un unico account negozio sul Dashboard Commerciante Wish e autorizzare l'ERP a inviare/ricevere dati da e verso il proprio negozio Wish.
1). Come parte della registrazione dell'account Commerciante, i Commercianti dovranno inviare le informazioni necessarie a identificare la licenza commerciale e le proprie informazioni di identificazione personale, che verranno successivamente approvate da Wish.
2). Gli account commerciante verranno approvati da un rappresentante degli account manager di Wish.
3). Merchants then need to authorize ERP through one of the following methods:
a). Merchant registers for an account at the ERP of their choice.
(i) Il commerciante seleziona il link di autorizzazione di Wish dall'interfaccia ERP per essere reindirizzato a una pagina di autorizzazione OAuth dove possono autorizzare l'ERP.
• Il link dovrebbe essere il seguente, contenente l'ID client di produzione univoco ERP: https://merchant.wish.com/v3/oauth/authorize?client_id={PRODUCTION_CLIENT_ID}
(ii) Il commerciante clicca su "Autorizza" per essere reindirizzato all'ERP specificato "URI di reindirizzamento" con un codice di autenticazione. L'ERP userà questo codice di autorizzazione per chiamare le API Wish e ottenere il token di accesso.
b). Merchant discovers ERP on the Wish App Store (NOTE: this process is not yet launched, but ERPs should be able to handle this process in preparation for its future launch):
(i) Seleziona "Aggiungi App" per reindirizzarli a una pagina di autorizzazione OAuth dove possono autorizzare l'ERP.
(ii) Il commerciante clicca su "Autorizza" per essere reindirizzato all'ERP specificato "URI di reindirizzamento" con un codice di autenticazione. L'ERP userà questo codice di autorizzazione per chiamare le API Wish e ottenere il token di accesso.
• Se la pagina ERP specificata "URI di reindirizzamento" non riesce a gestire il caso in cui il commerciante non abbia effettuato l'accesso e/o non disponga di un account con l'ERP, la connessione potrebbe non essere completa.
• Per completare la connessione, chiedi al commerciante di effettuare l'accesso o di iscriversi al tuo ERP. Successivamente. richiama il codice di autorizzazione nell'URL e completa il processo OAuth quando il commerciante ha effettuato l'accesso o creato un account.
c). Ora l'autorizzazione è completa.
d). Se in qualsiasi momento il commerciante desidera negare l'autorizzazione all'ERP, potrà farlo dal dashboard commerciante Wish andando su Account > Impostazioni > Impostazioni API.
Si prega di notare che, per migliorare la sicurezza delle app pubbliche, i partner possono ora aggiungere fino a 2 client segreti OAuth per le proprie app pubbliche. Vai sulla tua pagina Impostazioni App e clicca su "Aggiungi seconda key" sotto il primo client segreto per aggiungerne uno nuovo:
In caso di necessità, i partner possono anche invertire i 2 client segreti eliminandone uno e aggiungendone un altro, nel caso in cui i propri client segreti siano stati compromessi.
Note: For links to documentation, tips, tutorials, and more check out the Wish Developers Page.
Commenti
0 commenti
Accedi per aggiungere un commento.