Kit de integración de pasarela
iRecaudo pasarela de pagos
A continuación encontrarás los lineamientos y condiciones iniciales que debes cumplir en tu empresa,
para empezar a vivir la experiencia de recaudar por medio de nuestra pasarela de pagos.
Requisitos previos:
Seguridad
Todas las direcciones web (urls) deben tener implementado un certificado HTTPS, para transmitir y gestionar, de forma segura los datos de clientes o información sensible. A continuación adjunto las características requeridas para la comunicación por medio de certificado:
Certificado SSL EV Premium expedido por una entidad autorizada
Validación sobre el nombre del dominio y la empresa
Sello de confianza
Candado en la barra de dirección
La información que se intercambia debe ir cifrada con algoritmo mínimo AES256
Ambiente de Pre-Producción
Logo del intermediario
URL desde donde se va a invocar a la pasarela
URL a donde se debe de volver al finalizar el pago
URL donde se recibirá la confirmación de pago (multicash) en caso de querer recibirlo por post, en caso de querer recibirlo por colas de mensajería (MSMQ) dirección pública y cola de mensajería a la que se enviara el mensaje de confirmación de pago (multicash)
Salida a Producción
Logo del intermediario
URL desde donde se va a invocar a la pasarela
URL a donde se debe de volver al finalizar el pago
URL donde se recibirá la confirmación de pago (multicash)
Código de servicio PSE. En caso de que el intermediario vaya a utilizar este medio de pago se hace necesario la creación de un código de servicio
Que medios de pago va a tener activos el intermediario
Proceso de integración:
1. Para la integración del botón de pagos de Irecaudo Express en el sitio web del comercio debe realizar el llamado a la pasarela desde su página web.
2. El Intermediario realizará la integración con la pasarela consumiendo un Web Service llamado ProcesarReferenciasCoe ubicado en la siguiente URL dependiendo del ambiente:
[Web Service Pruebas](Web service https://pre.irecaudocoe.transfiriendo.com:456/Irecaudocoe/WebServices/Public/PublicServices.asmx
[Web Service Producción](https://www.irecaudocoe.transfiriendo.com:444/Irecaudocoe/WebServices/Publi c/PublicServices.asmx)
3. El comercio debe enviar la estructura de datos xml ProcesarReferenciasRq.
4. Por seguridad de cada transacción, adicional al xml se debe enviar un HASH formado por el IdentificadorCompania (Este valor se entrega por transfiriendo después de realizar la configuración según lo enviado en el Excel “Formato Creación Comercio IRecaudo Express.xls”) más uno, utilizando el algoritmo de SHA1 para encriptarlo. El valor debe de enviarse en el parámetro pClaveControl.
5. El comercio recibirá una respuesta en el xml ProcesarReferenciasRS cuya estructura se encuentra en el archivo adjunto ProcesarReferenciasRS, de esta respuesta se debe extraer el valor de la variable IdentificadorTransaccion y redireccionarlo a la siguiente Url en el valor input:
[Pruebas](https://pre.irecaudocoe.transfiriendo.com:456/IRecaudoCoe/WebForms/Pago/V iews/GenerarTransaccion.aspx?input=)
[Producción](https://www.irecaudocoe.transfiriendo.com:444/IRecaudoCoe/WebForms/Pago/ Views/GenerarTransaccion.aspx?input=)
6. El Intermediario debe enviar el IdentificadorCompania creado y acordado con Transfiriendo S.A.
7. El Intermediario recibirá un mensaje xml (multicash) por cada uno de las transacciones exitosas realizadas a través de la pasarela.
Instructivo levantamiento (ambiente pre-pro):
<ProcesarReferenciasRq>
<PersonaDeudora>
<Nombre>jose luis guerrero</Nombre>
<TipoIdentificacion>1</TipoIdentificacion>
<NumeroIdentificacion>11206157</NumeroIdentificacion>
<Email>joselnandez@hotmail.com</Email>
<TelefonoMovil>1111111111</TelefonoMovil>
<TelefonoFijo>1111111111</TelefonoFijo>
<Pais>Colombia</Pais>
<Provincia>ANTIOQUIA</Provincia>
<Ciudad>ABEJORRAL</Ciudad>
<Direccion>ddddd</Direccion>
</PersonaDeudora>
<IdentificadorCompania>XXXXXXXXX</IdentificadorCompania>
<TransaccionId>80</TransaccionId>
<Referencias>
<Referencia>
<Cabecera>
<NumeroReferencia>PLACA – 120002639</NumeroReferencia>
<NumeroReferenciaAuxiliar>120002639</NumeroReferenciaAuxiliar>
<NumeroReferenciaOrigen>120002639</NumeroReferenciaOrigen>
<Moneda>COP</Moneda>
<ImporteTotal>300150</ImporteTotal>
<ImporteSubtotal>300150</ImporteSubtotal>
<ImporteIva>0</ImporteIva>
<FechaEmision>2020-08-07</FechaEmision> —-Fecha Emisión del Presupuesto
<FechaVencimiento>2020-08-08</FechaVencimiento> — Este campo es la fecha de vencimiento del presupuesto, deber ser la fecha de inicio de vigencia de la póliza MENOS un día ( FromValidateDate – 1 dia )Nota: Esta fecha no se debe ingresar con horas.
</Cabecera>
</Referencia>
</Referencias>
<Extras>
<Ref2>NIT de la aseguradora</Ref2>
<Ref3>NIT Del intermediario</Ref3>
<Ref4>NombreDelCanal|NumeroDePresupuesto</Ref4>Separados por el símbolo | <Ref5>PLACA|||EntityID|Documentodeltomador</Ref5>ver abajo explicación de este campo </Extras>
</ProcesarReferenciasRq>
CAMPO <Ref5> DENTRO DEL NODO <Extras> Este campo debe ser diligenciado con la siguiente estructura:
PLACA: Numero de placa del vehículo.
EntityID: Es el número que identifica el canal del intermediario, Este dato es brindado por TRANSFIRIENDO.
Documento del tomador: Es el documento de identificación del tomador del SOAT.
Tener en cuenta que deben ser separados con el símbolo |, en la misma cantidad y secuencia que se muestra en el ejemplo expuesto en este documento, se documenta como debería estar diligenciado este campo REF5 para este ejemplo:
<Extras>
<Ref5>PLACA|||28781|11206157</Ref5>
</Extras>
En el campo pClaveControl introducimos una cadena formada por el campo identificador compañía (Comercio) más el numero uno encriptado en SHA1. Ejemplo
Accedemos a la página http://www.sha1-online.com/
En esta página introduciendo la cadena antes mencionada obtendremos el hash
Si el identificador de compañía fuese ESTADO obtendríamos el Hash de la imagen. Este Hash es el que debemos de pegar en el campo pClaveControl.
GenerarTransaccion.aspx?input=
GenerarTransaccion.aspx?input=22a5efb0-ef58-4caf-b5ee-b780c254f564
Como se observa la pasarela de pagos es abierta y precedernos a pagar el presupuesto que generamos previamente mediante API con el método Newinsurancepolicybudget.
Multicash
Cuando se realiza una transacción exitosa en la pasarela de pagos, el sistema envía un multicash a la URL Multicash que fue asignada al comercio del intermediario por su solicitud.
La URL Multicash se diligencia en el Excel llamado “Formato de creación de comercio”, esta URL debe cumplir los requisitos de seguridad mínimos como certificado TLS 1.2 y los menores a 1.2 desactivados ya que para el proceso debe ser configurada en el Firewall de Transfiriendo, si se desea configurar una URL de pruebas se podrá usar un certificado gratuito como los que otorga la página https://letsencrypt.org/es/
Tráfico Multicash hacia la URL del Intermediario
Ambiente de Pruebas
El envió del multicash se realiza por el puerto 456 desde el servidor de recaudo con IP Publica 190.131.251.170, por favor verificar que el trafico pueda lograrse de parte del servidor del intermediarioAmbiente de Producción
El envió se realiza por el puerto 443 desde dos posibles IP publicas las cuales pertenecen al servidor de producción 190.216.197.208, 190.131.238.80 por favor confirmar que desde el servidor del intermediario se permita el tráfico.Formato de Envió
El multicash se envía en el siguiente formato, así que la URL que se configure por parte del intermediario debe estar preparada para recibirse de esta manera:Tipo = «application/x-www-form-urlencoded»
Key = «multicash»
Se replica en POSTMAN un envió multicash:
Cuerpo del Multicash
El cuerpo del multicash está formado por una estructura que contiene los datos de la transacción realizada, el intermediario podrá realizar una traza basado en el campo llamado “IdentificadorDocRecaudo” que es el mismo “Numero de presupuesto” que responde el método Newinsurancepolicybudget, y se llama “Numero de referencia origen” en el método para levantar la pasarela de pagos ProcesarReferencias
Información relativa a la boleta de pago y al emisor de esta. Los datos del emisor serán los mismos que se recibieron en el ProcesarReferenciasRQ. Los posibles canales de pago son: CB – Credibanco, BB – Banco De Bogotá, BC – Bancolombia, ATH-ATH, PSEPSE. Información
<Multicash>
<BoletaPago>
<NumeroReferencia>20000015430157</NumeroReferencia>
<FechaEmision>2020-05-05T00:00:00</FechaEmision>
<FechaVencimiento>2020-05-07T00:00:00</FechaVencimiento>
<FechaPago>2020-05-05T00:00:00-05:00</FechaPago>
<ImporteTotal>483950.00</ImporteTotal>
<ImporteNeto>483950.00</ImporteNeto>
<ImporteImpuesto>0.00</ImporteImpuesto>
<CanalPago>PSE</CanalPago>
<Emisor>
<TipoIdentificacion>1</TipoIdentificacion>
<NumeroIdentificacion>114310000</NumeroIdentificacion>
<Nombre>PRUEBA+PRUEBA%2c+LUIS+PRUEBA</Nombre>
<Email>PRUEBA.costa01@gmail.com</Email>
<TelefonoFijo>3148300000</TelefonoFijo>
<TelefonoMovil>3148300000</TelefonoMovil>
<Direccion>Avenida+78+90+65+78+76+56+78+90</Direccion>
</Emisor>
<TotalDocumentos>1</TotalDocumentos>
<CodigoCompania>900928596</CodigoCompania>
</BoletaPago>
Información relativa al pago en el caso del pago con Tarjeta de crédito llevara información relativa a este (Numero recibo, cuotas, franquicia, terminal…) En el campo medio de pago los valores será TC (Tarjeta Crédito) o EF (efectivo)
<Banco>
<CodigoBanco>5</CodigoBanco>
<NumeroCuenta>247</NumeroCuenta>
</Banco>
<DetallePago>
<Pago>
<Importe>483950.00</Importe>
<Banco>BANCOLOMBIA</Banco>
</Pago>
</DetallePago>
Información relativa al documento recaudado, en el campo IdentificadorDocRecaudado se devuelve el valor recibido en el campo NumeroReferenciaOrigen del ProcesarReferenciaRQ
<Documentos>
<Documento>
<IdentificadorDocRecaudado>120824233</IdentificadorDocRecaudado>
<ImporteRecaudado>483950.00</ImporteRecaudado>
<SaldoDocRecaudado>0.00</SaldoDocRecaudado>
</Documento>
En el campo TransaccionId se devuelve el valor recibido en el campo TransaccionId del ProcesarReferenciaRQ
</Documento>
</Documentos>
<TransaccionId>12082423308265</TransaccionId>
<Suscripcion>
<Cobro>
Después de ver la información por explicada por parte , relacionamos el detalle completo del cuerpo del Multicash
<Multicash>
<BoletaPago>
<NumeroReferencia>20000015430157</NumeroReferencia>
<FechaEmision>2020-05-05T00:00:00</FechaEmision>
<FechaVencimiento>2020-05-07T00:00:00</FechaVencimiento>
<FechaPago>2020-05-05T00:00:00-05:00</FechaPago>
<ImporteTotal>483950.00</ImporteTotal>
<ImporteNeto>483950.00</ImporteNeto>
<ImporteImpuesto>0.00</ImporteImpuesto>
<CanalPago>PSE</CanalPago>
<Emisor>
<TipoIdentificacion>1</TipoIdentificacion>
<NumeroIdentificacion>114310000</NumeroIdentificacion>
<Nombre>PRUEBA+PRUEBA%2c+LUIS+PRUEBA</Nombre>
<Email>PRUEBA.costa01@gmail.com</Email>
<TelefonoFijo>3148300000</TelefonoFijo>
<TelefonoMovil>3148300000</TelefonoMovil>
<Direccion>Avenida+78+90+65+78+76+56+78+90</Direccion>
</Emisor>
<TotalDocumentos>1</TotalDocumentos>
<CodigoCompania>900928596</CodigoCompania>
</BoletaPago>
<Banco>
<CodigoBanco>5</CodigoBanco>
<NumeroCuenta>247</NumeroCuenta>
</Banco>
<DetallePago>
<Pago>
<Importe>483950.00</Importe>
<Banco>BANCOLOMBIA</Banco>
</Pago>
</DetallePago>
<Documentos>
<Documento>
<IdentificadorDocRecaudado>120824233</IdentificadorDocRecaudado>
<ImporteRecaudado>483950.00</ImporteRecaudado>
<SaldoDocRecaudado>0.00</SaldoDocRecaudado>
</Documento>
</Documentos>
<TransaccionId>12082423308265</TransaccionId>
<Suscripcion>
<Cobro>
<NumeroCobro>0</NumeroCobro>
</Cobro>
</Suscripcion>
</Multicash>
Procesar referencias RS
A continuación, se detallan los campos de la estructura xml del esquema Response ProcesarReferenciasRS
Ver tablas:
ProcesarReferenciasRS
Ver información de las 2 tablas ProcesarReferenciasRS y ResultadoProceso a continuación:
ProcesarReferenciasRS
ResultadoProceso
Código ejemplo
<string xmlns=»http://tempuri.org/»>
<ProcesarReferenciasRs>
<IdentificadorCompania>XXXXXXXX</IdentificadorCompania>
<IdentificadorTransaccion>d70ac45c-c5d6-48e7-bd2e-83b87068f9ba</IdentificadorTransaccion>
<TransaccionId>2543</TransaccionId> <ResultadoProceso> <Resultado>OK</Resultado> </ResultadoProceso>
</ProcesarReferenciasRs>
</string>
Procesar referencias RQ
Ver información de las 4 tablas
ProcesarReferenciasRQ
Persona Deudora
Referencias
Cabecera
a continuación:
Ejemplo del Esquema Básico
<ProcesarReferenciasRq>
<PersonaDeudora>
<Nombre>Andrea Jimenez</Nombre>
<TipoIdentificacion>1</TipoIdentificacion>
<NumeroIdentificacion>12345678</NumeroIdentificacion>
<Email>prueba@prueba.com</Email>
<TelefonoMovil>3517508615</TelefonoMovil>
<TelefonoFijo>03543486521</TelefonoFijo>
<Pais>Colombia</Pais>
<Provincia>Cundinamarca</Provincia>
<Ciudad>Bogotá</Ciudad>
<Direccion>Calle 98 # 22 64</Direccion>
</PersonaDeudora>
<IdentificadorCompania>XXXX</IdentificadorCompania>
<TransaccionId>53456532159</TransaccionId>
<Referencias>
<Referencia>
<Cabecera>
<NumeroReferencia>PLACA – 1233371234403</NumeroReferencia>
<NumeroReferenciaAuxiliar>53456532159</NumeroReferenciaAuxiliar>
<NumeroReferenciaOrigen>1233371234403</NumeroReferenciaOrigen>
<Moneda>COP</Moneda>
<ImporteTotal>450000</ImporteTotal>
<ImporteSubtotal>450000</ImporteSubtotal>
<ImporteIva>0</ImporteIva>
<FechaEmision>2017-12-20</FechaEmision>
<FechaVencimiento>2017-12-20</FechaVencimiento>
</Cabecera>
</Referencia>
</Referencias>
<Extras>
<Ref2>NIT de la aseguradora</Ref2>
<Ref3>NIT Del intermediario</Ref3>
<Ref4>NombreDelCanal|NumeroDePresupuesto</Ref4>Separados por el símbolo |
<Ref5>Placa|||EntityID|DocumentoTomador</Ref5> Ver explicación abajo.
</Extras>
</ProcesarReferenciasRq>
CAMPO <Ref5> DENTRO DEL NODO <Extras> Este campo debe ser diligenciado con la siguiente estructura:
PLACA: Numero de placa del vehículo.
EntityID: Es el número que identifica el canal del intermediario, Este dato es brindado por TRANSFIRIENDO.
Documento del tomador: Es el documento de identificación del tomador del SOAT.
Tener en cuenta que deben ser separados con el símbolo |, en la misma cantidad y secuencia que se muestra en el ejemplo expuesto en este documento, se documenta como debería estar diligenciado este campo REF5 para este ejemplo:
<Extras>
<Ref5>PLACA|||28786|12345678</Ref5>
</Extras>
<ProcesarReferenciasRq>
<PersonaDeudora>
<Nombre>PRUEBA PRUEBA, DUMAR CAMILO</Nombre>
<TipoIdentificacion>1</TipoIdentificacion>
<NumeroIdentificacion>1090391400</NumeroIdentificacion>
<Email>dojeda@pruebatransfiriendo.com</Email>
</PersonaDeudora>
<IdentificadorCompania>FUTURO</IdentificadorCompania>
<Referencias>
<Referencia>
<Cabecera>
<NumeroReferencia>RAR752-120381474</NumeroReferencia>
<NumeroReferenciaOrigen>120381474</NumeroReferenciaOrigen>
<Moneda>COP</Moneda>
<ImporteTotal>485300</ImporteTotal>
<ImporteSubtotal>485300</ImporteSubtotal>
<FechaEmision>2021-02-24</FechaEmision>
<FechaVencimiento>2021-02-29</FechaVencimiento>
</Cabecera>
</Referencia>
</Referencias>
<Extras>
<Ref1>02</Ref1>
<Ref2>860.000.000-6</Ref2>
<Ref3>17583102</Ref3>
<Ref4>MISOAT API|120381474</Ref4>
<Ref5>RAR752|||46977|1090391400</Ref5>
</Extras>
</ProcesarReferenciasRq>
