Guía para las Integraciones de Socios de la API (aplicación pública)

Para ayudar a los integradores de Wish API a entender mejor la documentación de Wish API, cuáles acciones pueden realizarse por medio de la API en comparación con el Tablero de Comerciante y qué funciones es fundamental tener disponibles al construir la integración a Wish, hemos creado la siguiente guía que explica cómo empezar a crear una aplicación pública a través de API. Por favor sigue cada paso:

 

1. Regístrate para aplicación pública en el entorno "sandbox" de Wish:

1). Partner registers as ERP via the ERP Signup page on Wish sandbox environment. Partner can review Wish API documentation.

2). El Socio escribe a la dirección de correo electrónico de Socio API de Wish (partner-api@wish.com) para hacer saber a Wish que se registró para tener acceso al entorno sandbox de Wish.

3). Wish aprobará la aplicación del Socio.

4). Una vez que el Socio sea aprobado, debe iniciar sesión.

5). Click on Account > Create App.

Create an app Name (use a name that you want merchants to see). Redirect URL is needed for OAuth (it’s where authorization is sent to, you can alter it at any time).

     Please note, the details on the above page in Sandbox will not be seen by merchants. 

6). Al socio se le proporcionará una ID de cliente y un secreto de cliente, los que serán usados por el socio para hacer pruebas de la cuenta de comerciante en Wish sandbox (el proceso de OAuth de API de Wish en sandbox requiere la ID de cliente y secreto de cliente).

 

2. Crea una segunda cuenta de comerciante en Sandbox. Debido a que es un entorno sandbox, la información de comerciante que el Socio ingrese no tiene que ser de un comerciante real.

1). El Socio usará una dirección de correo electrónico distinta a la del registro de ERP para iniciar sesión en Wish y comenzar el desarrollo de la aplicación pública como un comerciante.

2). Asocia la cuenta de comerciante falsa con el Socio ERP.

a). Cuando esté dentro de la sesión como comerciante en sandbox, el comerciante debe cambiar el URL a https://sandbox.merchant.wish.com/v3/oauth/authorize?client_id={client_id}  donde {client_id} es la ID de cliente que el ERP generó cuando se creó la aplicación pública. Esto activará una notificación pidiéndole al comerciante que autorice al ERP a tener acceso completo a la tienda del comerciante.

b). Cuando el comerciante otorgue autorización, el URL cambiará a https://example.redirect.uri.com?code={authorization_code} donde el redireccionamiento fue especificado cuando el ERP creó la Aplicación Pública.

c). En este punto, se pueden seguir los procesos típicos de OAuth.

d). Todas las solicitudes de API deben incluir el access_token (token de acceso). Los tokens de acceso son válidos por 30 días.

e). Para obtener nuevos tokens de acceso, se puede utilizar refresh_token. Esta acción invalidará el token anterior.

3). El Socio hará todas las pruebas en el entorno sandbox de Wish.

4). No se requiere aprobación adicional por parte de Wish para proceder.

 

3. Regístrate para aplicación pública en el entorno de producción de Wish

1). Partner registers as ERP in production via the ERP Signup page on Wish production environment.

2). El Socio escribe a la dirección de correo electrónico de Socio API de Wish (partner-api@wish.com) para hacer saber a Wish que se registró para tener acceso al entorno de producción de Wish.

3). Wish will approve Partner’s application or notify Partner of identified issues.

4). Once approved, you may login and select Account > Create 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.

You can view and edit all information submitted above (required or additional) by navigating to Account > App Settings. If the details in the additional information fields are edited or deleted, they will need to undergo the review process again.

5). Review Wish Production environment API documentation

6). Partner completes OAuth process.

7). Partners need to turn on their integration in Wish production environment and remember to point API calls to Wish production environment instead of sandbox environment.

 

4. Los comerciantes deben registrar una cuenta de tienda única en el Tablero de Comerciantes de Wish y autorizar el ERP para enviar/recibir datos a/de la tienda de Wish del comerciante. 

1). Como parte del registro de la cuenta de comerciante, los comerciantes deberán enviar información que verifique licencia comercial e identificación de información personal, las cuales serán aprobadas por Wish.

2). Las cuentas de comerciante serán aprobadas por un representante de gerente de cuentas de 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) Merchant selects Wish authorization link from ERP interface to redirect them to an OAuth Authorization page where they can authorize the ERP.

• The link should be as follows with the ERPs unique production client ID: https://merchant.wish.com/v3/oauth/authorize?client_id={PRODUCTION_CLIENT_ID}

(ii) Merchant clicks ‘Authorize’ to redirect them to the ERP specified "Redirect URI" with an authorization code. ERP will use this authorization code to call Wish APIs to get access token.

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) Merchant selects ‘Add App’ to redirect them to an OAuth Authorization page where they can authorize the ERP.

(ii) Merchant clicks ‘Authorize’ to redirect them to the ERP specified "Redirect URI" with an authorization code. ERP will use this authorization code to call Wish APIs to get access token.

• The connection may not be complete if the ERP specified “Redirect URI” page cannot handle the case where the merchant is not signed in and/or doesn't have an account with the ERP.

• To complete the connection, prompt the merchant to log in or sign up for your ERP. Then, carry the authorization code forward in the url, and complete the OAuth process once the merchant is logged in or has created an account.

c). Authorization is now complete.

d). If at any point the merchant intends to de-authorize the ERP, the merchant can do so from Wish Merchant Dashboard at Account > Settings > API Settings.

 

Please note to improve security for public apps, partners are now able to add up to 2 OAuth client secrets for their public apps. Simply navigate to your App Settings page and click “Add second key” under the first client secret to add a second one:

If needed, partners may also rotate the 2 client secrets by deleting one and adding a new one, in case their client secrets have been compromised.

 

Note: For links to documentation, tips, tutorials, and more check out the Wish Developers Page.