Kit de integración
Botón de pago
Premisas:
1. Servicio tipo REST. El formato de solicitud y respuesta es JSON.
2. URL ambiente te de pruebas: https://pre.irecaudocoe.transfiriendo.com:456/ApiIRecaudo/api/Pago/Procesar
3. URL ambiente de producción: https://irecaudocoe.transfiriendo.com:444/ApiIRecaudo/api/Pago/Procesar
4. La comunicación se debe realizar sobre un canal seguro utilizando protocolo HTTPS.
Prerrequisitos:
Para la configuración del respectivo ambiente, el comercio debe entregar la siguiente información:
Definiciones:
Comercio: Sistema externo que se integra con iRecaudo express para hacer uso del botón de pago.
Usuario: Quien hace uso de la pasarela de pagos/botón de pago y ejecuta un pago.
Código de convenio: Es un código único asignado por las diferentes entidades procesadoras de pagos a un comercio, este varía de acuerdo al medio de pago.
Procesador de pago: Entidad encargada de trasmitir los datos de una transacción entre el banco emisor del usuario y el banco adquiriente del comercio.
Identificador compañía: Es un identificador único asignado por Transfiriendo a una compañía para la conexión y consumo de los servicios del botón de pagos.
Multicash: Estructura que reúne los datos de una transacción aprobada y que se entrega a una compañía para realizar tratamientos posteriores.
URL notification de pago: URL del comercio adonde se enviará la notificación de un pago aprobado (multicash).
URL origen: URL del comercio desde donde se hace la petición de la API para hacer uso del botón de pago.
URL retorno: Dirección web del comercio a la cual será redireccionado un usuario al terminar la transacción.
Integración:
1. Headers
RequestVerificationSource = SrcRefM
RequestVerificationToken = YNBNYUKJGHJ122: TDBHYTRNTBVW684vt
2. Body
Solicitud formato JSON.
3. Método de consumo
POST
Campos Request:
Estructura Request:
Ejemplo 1
{
«ProcesarReferenciasRq»: {
«PersonaDeudora»: {
«Nombre»: «Ernesto Perez»,
«TipoIdentificacion»: 1,
«NumeroIdentificacion»: «2000000000618»,
«Email»: «eperez@gmail.com»
},
«ClaveControl»: «504A9DB96B610031C01DBEE84E48631CFF490BF9»,
«IdentificadorCompania»: «SEPPRUEBAS»,
«Referencias»: [
{
«Cabecera»: {
«NumeroReferencia»: «22070701100000»,
«NumeroReferenciaAuxiliar»: «22070701100000»,
«NumeroReferenciaOrigen»: «220707011»,
«Moneda»: «COP»,
«ImporteTotal»: 9000,
«ImporteSubtotal»: 8500,
«ImporteIva»: 500,
«FechaEmision»: «2023-01-05»,
«FechaVencimiento»: «2023-10-06»
}
}
],
«Extras»: {
«Ref1»: «02»,
«Ref2»: «860.009.578-6»,
«Ref3»: «900.382.405-2»,
«Ref4»: «AGENCIA DE SEGUROS MILENIO- API|121962404»,
«Ref5»: «GHY999|||46135|1152436021»
}
}
}
Ejemplo 2
{
«ProcesarReferenciasRq»: {
«PersonaDeudora»: {
«Nombre»: «Ernesto Perez»,
«TipoIdentificacion»: 1,
«NumeroIdentificacion»: «2000000000617»,
«Email»: «eperez@gmail.com»,
«TelefonoMovil»: «3004471608»,
«TelefonoFijo»: «3004471608»,
«Pais»: «Colombia»,
«Provincia»: «ANTIOQUIA»,
«Ciudad»: «MEDELLIN»,
«Direccion»: «CALLE 7 NUMERO 80 75 MEDELLIN»
},
«ClaveControl»: «504A9DB96B610031C01DBEE84E48631CFF490BF9»,
«IdentificadorCompania»: «SEPPRUEBAS»,
«TransaccionId»: 338109,
«Referencias»: [
{
«Cabecera»: {
«NumeroReferencia»: «220707013123456»,
«NumeroReferenciaAuxiliar»: «220707013123456»,
«NumeroReferenciaOrigen»: «2207070131»,
«Moneda»: «COP»,
«ImporteTotal»: 897801,
«ImporteSubtotal»: 897801,
«ImporteIva»: 0
},
«Detalle»: {
«Item»: [
{
«Codigo»: 120,
«Descripcion»: » POESÍA RÚSTICA Y POESÍA ROMÁNTICA»,
«Cantidad»: 1,
«ImporteUnitario»: 448900,
«ImporteTotal»: 448900,
«ImporteSubtotal»: 448900,
«ImporteIva»: 0
},
{
«Codigo»: 121,
«Descripcion»: «Luna de arena»,
«Cantidad»: 1,
«ImporteUnitario»: 448901,
«ImporteTotal»: 448901,
«ImporteSubtotal»: 448901,
«ImporteIva»: 0
}
]
}
}
]
}
}
Response
{
«Url»: «https://pre.irecaudocoe.transfiriendo.com:456/irecaudocoe/Post/ProcesarPago.aspx?input=d2b3ee6e-1fce-4b71-a598-95e90ecee291»,
«Identificador»: «d2b3ee6e-1fce-4b71-a598-95e90ecee291»,
«Resultado»: true,
«MensajeError»: null
}
Se debe tomar la «Url»: Esta URL realizara la apertura de la pasarela de pagos y mostrara los diferentes medios de pago a un usuario para realizar su compra.
