General

¿Para quién diseñamos develop.hsbc?

Este sitio es para desarrolladores de software de clientes o de empresas que quieren integrar las APIs de HSBC en sus aplicaciones. Brinda acceso a documentación técnica detallada, sandbox y soporte de nuestro equipo de expertos para que empieces a usarlas.

Si buscas información general sobre HSBC México, por favor ingresa a los siguientes enlaces.

Sitio público de HSBC México

 

¿Con qué mercados es compatible develop.hsbc?

develop.hsbc es la plataforma de desarrolladores global de HSBC que con el tiempo proporcionará acceso a todas las APIs de nuestro mercado, tanto abiertas como comerciales.

En términos de APIs comerciales, este sitio ofrece un conjunto de APIs diseñadas para clientes de banca de empresas con cuentas en la mayoría de los mercados en los que HSBC tiene presencia a nivel mundial.

En lo correspondiente a APIs de Banca abierta, este sitio ofrece APIs de Reino Unido, Europa, Baréin y México. Para más detalles por favor consulta nuestra guía rápida de APIs de Banca abierta.

Actualmente nuestras APIs de Hong Kong son soportadas desde el portal de desarrolladores del mismo país.

 

¿Por qué necesito registrarme?

Puedes navegar por nuestro catálogo de APIs e ingresar a las descripciones generales de todas ellas sin iniciar sesión, pero necesitas registrarte e iniciar sesión para ingresar a la documentación técnica y al sandbox. No es necesario registrarte para ingresar a las APIs de data abierta de Reino Unido.

Además, los desarrolladores que estén interesados en nuestras APIs de Banca abierta de México necesitan registrarse en develop.hsbc para generar credenciales, mismas que deben proporcionarse como parte del proceso de Registro Dinámico de Cliente (DCR por sus siglas en inglés) para nuestras APIs de producción.

Por último, con tu registro podemos contactarte para comunicarte actualizaciones de nuestros servicios y de los desarrollos de nuestros productos  en caso de que te interese recibirlos.

 

¿Se pueden agregar varios usuarios de la misma empresa a la misma organización en develop.hsbc?

Para nuestras APIs comerciales, cuando el primer usuario de una empresa se registra en develop.hsbc, se crea una nueva organización como parte del proceso de registro. Cuando los usuarios posteriores de la misma empresa se registren, se agregarán a la misma organización dentro de develop.hsbc. Un usuario  será designado como administrador y podrá gestionar la membresía de su organización.

Cuando te registras en nuestras APIs de Banca abierta, se crea una organización separada para cada usuario registrado y no es posible agregar usuarios adicionales de la misma empresa a esa organización.

 

Ya tenía una cuenta en la plataforma anterior de desarrolladores, ¿necesito volver a registrarme para develop.hsbc?

Sí, los datos de inicio sesión que ya tenías no funcionarán en develop.hsbc Por favor regístrate en develop.hsbc para crear una cuenta nueva. Esto te dará acceso inmediato a nuestra documentación más reciente y también podrás generar certificados de pruebas si los necesitas.

 

No he recibido un correo electrónico de activación, ¿qué tengo que hacer?

Por favor revisa tu correo no deseado para verificar si recibiste el correo de activación. Si aún no lo encuentras, por favor envíanos un mensaje usando el formulario de "Contáctenos" que se encuentra debajo del menú de "Ayudarte".

 

¿Cómo puedo cambiar mi contraseña?

Por favor usa la opción de "Olvidé mi contraseña" ubicada en la pantalla de "Iniciar sesión" para cambiar tu contraseña.

 

¿Qué navegadores de internet me recomiendan para navegar en develop.hsbc?

La plataforma está optimizada para que la uses en navegadores como Chrome, FireFox, Edge y Safari. Si bien Internet Explorer 11 es compatible, es posible que ciertas imágenes pierdan el formato y que también exista una pérdida de características dinámicas cuando veas los documentos técnicos.

 

¿Puedo registrarme para ingresar a las APIs de producción a través de develop.hsbc? 

No, actualmente, develop.hsbc proporciona documentación que te guiará a través de los pasos necesarios para ingresar a nuestras APIs de producción. Sin embargo, el proceso de registro para consumir nuestras APIs de producción debe de iniciarse por separado.

Los requisitos previos y los pasos técnicos involucrados difieren según el mercado y / o el tipo de API, así que por favor consulta nuestra documentación de implementación para que empieces lo antes posible.

 

¿Con quién puedo hablar sobre lo que ofrecen las APIs Premium de HSBC?

Si quieres saber más acerca de lo que las APIs Premium de Banca abierta de HSBC pueden proporcionar, por favor envíanos un mensaje usando el formulario de "Contáctenos" que se encuentra debajo del menú de "Ayudarte" para que nuestro equipo se comunique contigo.

 

¿Cómo puedo obtener más ayuda?

Si necesitas ayuda adicional o si tienes retroalimentación que consideras que nos puede ayudar a mejorar la calidad de nuestros servicios, por favor envíanos un mensaje usando el formulario de "Contáctenos" que se encuentra debajo del menú de "Ayudarte".

 

Documentación técnica

¿Cómo puedo empezar a usar sus APIs?

Para los clientes corporativos nuevos y existentes que quieran empezar a usar nuestras APIs comerciales, el primer paso es tener una conversación con el Gerente de Relaciones de HSBC o el representante de ventas. Después te asignaremos a un administrador de integración de clientes que te guiará a través del proceso de integración con nuestras APIs. Puedes encontrar más detalles sobre los pasos a seguir en la guía de "¿Cómo empezar?" que se incluyen en cada documento de descripción general de la API. 

Para los Proveedores de Terceros (TPP por sus siglas en inglés) que quieran empezar a usar nuestras APIs de Banca abierta, el primer paso es registrarse en develop.hsbc; después podrán navegar por nuestro "Catálogo API" y revisar la documentación provista. Esto los llevará por el proceso de registro en nuestra plataforma de Banca abierta de producción y la integración con nuestras APIs.

 

¿Por qué no puedo ver la documentación técnica?

Debes ser un usuario registrado para poder ver la documentación técnica de la API. Por favor completa el formulario de registro para obtener acceso. 

Si te estás registrando para nuestras APIs de Banca abierta, te daremos acceso a la documentación tan pronto como termines el proceso de registro.

Si te estás registrando para nuestras APIs comerciales, te daremos acceso una vez que nuestro equipo de Operaciones lo apruebe. Si necesitamos más detalles para completar tu registro, una persona de nuestro equipo se pondrá en contacto contigo. 

 

¿Las especificaciones de las APIs de Banca abierta proporcionadas en develop.hsbc están alineadas con la versión implementada en producción?

Sí, las especificaciones de las APIs en develop.hsbc son las mismas que implementamos en producción. Donde hemos implementado un estándar para toda la industria (por ejemplo, el estándar OBIE en el Reino Unido), las especificaciones en este sitio reflejan la implementación de HSBC de ese estándar. 

A medida en que se publiquen nuevas versiones de estas especificaciones, actualizaremos tanto la producción como este sitio con base en los requisitos regulatorios. En el caso de actualizaciones importantes de especificaciones que impliquen el desarrollo de nuevos end points, ejecutaremos la nueva versión en paralelo con la versión anterior durante un período de tiempo tanto en producción como en develop.hsbc.

 

¿Existe un kit de Desarrollo de software (SDK por sus siglas en inglés) disponible para descargar?

Actualmente, no hay un SDK disponible. Sin embargo, estamos trabajando en esto y pronto agregaremos kits de herramientas descargables en el sitio. 

 

¿La documentación técnica tiene detalles de los mensajes de error de la API?

Sí, hemos definido las respuestas de error con el código de error HTTP relevante para que puedas identificar la causa del problema. 

Estamos trabajando para enriquecer nuestras instalaciones de prueba para proporcionar errores simulados adicionales que representan posibles errores dentro de nuestros sistemas operativos y no solo en la conexión HTTP. 

 

Ambientes de prueba

¿Todas sus APIs tienen un sandbox?

Todas nuestras APIs comerciales tienen un ambiente de pruebas; sin embargo, algunas están en ambientes manejados y no en un ambiente sandbox. Esto significa que es posible que necesitemos realizar algunas actividades de configuración para darte acceso.

El tipo y la disponibilidad de los ambientes de pruebas se especifica en la documentación técnica para cada API. Cuando exista un sanbox disponible encontrarás las instrucciones necesarias en la documentación técnica sobre cómo ingresar al ambiente.

Lanzamos nuestro nuevo Sandbox de Banca abierta compatible con nuestras APIs de Reino Unido, Baréin y las Islas del Canal / Isla de Man (CIIoM)

Puedes encontrar instrucciones completas sobre el acceso y uso del sandbox en nuestra documentación técnica.

No proporcionamos sandbox para nuestras APIs de datos abiertos en el Reino Unido o México.

 

 ¿Los datos del ambiente de pruebas son datos reales de clientes?

No, todos los datos en nuestros sandbox son datos de prueba y no tienen datos reales de clientes HSBC o de instituciones legales. Los datos de los sandbox están diseñados para proporcionar una muestra representativa de lo que se puede esperar en la producción para proporcionar una prueba de participación válida.

 

¿Cómo puedo acceder al Sandbox de Banca abierta?

Una vez que estés listo para probar, tendrás que registrar tu aplicación en el Sandbox. Nuestro Sandbox de Banca abierta sólo admite certificados de prueba emitidos por HSBC. Antes de realizar tu Registro Dinámico de Cliente (DCR por sus siglas en inglés) tendrás que completar algunos pasos previos para generar tu certificado de prueba y un SSA. Crea un proyecto en Dev Hub, que te guiará a través del proceso. Los detalles completos se encuentran en la Guía de Acceso Sandbox de las APIs que te interesan.

Una vez completado el DCR, podrás ver tus certificados generados y tus aplicaciones registradas junto con el Client ID asociado para usarse en el llamado de las APIs del Sandbox.

 

¿Los certificados de prueba generados en la plataforma anterior de desarrolladores seguirán funcionando en el nuevo Sandbox de Banca abierta?

No, nuestro nuevo Sandbox sólo acepta certificados de prueba generados en este portal. Por favor regístrate en develop.hsbc y sigue las instrucciones para generar nuevos certificados de prueba.

 

¿Los certificados de prueba generados en la plataforma anterior de desarrolladores seguirán funcionando en las Instalaciones de prueba de MCI?

Sí, nuestras Instalaciones de prueba de MCI son compatibles con los certificados de prueba generados en la plataforma anterior de desarrolladores, así como los generados en develop.hsbc. 

 

¿La función "probar" en la documentación de la API hace un llamado a las APIs del Sandbox?

No, cuando haces click en "ejecutar" dentro de la función "probar" se devuelve una respuesta predefinida, no hay actividad en la red ni se realiza validación alguna.

 

En el Sandbox de Banca abierta ¿Puedo llamar a los endpoints de forma directa utilizando Postman?

Sí, puedes llamar a las APIs del Sandbox directamente, sin embargo considera que el Sandbox sólo admite certificados de prueba generados en develop.hsbc, hay una serie de pasos que deberás completar dentro del Sandbox para generar los certificados de prueba necesarios. Una vez generados puedes llamar al /register (para registrar tu aplicación) y completar el llamado de endpoints directamente.

 

En el Sandbox de Banca abierta ¿Los flujos de autorización del consentimiento son los mismos que los productivos?

Los flujos de autorización del consentimiento en el Sandbox de Banca abierta replican la función de los flujos productivos desde una perspectiva de Proveedores de Terceros (TPP por sus siglas en inglés) en donde la cuenta relacionada al consentimiento es proporcionada por el TPP o seleccionada por el cliente y se obtiene el código de autorización después de una autenticación exitosa. Sin embargo, el aspecto de las pantallas y los pasos involucrados desde la perspectiva del cliente fueron estandarizados para todas las marcas (y tipos de pago en los flujos de PIS) con la intención de simplificar.

 

¿Los certificados de prueba generados por el sitio son válidos según la especificación del estándar ETSI?

Los certificados generados de prueba X.509 son válidos. Esto significa que son un sustituto de la conexión al Sandbox de Banca abierta. Sin embargo, un certificado de producción emitido por un Proveedor de servicios calificado y de confianza o por el OBIE pueden tener una estructura ligeramente diferente. Los certificados de prueba generados en este sitio no se pueden usar para ningún otro propósito que no sea la prueba en El Sandbox de Banca abierta de HSBC.