Preguntas frecuentes

General

¿Para quién está diseñado develop.hsbc?

develop.hsbc está creado para desarrolladores de software de organizaciones clientes y terceros que desean integrar las APIs de HSBC en sus aplicaciones. El portal proporciona herramientas completas, documentación técnica, entornos sandbox y soporte para ayudarte a comenzar rápidamente.

¿Qué mercados soporta develop.hsbc?

develop.hsbc es el portal global para desarrolladores de HSBC, que soporta tanto APIs de Open Banking como comerciales en la mayoría de los mercados donde HSBC opera.

APIs comerciales: Diseñadas para clientes de banca corporativa en todo el mundo

APIs de Open Banking: Disponibles para Hong Kong RAE, Reino Unido, Europa y México. Consulta nuestra Guía de inicio de Open Banking para detalles por mercado

Herramienta de Validación de Archivos: Soporta la validación de archivos para HSBCnet, HSBC Connect, SWIFT FileAct o envío por API en la mayoría de los mercados HSBC

Herramienta de Insights de Cuentas HSBC: Soporta la mayoría de los mercados HSBC

¿Qué hay de nuevo en el registro?

Registro unificado: Accede a todas las APIs de HSBC con un solo proceso

¡Lo hemos hecho más fácil que nunca para comenzar! Con nuestro nuevo proceso de registro simplificado, un solo registro te da acceso instantáneo a todas las APIs de Open Banking de HSBC. Si necesitas acceso a APIs corporativas, puedes solicitarlo durante el registro o en cualquier momento después—simplemente haz clic en el botón “Solicitar acceso” cuando se te indique (lo verás en páginas de documentación restringida, tu perfil de usuario o durante la creación de un proyecto en DevHub).

Cómo funciona:

1. Regístrate en el portal.
2. Activa tu cuenta haciendo clic en el enlace de tu correo de activación.

Bueno saber:

- Las APIs de Open Banking están disponibles para todos los que se registren—sin restricciones.

- El acceso a APIs corporativas requiere aprobación inicial. Se te notificará por correo electrónico una vez que sea concedido.

- Acceso a APIs corporativas: Si lo solicitaste, recibirás un correo de confirmación una vez que tu acceso sea aprobado.

- Crea un proyecto en DevHub para recibir tus credenciales de sandbox y comenzar a desarrollar.

¿Por qué necesito registrarme?

Navegar: Puedes ver nuestro catálogo de APIs y resúmenes sin registrarte.

Registrarse: Es necesario para acceder a la documentación técnica, sandbox y herramientas como el Validador de Archivos, Insights de Cuentas HSBC y SDKs.

¿Pueden varios usuarios de la misma empresa ser añadidos a la misma organización en develop.hsbc?

¡Sí! Cuando el primer usuario se registra, se crea una nueva organización. Los usuarios posteriores de la misma empresa se añaden a esta organización. Los usuarios administradores pueden gestionar la membresía e invitar a otros.

¿Por qué no he recibido mi correo de activación?

Los correos de activación pueden ser filtrados a tu carpeta de spam o correo no deseado por tu proveedor de correo electrónico. Por favor, revisa estas carpetas para asegurarte de que el correo no se ha perdido. Estos correos también pueden ser pre-filtrados por el administrador de correo de tu empresa, lo que significa que no los recibirás a menos que tu administrador permita mensajes de do-no-reply@mail.develop.hsbc.com

¿A quién debo contactar para más ayuda?

Si tienes problemas, contacta a nuestro equipo de soporte a través del menú de Ayuda.

¿Cómo puedo restablecer mi contraseña?

Utiliza la opción “¿Olvidaste tu contraseña?” en la pantalla de inicio de sesión.

¿Qué navegadores de internet se recomiendan para usar develop.hsbc?

El portal funciona mejor en Chrome, Firefox, Edge y Safari. Internet Explorer 11 es compatible, pero algunas funciones pueden no mostrarse correctamente.

¿Puedo registrarme para acceder a 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 acceder a nuestras APIs de producción, pero el proceso de registrar tu aplicación para consumir nuestras APIs de producción debe iniciarse llamando directamente a las APIs de registro correspondientes.

Los requisitos previos y pasos técnicos varían según el mercado y/o tipo de API, así que consulta nuestra documentación de implementación para ayudarte a incorporarte lo más rápido posible.

¿Cómo puedo obtener ayuda adicional o enviar comentarios?

Utiliza el formulario de Contacto en el menú de Ayuda para enviar comentarios o solicitar asistencia.

¿Existe un glosario de términos y abreviaturas?

Sí, puedes ver el glosario aquí.

Documentación técnica

¿Cómo empiezo a usar sus APIs?

Revisa la documentación de implementación para conocer los requisitos previos específicos del mercado y de la API.

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

Para ver la documentación técnica de la mayoría de las APIs, debes ser un usuario registrado y haber iniciado sesión en el portal. Simplemente completa el formulario de registro para comenzar.

APIs corporativas: El acceso a las APIs corporativas requiere un paso adicional de aprobación. Puedes solicitar acceso durante el registro o en cualquier momento después haciendo clic en el botón “Solicitar acceso”. Una vez que tu solicitud sea aprobada, recibirás un correo de confirmación.

Requisitos de correo electrónico: Ten en cuenta que algunas direcciones de correo electrónico que no sean de dominio corporativo (como Gmail, AOL, Yahoo) pueden no ser aprobadas para el acceso a APIs corporativas. Recomendamos registrarte con tu correo electrónico oficial de empresa para asegurar un proceso de aprobación fluido.

Si tienes preguntas o necesitas ayuda, nuestro equipo de soporte está aquí para ayudarte.

¿Cómo puedo obtener la guía de formato de archivos para facilitar el desarrollo antes de usar el Validador de Archivos para la validación?

Ponte en contacto con tu contacto de relación o servicio de HSBC o, alternativamente, envíanos un mensaje utilizando el formulario de Contacto que se encuentra en el menú de Ayuda. Por favor, incluye el(los) mercado(s) y el(los) tipo(s) de pago para los que necesitas las guías de formato de archivo.

Instalaciones de prueba

¿Todas sus APIs tienen un sandbox?

La mayoría de las APIs de HSBC proporcionan entornos sandbox o de pruebas gestionadas para ayudarte a desarrollar y probar tus integraciones.

Cómo empezar:

1. Inicia sesión en el portal.
2. Haz clic en DevHub en el menú principal.
3. Selecciona Crear Proyecto para comenzar el proceso. Se te guiará paso a paso para generar tus credenciales de sandbox.

Este enfoque asegura que tengas las credenciales correctas para las APIs que necesitas, haciendo tu experiencia de prueba fluida y eficiente.

Si necesitas más ayuda, ¡nuestro equipo de soporte está listo para ayudarte!

En el Paso 1, puedes elegir entre grupos de APIs. Cada grupo contiene APIs que comparten propiedades comunes, como requisitos de registro o autenticación. Dentro de cada grupo, haz clic en Ver APIs para ver una lista completa de todas las APIs soportadas por las credenciales que estás a punto de crear.

¿Los datos en el sandbox son datos reales de clientes?

No, todos los datos en nuestros sandboxes son datos de prueba y no contienen ningún dato real de clientes o entidades legales de HSBC. Los datos del sandbox están diseñados para proporcionar una muestra representativa de lo que se puede esperar en producción y así proporcionar una entrada de prueba válida para tus aplicaciones.

¿Cómo accedo al Sandbox de Open Banking?

Para comenzar a probar en el Sandbox de Open Banking, sigue estos pasos:

1. Inicia sesión en el portal y ve a DevHub.
2. Crea un nuevo proyecto: el proceso guiado te ayudará a generar los certificados de prueba emitidos por HSBC y tu software statement.
3. Registra tu aplicación en el sandbox usando estas credenciales. Nota: El Sandbox de Open Banking solo soporta certificados de prueba generados en develop.hsbc.

Las instrucciones completas están disponibles en la Guía de Acceso al Sandbox para la API que elijas.

Una vez que hayas completado el Dynamic Client Registration (DCR), podrás:

- Ver tus certificados generados

- Ver tus aplicaciones registradas y sus Client IDs asociados

- Luego puedes usar estas credenciales para llamar a las APIs del sandbox y comenzar a probar.

Si necesitas más ayuda, consulta la Guía de Acceso al Sandbox o contacta a nuestro equipo de soporte.

En el Sandbox, ¿puedo llamar a los endpoints directamente usando Postman?

Sí, puedes llamar a las APIs del sandbox directamente con Postman. Ten en cuenta:

El Sandbox de Open Banking solo soporta certificados de prueba generados en develop.hsbc. Necesitarás completar los pasos en el sandbox para generar estos certificados. Una vez que tus certificados de prueba estén listos, puedes usarlos para llamar a endpoints como /register (para registrar tu aplicación) y endpoints de cumplimiento directamente.

Si necesitas ayuda, consulta la Guía de Acceso al Sandbox o contacta a nuestro equipo de soporte.

Buenas noticias:
Después de crear tu proyecto de sandbox (para APIs de Tesorería y Open Banking), puedes descargar una colección y archivo de entorno de Postman. Estos archivos vienen pre-poblados con tus credenciales de sandbox—para que puedas comenzar a probar de inmediato, con una configuración mínima.

En el Sandbox de Open Banking, ¿los recorridos de autorización de consentimiento son los mismos que los proporcionados en producción?

Los recorridos de autorización de consentimiento en el Sandbox de OB replican la función de nuestros recorridos de producción desde la perspectiva de un TPP, ya que soportan escenarios donde la(s) cuenta(s) a la que se refiere el consentimiento es proporcionada por el TPP o seleccionada por el cliente y se proporciona un código de autorización tras la autenticación exitosa. Sin embargo, el aspecto visual de las pantallas y los pasos involucrados desde la perspectiva del cliente han sido estandarizados en todas las marcas (y tipos de pago para recorridos PIS) para simplificar.

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

Los certificados de prueba generados son certificados X.509 válidos, lo que significa que son un sustituto válido para conectarse al Sandbox de OB o a las Instalaciones de Prueba MCI. Sin embargo, los certificados de producción emitidos por un Proveedor de Servicios de Confianza Calificado o el OBIE pueden ser ligeramente diferentes en estructura. Los certificados de prueba generados en este sitio no pueden usarse para ningún propósito que no sea el uso de las instalaciones de prueba proporcionadas por HSBC.

Uso de la herramienta File Validator

En el informe del File Validator, ¿cómo determino que el archivo no tiene errores?

Si no hay errores, el encabezado del informe del File Validator contendrá tres marcas verdes;
• Informe de validación de archivo – Validación completada con éxito
• Nivel de archivo – Aceptado
• Nivel de instrucción – Aceptado (o Aceptado con fecha de valor cambiada)

¿Hay alguna validación que no esté cubierta por la herramienta File Validator?

File Validator solo te ayuda a probar la sintaxis y el esquema de los archivos de pagos. No ayuda a validar la exactitud de los datos, los siguientes tipos de validaciones no estarán cubiertos por el File Validator en este sitio;
• validaciones contra tu perfil de producción; ej. números de cuenta de débito, ID/código ACH, verificación de duplicados en referencia/nombre de archivo/ID de transacción, etc.
• validaciones basadas en tu HSBCnet de producción para archivos subidos o autorización en HSBCnet; ej. validación de beneficiario HSBC, derechos, etc.
• validaciones durante el procesamiento de pagos; ej. verificación de saldo de cuenta, cuenta de beneficiario y detalles bancarios, aviso de pago, emisión de certificado WHT, etc.

¿Puede el File Validator usarse para validar todos los formatos de archivo y tipos de pago en todos los mercados?

Actualmente el File Validator genera un informe de validación integral para la combinación de mercados, tipos de pago y mercados indicados en la matriz de capacidades. Haz clic aquí para más detalles.

Para combinaciones de otros formatos de archivo, tipos de pago y mercados, el informe de validación puede no contener ‘Nombre de campo inválido’, ‘Valor inválido’ y ‘Referencia/Comentario adicional’ en la sección de detalles de validación del informe.

HSBC continuará mejorando la herramienta File Validator para generar informes de validación integrales para combinaciones adicionales de formatos de archivo, tipos de pago y mercados.

En el informe de validación de la herramienta File Validator, ¿por qué ciertos detalles de validación aparecen como ‘N/A’?

Si los tres campos; ‘Nombre de campo inválido’, ‘Valor inválido’ y ‘Referencia/Comentario adicional’ aparecen como ‘N/A’, lo más probable es que la herramienta no haya sido mejorada para generar el informe de validación integral para la combinación de formatos de archivo, tipo de pago y mercado que se probó.

Consulta también la pregunta frecuente - ¿Puede el File Validator usarse para validar todos los formatos de archivo y tipos de pago en todos los mercados?

El informe del File Validator incluye errores como ‘No se puede identificar el código de país o tipo de pago’, cuando no hay un campo en el archivo para la ubicación de la cuenta de débito. ¿Cómo lo corrijo?

Selecciona la ubicación de la cuenta de débito y el formato de archivo antes de volver a cargar un archivo modificado. Si esto aún no soluciona el error, por favor contáctanos con los detalles.

¿Existe una guía paso a paso para usar la herramienta File Validator?

Sí, haz clic aquí para la guía de usuario

Producción

Estoy experimentando problemas con las APIs de Open Banking en Producción

Si estás experimentando problemas con nuestras APIs de Open Banking en el Reino Unido, puedes acceder a los servicios AIS, PIS o de confirmación de fondos utilizando nuestra Interfaz de Cliente Modificada (MCI), siempre que tengas los permisos correctos. Más detalles sobre cómo acceder a la MCI se pueden encontrar aquí.

Después de una validación exitosa del archivo de pago usando el File Validator, ¿puedo enviar los archivos de pago en vivo al banco para su procesamiento?

Aunque el archivo haya pasado la validación, por favor asegúrate de lo siguiente antes de enviar los archivos de pago en vivo para su procesamiento:
1. Recibe confirmación de HSBC de que toda la configuración relevante ha sido completada para los servicios, cuentas y tipos de pago previstos.
2. Realiza una prueba de pago de extremo a extremo (de bajo valor) con satisfacción, en el entorno en vivo

``` ¿Necesitas traducir más secciones o alguna aclaración sobre el contenido?