Utilidades
- Acceso a la Pasarela de Pagos de pruebas: TESTPAGO
- Acceso a la utilidad de generación de recibos, con dígitos de control válidos.
Destacamos
Proyecto de funcionamiento básico de la pasarela (Cursillo)
Incorporación de una aplicación a la Pasarela de Pagos:
Documentación Técnica
- Especificaciones funcionales
- Especificaciones Técnicas para Aplicaciones Departamentales
- Modelo de liquidación
Configuración, literales y ficheros de propiedades
- Configuración y ficheros de Propiedades
- Literales (librería de textos literales a visualizar en referencia a los pagos)
- Contenidos estáticos y jsp (para la emisión e impresión de justificantes)
Librerías Aplicaciones Departamentales
Última versión disponible (publicada el 05/06/2026)
| Librería | Versión | Fecha publicación | Descarga |
|---|---|---|---|
| API Aplicaciones Departamentales | p12dtClasses-4.2.4 | 05/06/2026 | Jar libs |
| Utilidades Pasarela Pagos | p12ftClasses-4.2.4 | 05/06/2026 | Jar libs |
Librerías actuales — Jakarta / JDK 17 (recomendadas para nuevos desarrollos)
| Librería | Versión | Fecha publicación | Descarga |
|---|---|---|---|
| API Aplicaciones Departamentales | p12dtClasses-4.2.3.jkt | Jar libs | |
| Utilidades Pasarela Pagos | p12ftClasses-4.2.3.jkt | Jar libs | |
| Utilidades Generales | r01ftShLibClasses-3.8.jkt | Jar libs |
Librerías actuales — Clásica (javax) (para proyectos aún no migrados a Jakarta)
| Librería | Versión | Fecha publicación | Descarga |
|---|---|---|---|
| API Aplicaciones Departamentales | p12dtClasses-4.2.3 | Jar libs | |
| Utilidades Pasarela Pagos | p12ftClasses-4.2.3 | Jar libs | |
| Utilidades Generales | r01ftShLibClasses-3.8 | Jar libs |
Dependencias con librerías de terceros
Algunas funcionalidades requerirán del uso de librerías de terceros. A continuación se muestran las posibles librerías que se pueden necesitar, así como la versión recomendada:
| Dependencias con otras librerías | ||
|---|---|---|
Librerías Legacy (versiones anteriores)
Jakarta — versión anterior
| Librería | Versión | Fecha publicación | Descarga |
|---|---|---|---|
| API Aplicaciones Departamentales | p12dt-4.1.7.jakarta | Jar libs | |
| Utilidades Pasarela Pagos | p12ft-4.1.7.jakarta | Jar libs | |
| Utilidades Generales | r01ftShLibClassesLogs-3.8.2-jkt | Jar libs |
Versiones muy antiguas (4.0.0)
| Librería | Versión | Fecha publicación | Descarga |
|---|---|---|---|
| API Aplicaciones Departamentales | p12d 4.0.0 | Jar libs | |
| Utilidades Pasarela Pagos | p12f 4.0.0 | Jar libs | |
| Utilidades Generales | r01f 2.33.1 | Jar libs | |
| Jar comunes (paquete) | — | ZIP |
SDKs en otros lenguajes
SDK PHP
| Descripción | Licencia | Versión | Descarga |
|---|---|---|---|
| Librerías PHP desarrolladas por Zundan | Opensource GNU/GPL | Zundan PHP SDK | Descargar |
| Librería PHP y ejemplos
Versión más actualizada y ejemplos online en la web de P12PHP. Repositorio Subversion en SourceForge: svn co https://p12php.svn.sourceforge.net/svnroot/p12php p12php |
Opensource Apache 2.0 | P12PHP (v1.1.1) | Descargar |
| Demo aplicación PHP de Netkam | |||
SDK Python
| Descripción | Licencia | Versión | Descarga |
|---|---|---|---|
| Librerías Python desarrolladas por Codesyntax | Opensource GNU/GPL | Codesyntax Python SDK |  Python SDK en GitHub |
Utilidades Aplicaciones Departamentales
| Utilidades para descargar | ||
|---|---|---|
| Generador de PDF en local. Para probar el correcto funcionamiento de las plantillas. | Contiene los archivos necesarios para su implementación en local y un documento HELP.doc con ayuda adicional. | GeneradorPDF |
| Ejemplos nuevas plantillas V3 | Las nuevas plantillas que se creen, se crean en esta versión. | EjemplosPlantillasV3 |
Ficheros de configuración
¿Qué son los ficheros de configuración?
Son ficheros que indican propiedades y configuraciones de los módulos usados por Entidades Financieras y Administraciones.
¿Cuáles son los ficheros de configuración?
- p12ft.properties.xml
- p12dt.properties.xml (aplicaciones departamentales)
- r01ft.properties.xml
¿De dónde descargarse los ficheros de configuración?
| Ficheros de configuración y propiedades | |
|---|---|
| Ficheros de properties y classmap (Entorno de Pruebas) | p12Config |
¿Dónde colocar los ficheros de configuración?
Existen dos posibilidades:
-
Por defecto, se colocarán bajo un directorio que esté en el classPath, donde se crearán los directorios p12ft, r01ft, p12dt.
[directorio en classPath]/p12ft/p12ft.properties.xml -
Si se quiere cambiar el comportamiento por defecto se pueden usar variables del sistema en el arranque del Servidor de Aplicaciones:
Ejemplo 1: Modificar el patrón de carga vía classPath. Para este caso se usan dos variables de sistema.
-DEJIE_PROPERTY_LOADER=classPathLoader
-DEJIE_PROPERTIES_PATTERN=/[entityCode]/[entityCode].properties.xml-DEJIE_PROPERTY_LOADER=classPathLoader indica que se debe cargar de un directorio que esté en el classPath. DEJIE_PROPERTIES_PATTERN indica el patrón de la ruta del directorio del classPath. Por ejemplo, si la ruta del classPath es D:/eadmin/config, quedará como /p12d/p12/p12d.properties.xml.
Ejemplo 2: Modificar el patrón de carga vía ruta física. Se usan tres variables de sistema.
-DEJIE_PROPERTY_LOADER=fileLoader
-DEJIE_CONFIG_FILES_ROOT=filePathLoader
-DEJIE_PROPERTIES_PATTERN=/[entityCode]/[entityCode].properties.xml-DEJIE_PROPERTY_LOADER=fileLoader indica carga desde directorio físico. -DEJIE_CONFIG_FILES_ROOT indica la ruta física, por ejemplo, D:/properties/config. -DEJIE_PROPERTIES_PATTERN indica el patrón dentro de ese directorio.
Ficheros classMap
¿Qué son los ficheros classMap?
Son ficheros que sirven para transformar de XML a objetos y viceversa.
¿Cuáles son los ficheros classMap?
classMap.xml
¿Dónde colocar los ficheros classMap?
La ruta donde colocar los ficheros classMap se especificará en el fichero p12ft.properties.xml, en el tag objectMapPath. Por ejemplo, /datosSoft/p12ft/file/classMap.xml