logoTestPago

puntoUtilidades

puntoDestacamos

Proyecto de funcionamiento básico de la pasarela (Cursillo)

Incorporación de una aplicación a la Pasarela de Pagos:

puntoDocumentación Técnica

Configuración, literales y ficheros de propiedades



puntoLibrerías Aplicaciones Departamentales

Recomendación: Para nuevos desarrollos, utiliza siempre las librerías actuales. Las librerías legacy están disponibles más abajo solo para mantenimiento de proyectos existentes.

Ú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


puntoLibrerías Legacy (versiones anteriores)

Atención: Estas versiones se mantienen únicamente para dar soporte a proyectos existentes. No se recomienda su uso en nuevos desarrollos. Para nuevos proyectos utiliza las librerías actuales (ver arriba).

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


puntoSDKs 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 github Python SDK en GitHub

puntoUtilidades 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

puntoFicheros 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:

  1. 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

  2. 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.



puntoFicheros 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