MANUAL PLATAFORMA PAGO TELEMÁTICO Versión 1.1

Transcripción

1 MANUAL PLATAFORMA PAGO TELEMÁTICO Versión 1.1 FEBRERO 2007 Página: 1

2 1 TABLA DE CONTENIDO 1 TABLA DE CONTENIDO INTRODUCCIÓN DESCRIPCIÓN DE LOS SERVICIOS PAGO A CUENTA Definición WSDL del servicio Parámetros del servicio PAGO CON TARJETA Definición WSDL del servicio Parámetros del servicio Anexos Códigos de retorno devueltos por la plataforma de pago Códigos de retorno devueltos por el TPV Interfaz WSDL de la plataforma de pagos EJEMPLOS DE MENSAJES SOAP PAGO A CUENTA CONSULTA A CUENTA CANCELACIÓN A CUENTA PAGO CON TARJETA (Servicio TPV) CANCELACIÓN CON TARJETA (Servicio TPV) Página: 2

3 2 INTRODUCCIÓN Actualmente se ha adquirido la pasarela de pagos de TBSOLUTIONS. Por lo tanto, las aplicaciones que requieran realizar algún tipo de pago deberán hacerlo a través de esta pasarela. Envío de datos de pago: - Nif - Cuenta - Justificante - Fecha Entidad Bancaria 1 Aplicación WEB Pasarela Pago Entidad Bancaria 2 Entidad Bancaria 2 Este documento tiene como finalidad recoger todos los aspectos relacionados con la integración con los distintos servicios que ofrece la Plataforma de Pago. Por un lado, se describen las funciones u operaciones que ofrecen los servicios web de la plataforma y por otro la forma de invocar a estas operaciones. Para la publicación de los servicios, se ha utilizado tecnología WebService basada en invocaciones utilizando mensajería SOAP. Se detalla cómo debe ser el formato de petición SOAP para realizar invocaciones directas al servicio Web que se ofrece en la aplicaciones Java que necesiten la implementación de pagos telemáticos. Dentro de los ejemplos disponibles en la web de Arquitectura (soja_int), este uno al que se referirán todos las indicaciones en cuanto a código que se encuentren dentro de este manual. 3 DESCRIPCIÓN DE LOS SERVICIOS Los servicios que vamos a describir de la Plataforma de Pagos son los siguientes: Pago: este servicio supone lo que se denomina Pago a Cuenta, es decir el pago a través del número de cuenta del usuario. serviciotpv: este otro servicio nos proporciona la posibilidad del Pago con Tarjeta. Para la descripción de los tipos de datos que admiten los servicios se ha utilizado la siguiente notación: An Alfanumérico N- Numérico Página: 3

4 4 PAGO A CUENTA Este servicio permite la realización de operaciones de pago de un determinado importe, consulta de un pago o cancelación de un pago en una cuenta corriente especificada por el usuario. Y ejecuta bajo la operación pago según se describe a continuación, invocando el webservice de la plataforma siguiendo la definición posterior. 4.1 Definición WSDL del servicio <wsdl:operation name="pago"> <wsdlsoap:operation soapaction="" /> <wsdl:input name="pagorequest"> <wsdlsoap:body use="encoded" encodingstyle=" namespace="urn:pagows" /> </wsdl:input> <wsdl:output name="pagoresponse"> <wsdlsoap:body use="encoded" encodingstyle=" namespace="urn:pagows" /> </wsdl:output> </wsdl:operation> <wsdl:message name="pagorequest"> <wsdl:part name="peticionpago" type="tns1:peticion" /> </wsdl:message> <wsdl:message name="pagoresponse"> <wsdl:part name="pagoreturn" type="tns1:respuesta" /> </wsdl:message> <complextype name="peticion"> <element name="fecha" nillable="true" type="xsd:string"/> <element name="idaplicacion" nillable="true" type="xsd:string"/> <element name="importe" type="xsd:double"/> <element name="justificante" nillable="true" type="xsd:string"/> <element name="nif" nillable="true" type="xsd:string"/> <element name="numerocuenta" nillable="true" type="xsd:string"/> <element name="peticioncasilla" nillable="true" type="impl:arrayof_tns1_peticioncasilla"/> <complextype name="respuesta"> <element name="codigorespuesta" nillable="true" type="xsd:string"/> <element name="estadotransaccion" nillable="true" type="xsd:string"/> <element name="fecha" nillable="true" type="xsd:string"/> <element name="importe" type="xsd:double"/> <element name="moneda" nillable="true" type="xsd:string"/> <element name="nccm" nillable="true" type="xsd:string"/> <element name="numerojustificante" nillable="true" type="xsd:string"/> <element name="respuestacasilla" nillable="true" type="impl:arrayof_tns1_respuestacasilla"/> <element name="respuestaconsulta" nillable="true" type="xsd:string"/> <element name="tipooperacion" nillable="true" type="xsd:string"/> <complextype name="respuestacasilla"> <complexcontent> <extension base="tns2:infoaccessor"> <element name="nombre" nillable="true" type="xsd:string"/> <element name="valor" nillable="true" type="xsd:string"/> </extension> </complexcontent> Página: 4

5 4.2 Parámetros del servicio Los siguientes cuadros muestran la definición de las variables que se intercambian con el servicio web, vamos a diferenciar los de petición y los de respuesta. - Petición: estructura de información que contiene los parámetros de entrada para realizar una operación en la plataforma de pagos contra una entidad financiera (pago, consulta o cancelación). Nombre Tipo Obligatorio Descripción idaplicacion An(10) Sí Justificante N(14) Sí NIF An (11) Sí numerocuenta N (20) Sí importe N Sí fecha N (8) Sí moneda An(3) Sí tipopeticion N (1) Sí Identificador de la aplicación que invoca a la plataforma de pagos Número de justificante identificador del pago. Completado con ceros por la izquierda hasta 14 posiciones. NIF de la persona que realiza la operación. Formateado con espacios en blanco a la izquierda hasta completar 11 posiciones Número de cuenta contra el que se realizar la operación. Importe de la operación. Formato admitido (####.##) (separador decimal, el punto) Fecha de la operación realizada contra la EF. Su formato es (AAAAMMDD) Código de moneda utilizado en las operaciones. Por defecto EUR. identificador del tipo de petición realizado a la plataforma: Para operaciones de pago su valor es 0. Para operaciones de consulta su valor es 1. Para operaciones de cancelación su valor es 3. - Respuesta: estructura de información de respuesta de una operación en la plataforma de pagos contra una entidad financiera. Nombre Tipo Obligatorio Descripción tipooperacion N (1) Sí Tipo de operación que se ha realizado: Para operaciones de pago su valor es 0. Para operaciones de consulta su valor es 1. Para operaciones de cancelación su valor es 3. Página: 5

6 Nombre Tipo Obligatorio Descripción estadotransaccion N (1) Sí codigorespuesta An (2) Sí respuestaconsulta An (2) numerojustificante An (14) Importe N Sí Importe del pago Sí Sí Estado en el que ha finalizado la operación contra la entidad financiera. Su valor será 0 cuando se consulten pagos no realizados. Su valor será 0 cuando se consulten pagos ya realizados. Su valor solo tendrá utilidad como resultado de operaciones de consulta. Código de respuesta de la operación. Consultar la tabla códigos de retorno devueltos por la plataforma. Resultado de realizar una consulta. Para esta operación su valor no será relevante. Número de justificante que identifica el pago realizado Moneda An(3) Sí Moneda utilizada. Por defecto EUR. Fecha N(8) Sí fecha de la operación realizada. Formato AAAAMMDD. NCCM An (8) Sí Código generado por la entidad financiera 5 PAGO CON TARJETA El servicio TPV permite la realización de operaciones con tarjeta de crédito (pago y cancelación) contra un terminal punto de venta virtual (TPV). Y ejecuta bajo la operación serviciotpv según se describe a continuación, invocando el webservice de la plataforma siguiendo la definición siguiente. 5.1 Definición WSDL del servicio <wsdl:operation name="serviciotpv"> <wsdlsoap:operation soapaction="" /> <wsdl:input name="serviciotpvrequest"> <wsdlsoap:body encodingstyle=" namespace="urn:pagows" use="encoded" /> </wsdl:input> <wsdl:output name="serviciotpvresponse"> <wsdlsoap:body encodingstyle=" namespace="urn:pagows" use="encoded" /> </wsdl:output> </wsdl:operation> <complextype name="peticiontpv"> <element name="nif" nillable="true" <element name="pan" nillable="true" <element name="codigovalidacion" nillable="true" <element name="fechacaducidad" nillable="true" <element name="fechaventa" nillable="true" <element name="idaplicacion" nillable="true" <element name="importe" type="xsd:double" /> <element name="referencia" nillable="true" <element name="tipopeticion" nillable="true" <complextype name="respuestatpv"> <element name="codigoretorno" nillable="true" <element name="descripcionerror" nillable="true" Página: 6

7 <element name="fechaoperacion" nillable="true" 5.2 Parámetros del servicio Los siguientes cuadros muestran la definición de las variables que se intercambian con el servicio web, vamos a diferenciar los de PeticionTPV y los de RespuestaTPV. - PeticionTPV: estructura de información que contiene los parámetros de entrada necesarios para ordenar a la plataforma de pagos la realización de una operación (pago o cancelación) contra un terminal punto de venta virtual (TPV). Nombre Tipo Obligatorio Descripción idaplicacion N(10) Sí Referencia An(13) Sí PAN N(19) Sí* Importe N Sí fechaventa N(8) Sí* fechacaducidad N(4) Sí* codigovalidacion N(4) Sí* tipopeticion N(1) Sí Identificador de la aplicación que invoca al servicio TPV de la plataforma de pagos Número de referencia identificador del pago por TPV. Completado con ceros por la izquierda hasta 13 posiciones. Número de tarjeta con el que se realiza la operación. Solo para operaciones de pago Importe de la operación. Admite el siguiente formato (####.##) (el punto como separador decimal) Fecha de la operación. Su formato es (AAAAMMDD). Solo es necesario para operaciones de cancelación Fecha de caducidad de la tarjeta de crédito. Su formato es (AAMM). Solo para operaciones de pago Código de validación de la tarjeta con la que se realiza la operación. Solo para operaciones de pago Identificador del tipo de petición realizado a la plataforma: Para operaciones de pago su valor es 0. Para operaciones de cancelación su valor es 3. NIF An(9) Si NIF de la persona que va a realizar el pago Página: 7

8 - RespuestaTPV: estructura de información de respuesta de una operación en la plataforma de pagos contra contra un terminal punto de venta virtual (TPV). Nombre Tipo Obligatorio Descripción codigoretorno N (3) Sí descripcionerror An Sí fechaoperacion N(8) Sí Código de retorno enviado por el TPV. Consultar el anexo con los códigos de retorno del TPV. Mensaje descriptivo enviado por el TPV cuando se produce un error en la operación. Fecha de la operación. Su formato es (AAAAMMDD) Página: 8

9 6 PASOS PARA EL USO DE LA PLATAFORMA 6.1 Fichero de configuración En el fichero de configuración se deberá añadir una nueva variable pagoonline.idaplicacion. El valor de la misma será un identificar de la aplicación que va a realizar la operación de pago. Este identificador se deberá dar de alta dentro de la consola de la pasarela de pago, y para ello habrá que solicitar su alta a la Unidad de Arquitectura de Aplicaciones. 6.2 Fichero de propiedades de la plataforma Dentro del directorio classes de nuestra aplicación tendremos que crear la carpeta propertyfiles (si es que no existe ya) y en ella introducir el siguiente fichero de propiedades: Página: 9

10 - plataforma-client.properties: ################################### ############### LOG ############### ################################### #Clase que implementa la interfaz jfactory.util.log jfactory.util.log.class = jfactory.util.singlelog #Nivel de traza (10==sólo errores; 20==Traza; 30=Debug) jfactory.util.log.niveltraza = 30 #Fichero de escritura de los mensajes de log #File for write log messages jfactory.util.log.nombreficherolog = "test.log" #File for write trace messages jfactory.util.log.nombreficherotraza = "test.traza" jfactory.util.log.mostrarfecha ="true" jfactory.util.log.mostrarnivel ="true" jfactory.util.log.mostrarthread ="true" jfactory.util.log.mostrarsessionid ="true" jfactory.util.log.mostraraplicacion ="true" jfactory.util.log.mostrarmetodo ="true" ####### # EJB # ####### # PortableContext specific implementation for this platform jfactory.ejb.portablecontext.class=jfactory.ejb.ejb11.portablecontext11 # Specifies if we are going to use portable contexts inside EJBs or in clients jfactory.ejb.portablecontext.insideejb=false # Specifies this is a remote client or an internal one. jfactory.ejb.portablecontext.isremoteclient=false # Specifies if the application needs the class PortableContext jfactory.ejb.useportablecontext = false # # URLS DE LOS SERVICIOS # jfactory.pasarela.urlpasarelaservice.endpoint = " Página: 10

11 6.3 LIBRERÍAS Las librerías que son necesarias para el uso de la nueva plataforma son: pagoonline.jar (nueva versión) plataforma-pago-cliente.jar En caso de no existir ya en el entorno, es necesario incluir las siguientes librerías: Jfactory.jar Seguridad_cm.jar sistemas2_1.jar webservice_icm.jar Axis.jar Wsdl4j.jar Estas librerías están disponibles en la web de soja_int. 6.4 EJEMPLO DE USO Dentro de el entorno de soja_int existe un ejemplo que sigue este manual con un cliente para el servicio web. La aplicación ejemplo se llama ejemplopagows. Página: 11

12 7 Anexos 7.1 Códigos de retorno devueltos por la plataforma de pago A continuación se exponen los códigos de retorno devueltos por la plataforma de pagos ante peticiones de cargo en cuenta, y a su vez se incluyen los principales códigos de retorno devueltos por las entidades financieras. Código Retorno Descripción EV Los parámetros enviados a la plataforma de pago no son correctos EP Error desconocido de la plataforma de pagos EN Error NRC. NRC incorrecto enviado por la entidad financiera ED La entidad financiera no existe o esta inhabilitada temporalmente. EC Error al conectar con la entidad colaboradora TR No recibida respuesta del banco. Resultado de la operación desconocido EF Error de formato en la respuesta de la entidad financiera AP La aplicación no esta autorizada. 00 Operación correcta 01 Tipo de operación incorrecta o ausente. 02 N.I.F. de certificado ausente o anónimo. 03 N.I.F. de certificado corresponde a una persona jurídica. 04 Entidad Bancaria ausente o errónea. 05 Sucursal ausente o errónea. 06 Error en la relación de N.I.F. B Cuenta. Dicho N.I.F. no tiene esta cuenta. 07 Cuenta ausente o errónea. 08 Dígito de control ausente o erróneo. 09 Cuenta no válida para realizar estos cargos. 10 Código de moneda erróneo. 11 Fecha de operación ausente o errónea. 12 MAC erróneo. 13 Saldo no suficiente para realizar la operación. 14 Error de formato de los datos de la petición. 15 Servicio suspendido temporalmente. 16 Pago ya efectuado. 86 Esta entidad no atiende la solicitud de cargo en este rango horario 98 NCCM Incorrecto 99 Canal de comunicación cerrado Página: 12

13 7.2 Códigos de retorno devueltos por el TPV A continuación se describen los códigos de retorno devueltos por el servicio de TPV de 4B. Código Retorno Descripción EV Los parámetros enviados a la plataforma de pago no son correctos EP Error desconocido de la plataforma de pago EC Error al conectar con TPV TR No recibida respuesta del TPV. Resultado de la operación desconocido AP La aplicación no esta autorizada. 106 Usuario no valido 107 Password errónea 108 No se encontraron los campos solicitados 109 Error en la mascara 110 No se encontraron los datos solicitados 111 Error de formato en los datos recogidos 112 Error de configuración 113 Desatendido 114 Error de datos 300 Request 301 Request Method erróneo 302 El numero de parámetros no es correcto 303 Parametro incorrecto 304 OpenHttpRequest 305 Acceso denegado 306 No se pudo comunicar el resultado al comercio 400 Referencia duplicada 401 Operación origen duplicada 402 Estado incorrecto 403 El código de moneda no es correcto 404 El importe no es correcto 405 El numero de comercio no es correcto 406 Error de puc No se ha validado el hash 408 Error en check 409 No hay comercio host activo 410 El código de comercio no existe Página: 13

14 7.3 Interfaz WSDL de la plataforma de pagos <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace="urn:pagows" xmlns=" xmlns:apachesoap=" xmlns:impl="urn:pagows" xmlns:intf="urn:pagows" xmlns:soapenc=" xmlns:tns1=" xmlns:tns2=" xmlns:tns3=" xmlns:wsdl=" xmlns:wsdlsoap=" xmlns:xsd=" <wsdl:types> <schema targetnamespace="urn:pagows" xmlns=" <import namespace=" /> <import namespace=" /> <import namespace=" /> <import namespace=" /> <complextype name="arrayof_xsd_string"> <complexcontent> <restriction base="soapenc:array"> <attribute ref="soapenc:arraytype" wsdl:arraytype="xsd:string[]" /> </restriction> </complexcontent> <complextype name="arrayof_xsd_int"> <complexcontent> <restriction base="soapenc:array"> <attribute ref="soapenc:arraytype" wsdl:arraytype="xsd:int[]" /> </restriction> </complexcontent> <complextype name="arrayof_tns1_peticioncasilla"> <complexcontent> <restriction base="soapenc:array"> <attribute ref="soapenc:arraytype" wsdl:arraytype="tns1:peticioncasilla[]" /> </restriction> </complexcontent> <complextype name="arrayof_tns1_respuestacasilla"> <complexcontent> <restriction base="soapenc:array"> <attribute ref="soapenc:arraytype" wsdl:arraytype="tns1:respuestacasilla[]" /> </restriction> </complexcontent> <complextype name="arrayof_tns1_entidadfinanciera"> <complexcontent> <restriction base="soapenc:array"> <attribute ref="soapenc:arraytype" wsdl:arraytype="tns1:entidadfinanciera[]" /> </restriction> </complexcontent> </schema> <schema targetnamespace=" xmlns=" <import namespace="urn:pagows" /> <import namespace=" /> <import namespace=" /> <import namespace=" /> <complextype name="resultinfo"> <element name="error" type="xsd:boolean" /> Página: 14

15 <element name="errorpage" nillable="true" <element name="message" nillable="true" <element name="resultinfo" nillable="true" type="tns2:resultinfo" /> <element name="subcode" nillable="true" <complextype name="infoaccessor"> <element name="columsinfoorder" nillable="true" type="impl:arrayof_xsd_string" /> <element name="resultinfo" nillable="true" type="tns2:resultinfo" /> <element name="typesinfoorder" nillable="true" type="impl:arrayof_xsd_int" /> </schema> <schema targetnamespace=" xmlns=" <import namespace="urn:pagows" /> <import namespace=" /> <import namespace=" /> <import namespace=" /> <complextype name="peticioncasilla"> <complexcontent> <extension base="tns2:infoaccessor"> <element name="nombre" nillable="true" <element name="valor" nillable="true" </extension> </complexcontent> <complextype name="peticion"> <element name="fecha" nillable="true" <element name="idaplicacion" nillable="true" <element name="importe" type="xsd:double" /> <element name="justificante" nillable="true" <element name="moneda" nillable="true" <element name="nif" nillable="true" <element name="numerocuenta" nillable="true" <element name="peticioncasilla" nillable="true" type="impl:arrayof_tns1_peticioncasilla" /> <element name="tipopeticion" nillable="true" <complextype name="respuestacasilla"> <complexcontent> <extension base="tns2:infoaccessor"> <element name="nombre" nillable="true" <element name="valor" nillable="true" </extension> </complexcontent> <complextype name="respuesta"> <element name="codigorespuesta" nillable="true" <element name="estadotransaccion" nillable="true" Página: 15

16 <element name="fecha" nillable="true" <element name="importe" type="xsd:double" /> <element name="moneda" nillable="true" <element name="nccm" nillable="true" <element name="numerojustificante" nillable="true" <element name="respuestacasilla" nillable="true" type="impl:arrayof_tns1_respuestacasilla" /> <element name="respuestaconsulta" nillable="true" <element name="tipooperacion" nillable="true" <complextype name="verificacion"> <element name="codentidadfinanciera" nillable="true" <element name="fechaoperacion" nillable="true" <element name="idaplicacion" nillable="true" <element name="importe" type="xsd:double" /> <element name="nif" nillable="true" <element name="nrc" nillable="true" <complextype name="entidadfinanciera"> <element name="codigoentidad" nillable="true" <element name="nombre" nillable="true" </schema> <schema targetnamespace=" xmlns=" <import namespace="urn:pagows" /> <import namespace=" /> <import namespace=" /> <import namespace=" /> <complextype name="peticiontpv"> <element name="pan" nillable="true" <element name="codigovalidacion" nillable="true" <element name="fechacaducidad" nillable="true" <element name="fechaventa" nillable="true" <element name="idaplicacion" nillable="true" <element name="importe" type="xsd:double" /> <element name="referencia" nillable="true" <element name="tipopeticion" nillable="true" <complextype name="respuestatpv"> <element name="codigoretorno" nillable="true" <element name="descripcionerror" nillable="true" <element name="fechaoperacion" nillable="true" </schema> </wsdl:types> <wsdl:message name="serviciotpvresponse"> <wsdl:part name="serviciotpvreturn" type="tns3:respuestatpv" /> </wsdl:message> <wsdl:message name="serviciotpvrequest"> <wsdl:part name="peticion" type="tns3:peticiontpv" /> Página: 16

17 </wsdl:message> <wsdl:message name="pagorequest"> <wsdl:part name="peticionpago" type="tns1:peticion" /> </wsdl:message> <wsdl:message name="listarentidadesrequest"> <wsdl:part name="idaplicacion" </wsdl:message> <wsdl:message name="verificarnrcrequest"> <wsdl:part name="verificacion" type="tns1:verificacion" /> </wsdl:message> <wsdl:message name="listarentidadesresponse"> <wsdl:part name="listarentidadesreturn" type="impl:arrayof_tns1_entidadfinanciera" /> </wsdl:message> <wsdl:message name="verificarnrcresponse"> <wsdl:part name="verificarnrcreturn" type="xsd:boolean" /> </wsdl:message> <wsdl:message name="pagoresponse"> <wsdl:part name="pagoreturn" type="tns1:respuesta" /> </wsdl:message> <wsdl:porttype name="pago"> <wsdl:operation name="pago" parameterorder="peticionpago"> <wsdl:input message="impl:pagorequest" name="pagorequest" /> <wsdl:output message="impl:pagoresponse" name="pagoresponse" /> </wsdl:operation> <wsdl:operation name="verificarnrc" parameterorder="verificacion"> <wsdl:input message="impl:verificarnrcrequest" name="verificarnrcrequest" /> <wsdl:output message="impl:verificarnrcresponse" name="verificarnrcresponse" /> </wsdl:operation> <wsdl:operation name="listarentidades" parameterorder="idaplicacion"> <wsdl:input message="impl:listarentidadesrequest" name="listarentidadesrequest" /> <wsdl:output message="impl:listarentidadesresponse" name="listarentidadesresponse" /> </wsdl:operation> <wsdl:operation name="serviciotpv" parameterorder="peticion"> <wsdl:input message="impl:serviciotpvrequest" name="serviciotpvrequest" /> <wsdl:output message="impl:serviciotpvresponse" name="serviciotpvresponse" /> </wsdl:operation> </wsdl:porttype> <wsdl:binding name="pagosoapbinding" type="impl:pago"> <wsdlsoap:binding style="rpc" transport=" /> <wsdl:operation name="pago"> <wsdlsoap:operation soapaction="" /> <wsdl:input name="pagorequest"> <wsdlsoap:body encodingstyle=" namespace="urn:pagows" use="encoded" /> </wsdl:input> <wsdl:output name="pagoresponse"> <wsdlsoap:body encodingstyle=" namespace="urn:pagows" use="encoded" /> </wsdl:output> </wsdl:operation> <wsdl:operation name="verificarnrc"> <wsdlsoap:operation soapaction="" /> <wsdl:input name="verificarnrcrequest"> <wsdlsoap:body encodingstyle=" namespace="urn:pagows" use="encoded" /> </wsdl:input> <wsdl:output name="verificarnrcresponse"> <wsdlsoap:body encodingstyle=" namespace="urn:pagows" use="encoded" /> </wsdl:output> </wsdl:operation> <wsdl:operation name="listarentidades"> <wsdlsoap:operation soapaction="" /> <wsdl:input name="listarentidadesrequest"> <wsdlsoap:body encodingstyle=" namespace="urn:pagows" use="encoded" /> </wsdl:input> <wsdl:output name="listarentidadesresponse"> <wsdlsoap:body encodingstyle=" namespace="urn:pagows" use="encoded" /> </wsdl:output> </wsdl:operation> <wsdl:operation name="serviciotpv"> Página: 17

18 <wsdlsoap:operation soapaction="" /> <wsdl:input name="serviciotpvrequest"> <wsdlsoap:body encodingstyle=" namespace="urn:pagows" use="encoded" /> </wsdl:input> <wsdl:output name="serviciotpvresponse"> <wsdlsoap:body encodingstyle=" namespace="urn:pagows" use="encoded" /> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="pagoservice"> <wsdl:port binding="impl:pagosoapbinding" name="pago"> <wsdlsoap:address location=" /> </wsdl:port> </wsdl:service> </wsdl:definitions> Página: 18

19 7.4 EJEMPLOS DE MENSAJES SOAP PAGO A CUENTA REQUEST <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <ns1:pago xmlns:ns1="urn:pagows"> <peticionpago href="#id0" /> </ns1:pago> <multiref id="id0" soapenc:root="0" xsi:type="ns2:peticion" xmlns:soapenc=" xmlns:ns2=" <fecha xsi:type="soapenc:string"> </fecha> <idaplicacion xsi:type="soapenc:string">ap001</idaplicacion> <importe xsi:type="soapenc:string">2500</importe> <justificante xsi:type="soapenc:string"> </justificante> <nif xsi:type="soapenc:string"> p</nif> <numerocuenta xsi:type="soapenc:string"> </numeroCuenta> <peticioncasilla soapenc:arraytype="ns2:peticioncasilla[3]" xsi:type="soapenc:array"> <peticioncasilla href="#id1" /> <peticioncasilla href="#id2" /> <peticioncasilla href="#id3" /> </peticioncasilla> <multiref id="id1" soapenc:root="0" xsi:type="ns3:peticioncasilla" xmlns:ns3=" xmlns:soapenc=" <nombre xsi:type="soapenc:string">moneda</nombre> <resultinfo xsi:type="ns4:resultinfo" xsi:nil="true" xmlns:ns4=" /> <valor xsi:type="soapenc:string">eur</valor> <multiref id="id2" soapenc:root="0" xsi:type="ns5:peticioncasilla" xmlns:ns5=" xmlns:soapenc=" <nombre xsi:type="soapenc:string">mac</nombre> <resultinfo xsi:type="ns6:resultinfo" xsi:nil="true" xmlns:ns6=" /> <valor xsi:type="soapenc:string" xsi:nil="true" /> <multiref id="id3" soapenc:root="0" xsi:type="ns7:peticioncasilla" xmlns:ns7=" xmlns:soapenc=" <nombre xsi:type="soapenc:string">tipo_peticion</nombre> <resultinfo xsi:type="ns8:resultinfo" xsi:nil="true" xmlns:ns8=" /> <valor xsi:type="soapenc:string">0</valor> </soapenv:body> </soapenv:envelope> Página: 19

20 RESPONSE <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <ns1:pagoresponse xmlns:ns1="urn:pagows"> <pagoreturn href="#id0" /> </ns1:pagoresponse> <multiref id="id0" soapenc:root="0" xsi:type="ns2:respuesta" xmlns:soapenc=" xmlns:ns2=" <codigorespuesta xsi:type="xsd:string">ok</codigorespuesta> <estadotransaccion xsi:type="xsd:string"> 0</estadoTransaccion> <fecha xsi:type="xsd:string"> </fecha> <importe xsi:type="xsd:string"> </importe> <moneda xsi:type="xsd:string">eur</moneda> <nccm xsi:type="xsd:string">c7ecb2cc</nccm> <numerojustificante xsi:type="xsd:string"> </numeroJustificante> <respuestacasilla xsi:type="ns3:arrayof_tns1_respuestacasilla" xsi:nil="true" xmlns:ns3="urn:pagows" /> <respuestaconsulta xsi:type="xsd:string"> 0</respuestaConsulta> <tipooperacion xsi:type="xsd:string">0</tipooperacion> </soapenv:body> </soapenv:envelope> Página: 20

21 7.4.2 CONSULTA A CUENTA REQUEST <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <ns1:pago xmlns:ns1="urn:pagows"> <peticionpago href="#id0" /> </ns1:pago> <multiref id="id0" soapenc:root="0" xsi:type="ns2:peticion" xmlns:soapenc=" xmlns:ns2=" <fecha xsi:type="soapenc:string"> </fecha> <idaplicacion xsi:type="soapenc:string">ap001</idaplicacion> <importe xsi:type="soapenc:string">2500</importe> <justificante xsi:type="soapenc:string"> </justificante> <nif xsi:type="soapenc:string"> p</nif> <numerocuenta xsi:type="soapenc:string"> </numeroCuenta> <peticioncasilla soapenc:arraytype="ns2:peticioncasilla[3]" xsi:type="soapenc:array"> <peticioncasilla href="#id1" /> <peticioncasilla href="#id2" /> <peticioncasilla href="#id3" /> </peticioncasilla> <multiref id="id1" soapenc:root="0" xsi:type="ns3:peticioncasilla" xmlns:ns3=" xmlns:soapenc=" <nombre xsi:type="soapenc:string">moneda</nombre> <resultinfo xsi:type="ns4:resultinfo" xsi:nil="true" xmlns:ns4=" /> <valor xsi:type="soapenc:string">eur</valor> <multiref id="id2" soapenc:root="0" xsi:type="ns5:peticioncasilla" xmlns:ns5=" xmlns:soapenc=" <nombre xsi:type="soapenc:string">mac</nombre> <resultinfo xsi:type="ns6:resultinfo" xsi:nil="true" xmlns:ns6=" /> <valor xsi:type="soapenc:string" xsi:nil="true" /> <multiref id="id3" soapenc:root="0" xsi:type="ns7:peticioncasilla" xmlns:ns7=" xmlns:soapenc=" <nombre xsi:type="soapenc:string">tipo_peticion</nombre> <resultinfo xsi:type="ns8:resultinfo" xsi:nil="true" xmlns:ns8=" /> <valor xsi:type="soapenc:string">1</valor> </soapenv:body> </soapenv:envelope> Página: 21

22 RESPONSE <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <ns1:pagoresponse xmlns:ns1="urn:pagows"> <pagoreturn href="#id0" /> </ns1:pagoresponse> <multiref id="id0" soapenc:root="0" xsi:type="ns2:respuesta" xmlns:soapenc=" xmlns:ns2=" <codigorespuesta xsi:type="xsd:string">ok</codigorespuesta> <estadotransaccion xsi:type="xsd:string"> 0</estadoTransaccion> <fecha xsi:type="xsd:string"> </fecha> <importe xsi:type="xsd:string"> </importe> <moneda xsi:type="xsd:string">eur</moneda> <nccm xsi:type="xsd:string">c7ecb2cc</nccm> <numerojustificante xsi:type="xsd:string"> </numeroJustificante> <respuestacasilla xsi:type="ns3:arrayof_tns1_respuestacasilla" xsi:nil="true" xmlns:ns3="urn:pagows" /> <respuestaconsulta xsi:type="xsd:string"> 1</respuestaConsulta> <tipooperacion xsi:type="xsd:string">1</tipooperacion> </soapenv:body> </soapenv:envelope> Página: 22

23 7.4.3 CANCELACIÓN A CUENTA REQUEST <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <ns1:pago xmlns:ns1="urn:pagows"> <peticionpago href="#id0" /> </ns1:pago> <multiref id="id0" soapenc:root="0" xsi:type="ns2:peticion" xmlns:soapenc=" xmlns:ns2=" <fecha xsi:type="soapenc:string"> </fecha> <idaplicacion xsi:type="soapenc:string">ap001</idaplicacion> <importe xsi:type="soapenc:string">2500</importe> <justificante xsi:type="soapenc:string"> </justificante> <nif xsi:type="soapenc:string"> p</nif> <numerocuenta xsi:type="soapenc:string"> </numeroCuenta> <peticioncasilla soapenc:arraytype="ns2:peticioncasilla[3]" xsi:type="soapenc:array"> <peticioncasilla href="#id1" /> <peticioncasilla href="#id2" /> <peticioncasilla href="#id3" /> </peticioncasilla> <multiref id="id1" soapenc:root="0" xsi:type="ns3:peticioncasilla" xmlns:ns3=" xmlns:soapenc=" <nombre xsi:type="soapenc:string">moneda</nombre> <resultinfo xsi:type="ns4:resultinfo" xsi:nil="true" xmlns:ns4=" /> <valor xsi:type="soapenc:string">eur</valor> <multiref id="id2" soapenc:root="0" xsi:type="ns5:peticioncasilla" xmlns:ns5=" xmlns:soapenc=" <nombre xsi:type="soapenc:string">mac</nombre> <resultinfo xsi:type="ns6:resultinfo" xsi:nil="true" xmlns:ns6=" /> <valor xsi:type="soapenc:string" xsi:nil="true" /> <multiref id="id3" soapenc:root="0" xsi:type="ns7:peticioncasilla" xmlns:ns7=" xmlns:soapenc=" <nombre xsi:type="soapenc:string">tipo_peticion</nombre> <resultinfo xsi:type="ns8:resultinfo" xsi:nil="true" xmlns:ns8=" /> <valor xsi:type="soapenc:string">3</valor> </soapenv:body> </soapenv:envelope> Página: 23

24 RESPONSE <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <ns1:pagoresponse xmlns:ns1="urn:pagows"> <pagoreturn href="#id0" /> </ns1:pagoresponse> <multiref id="id0" soapenc:root="0" xsi:type="ns2:respuesta" xmlns:soapenc=" xmlns:ns2=" <codigorespuesta xsi:type="xsd:string">ok</codigorespuesta> <estadotransaccion xsi:type="xsd:string"> 0</estadoTransaccion> <fecha xsi:type="xsd:string"> </fecha> <importe xsi:type="xsd:string"> </importe> <moneda xsi:type="xsd:string">eur</moneda> <nccm xsi:type="xsd:string">c7ecb2cc</nccm> <numerojustificante xsi:type="xsd:string"> </numeroJustificante> <respuestacasilla xsi:type="ns3:arrayof_tns1_respuestacasilla" xsi:nil="true" xmlns:ns3="urn:pagows" /> <respuestaconsulta xsi:type="xsd:string"> 0</respuestaConsulta> <tipooperacion xsi:type="xsd:string">3</tipooperacion> </soapenv:body> </soapenv:envelope> Página: 24

25 7.4.4 PAGO CON TARJETA (Servicio TPV) REQUEST <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <ns1:serviciotpv xmlns:ns1="urn:pagows"> <peticion href="#id0" /> </ns1:serviciotpv> <multiref id="id0" soapenc:root="0" xsi:type="ns2:peticiontpv" xmlns:soapenc=" xmlns:ns2=" <NIF xsi:type="soapenc:string"> t</nif> <PAN xsi:type="soapenc:string">12345</pan> <codigovalidacion xsi:type="soapenc:string"> 111</codigoValidacion> <fechacaducidad xsi:type="soapenc:string"> 0612</fechaCaducidad> <fechaventa xsi:type="soapenc:string"> </fechaventa> <idaplicacion xsi:type="soapenc:string">ap001</idaplicacion> <importe xsi:type="soapenc:string">75,00</importe> <referencia xsi:type="soapenc:string"> </referencia> <tipopeticion xsi:type="soapenc:string">0</tipopeticion> </soapenv:body> </soapenv:envelope> RESPONSE <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <ns1:serviciotpvresponse xmlns:ns1="urn:pagows"> <serviciotpvreturn href="#id0" /> </ns1:serviciotpvresponse> <multiref id="id0" soapenc:root="0" xsi:type="ns2:respuestatpv" xmlns:soapenc=" xmlns:ns2=" <codigoretorno xsi:type="xsd:string">00</codigoretorno> <descripcionerror xsi:type="xsd:string" xsi:nil="true" /> <fechaoperacion xsi:type="xsd:string" xsi:nil="true"> </fechaoperacion> </soapenv:body> </soapenv:envelope> Página: 25

26 7.4.5 CANCELACIÓN CON TARJETA (Servicio TPV) REQUEST <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <ns1:serviciotpv xmlns:ns1="urn:pagows"> <peticion href="#id0" /> </ns1:serviciotpv> <multiref id="id0" soapenc:root="0" xsi:type="ns2:peticiontpv" xmlns:soapenc=" xmlns:ns2=" <NIF xsi:type="soapenc:string"> t</nif> <PAN xsi:type="soapenc:string">12345</pan> <codigovalidacion xsi:type="soapenc:string"> 111</codigoValidacion> <fechacaducidad xsi:type="soapenc:string"> 0612</fechaCaducidad> <fechaventa xsi:type="soapenc:string"> </fechaventa> <idaplicacion xsi:type="soapenc:string">ap001</idaplicacion> <importe xsi:type="soapenc:string">75,00</importe> <referencia xsi:type="soapenc:string"> </referencia> <tipopeticion xsi:type="soapenc:string">3</tipopeticion> </soapenv:body> </soapenv:envelope> RESPONSE <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <ns1:serviciotpvresponse xmlns:ns1="urn:pagows"> <serviciotpvreturn href="#id0" /> </ns1:serviciotpvresponse> <multiref id="id0" soapenc:root="0" xsi:type="ns2:respuestatpv" xmlns:soapenc=" xmlns:ns2=" <codigoretorno xsi:type="xsd:string">00</codigoretorno> <descripcionerror xsi:type="xsd:string" xsi:nil="true" /> <fechaoperacion xsi:type="xsd:string" xsi:nil="true"> </fechaoperacion> </soapenv:body> </soapenv:envelope> Página: 26