¿Cómo integrarme técnicamente?

En esta sección se presenta toda la información necesaria para llevar a cabo la integración técnica al Servicio de Pago Telemático (SPT). Esta integración se basa en protocolos estándar, en base a los cuadernos bancarios: 57, 60 y 65.

A través de la única integración al  SPT, el Organismo puede seleccionar como colaboradoras a cualquiera de las Entidades Financieras adheridas.
 

A continuación se detallan los procedimientos para integrarse en los dos entornos disponibles (DEMO y PRO), así como la especificación de las interfaces para los Organismos y Entidades Financieras.

 


Procedimiento para darse de alta en los entornos de integración (DEMO y PRO)

Este procedimiento es válido tanto para Organismos como para Entidades Financieras (EEFF)

  • Entorno de DEMO. Es el entorno disponible para realizar todas las pruebas para la integración con el SPT. De esta forma, permite comprobar su funcionamiento. Para darse de alta en este entorno el Organismo o la EEFF interesada debe cumplimentar las plantillas de alta. Una vez cumplimentada la plantilla, deberá enviarse al Servicio de Atención que realizará las acciones correspondientes para tramitar su alta. El Servicio de Atención se encuentra disponible para resolver cualquier cuestión que pueda surgir en esta fase de integración, además de los simuladores de organismo y entidad financiera. Las plantillas de alta a cumplimentar se pueden descargar a continuación:
  • Entorno de PRO: Es el entorno de producción en el que el Organismo Público y la EEFF ya puede prestar el servicio de forma operativa. El paso al entorno de producción, se realiza una vez se han finalizado las pruebas en el entorno de demo y previamente se ha firmado el correspondiente Convenio o Protocolo de Adhesión (para más información consultar la sección ¿Cómo Adherirme?  ).

Especificación de las Interfaces de los modos de integración para los Organismos (modo web o webservice):
El Organismo puede decidir entre dos formas de integración:

  • Integración modo web: Una vez el ciudadano completa la información relativa al pago en el portal del Organismo, éste envía al SPT la petición de pago. Este envío se realiza, utilizando protocolos seguros, con los parámetros indicados en el documento: Especificación interfaz Organismos.  Una vez transmitidos los datos del pago, se muestra al ciudadano la página de entrada al SPT con la información que previamente ha cumplimentado en el portal del organismo, para que en ésta confirme el pago y se ejecute el mismo.
  • Integración en modo web service: Una vez completada y firmada electrónicamente la información relativa al pago por parte del ciudadano, el Organismo enviará al SPT la orden de pago. Este envío se realiza mediante la invocación del WebService proporcionado por el SPT, utilizando protocolos seguros, con los parámetros indicados en el documento: Especificación interfaz Organismos. Dentro de esta integración existen dos modalidades a elegir por el organismo, o bien, la validación de la firma del ciudadano la realiza el organismo o la delega en Red.es.

Además, se puede consultar, los requerimientos de acceso a la consola del SPT por parte del administrador del organismo el documento, con la Configuración  técnica de acceso al SPT.

 

Especificación de la interfaz de integración para las Entidades Financieras

Para cualquier consulta en relación a la integración se puede consultar al Servicio de Atención. Existen empresas integradoras que ya han realizado la integración para alguno de los Organismos adheridos.

 

 

 

AdjuntoTamaño
Configuración técnica para el acceso al SPT.pdf704.87 KB
Especificacion_Interfaz_Organismos.pdf1.84 MB
Especificacion_Interfaz_EEFFCC.pdf1.47 MB