Servicio con el que se autorizan pagos a comercios electrónicos.
\nConoce los métodos que componen nuestra Api. Encontrarás los url para realizar las peticiones así como objetos de ejemplo de las respuestas que arrojan las mismas.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Visión general","slug":"vision-general"}],"owner":"23560658","collectionId":"455dfd29-7fed-4971-8d8c-bb1971fb0123","publishedId":"2s83tCLtGR","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"101c85"},"publishDate":"2022-09-30T20:49:56.000Z"},"item":[{"name":"Registra una transacción","id":"8c441e42-da91-47af-a0ef-975457119a79","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"//Objeto de ejemplo.\r\n\r\n{\r\n \"country\":343,\r\n \"client\":\"811021438\",\r\n \"ComercioHGIpay\":\"b17c0b9f-5d37-4a8c-a92a-df97affe0cf7\",\r\n \"type_person\":\"0\",\r\n \"payment_identifier\":\"b302d9b5-e552-41f4-be29-eec7cdeb6134\",\r\n \"id\":\"11111111\",\r\n \"name\":\"HGI SAS\", \r\n \"user_id\":\"NIT\", \r\n \"document\":25,\r\n \"email\":\"info@hgi.com.co\",\r\n \"mobile_phone\":\"3053954360\",\r\n \"datakey\":\"b4eaf884b20d86e8d74ca2cc855f8397455727bac0f28285523f771ece6419d815407da438dee0e83c36d304fc68a65d470c3ec3dcdac893d35c922820d37c59\", \r\n \"reference_number1\":\"Pago desde HGIPay\",\r\n \"reference_number2\":\"Referencia 2\",\r\n \"reference_number3\":\"Referencia 3\",\r\n \"money\":\"COP\",\r\n \"amount\":\"250\",\r\n \"description\":\"Prueba HGI SAS\",\r\n \"language\":\"es\", \r\n \"method\":\"0\",\r\n \"iva\":\"0.00\",\r\n \"url_confirmation\":\"https://hgipay.co/\",\r\n \"url_response\":\"https://hgipay.co/\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pruebas.hgipay.co/api/transactions/v1/registrar","description":"Con esta petición se registran las transacciones que se realizen por medio de HGIPay.
\n","urlObject":{"protocol":"https","path":["api","transactions","v1","registrar"],"host":["pruebas","hgipay","co"],"query":[],"variable":[]}},"response":[{"id":"012460a7-70d4-440e-bcb3-eedd75684e85","name":"Transacción registrada exitosamente","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"//Objeto de ejemplo.\r\n\r\n{\r\n //País.\r\n //Tipo: public int.\r\n \"country\":343,\r\n //Identificación del cliente.\r\n //Tipo: public string.\r\n \"client\":\"811021438\",\r\n //Identificador del comercio.\r\n //Tipo: public string.\r\n \"ComercioHGIpay\":\"b17c0b9f-5d37-4a8c-a92a-df97affe0cf7\",\r\n //Tipo de persona que realiza la compra. \"0\" natural o \"1\" jurídica.\r\n //Tipo: public string.\r\n \"type_person\":\"0\",\r\n //Identificador de pago del cliente (este se usa luego para consultar el estado del pago).\r\n //Tipo: public Guid.\r\n \"payment_identifier\":\"b302d9b5-e552-41f4-be29-eec7cdeb6134\",\r\n //Identificación del usuario pagador.\r\n //Tipo: public string.\r\n \"id\":\"11111111\",\r\n //Nombre de usuario.\r\n //Tipo: public string.\r\n \"name\":\"HGI SAS\",\r\n //Tipo de documento de identidad del comprador (máx. 3 caracteres).\r\n //Tipo: public string. \r\n \"user_id\":\"NIT\",\r\n //Número de documento o factura del tercero.\r\n //Tipo: public int. \r\n \"document\":25,\r\n //Correo.\r\n //Tipo: public string.\r\n \"email\":\"info@hgi.com.co\",\r\n //Teléfono del usuario pagador.\r\n //Tipo: public string.\r\n \"mobile_phone\":\"3053954360\",\r\n //Código del comercio.\r\n //Tipo: public string.\r\n \"datakey\":\"b4eaf884b20d86e8d74ca2cc855f8397455727bac0f28285523f771ece6419d815407da438dee0e83c36d304fc68a65d470c3ec3dcdac893d35c922820d37c59\",\r\n //Referencias.\r\n //Tipo: public string. \r\n \"reference_number1\":\"Pago desde HGIPay\",\r\n //Referencias 2.\r\n //Tipo: public string.\r\n \"reference_number2\":\"Referencia 2\",\r\n //Referencias 3.\r\n //Tipo: public string.\r\n \"reference_number3\":\"Referencia 3\",\r\n //Moneda.\r\n //Tipo: public string.\r\n \"money\":\"COP\",\r\n //Monto de la orden de compra.\r\n //Tipo: public string.\r\n \"amount\":\"250\",\r\n //Descripción del pago.\r\n //Tipo: public string.\r\n \"description\":\"Prueba HGI SAS\",\r\n //Fijador del lenguaje.\r\n //Tipo: public string.\r\n \"language\":\"es\",\r\n //Método de pago.\r\n //Tipo: public string. \r\n \"method\":\"0\",\r\n //Valor del iva.\r\n //Tipo: public string.\r\n \"iva\":\"0.00\",\r\n //Url de actualización de pago.\r\n //Tipo: public string.\r\n \"url_confirmation\":\"https://hgipay.co/\",\r\n //Url de regreso al comercio.\r\n //Tipo: public string.\r\n \"url_response\":\"https://hgipay.co/\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pruebas.hgipay.co/api/transactions/v1/registrar"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Expires","value":"-1"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"X-Powered-By-Plesk","value":"PleskWin"},{"key":"Date","value":"Tue, 04 Oct 2022 20:40:28 GMT"},{"key":"Content-Length","value":"387"}],"cookie":[],"responseTime":null,"body":"{\n //Estado de creación de la transacción.\n //Tipo: public string.\n //0000 - TRANSACCION REGISTRADA CON EXITO.\n //1000 - CLIENTE NO EXISTE.\n //1005 - CODIGO DE COMERCIO HGIPay NO TIENE EL FORMATO CORRECTO.\n //1000 - ERROR INTERNO.\n \"CODE\": \"0000\",\n //Descripción del estado de creación de la transacción.\n //Tipo: public string.\n \"DESC\": \"TRANSACIÓN REGISTRADA CON EXITO\",\n //Objeto de respuesta.\n //Tipo: public Registro_Respuesta.\n \"DATA\": {\n //Id de seguridad de HGIPay.\n //Tipo: public string.\n \"IdSeguridad\": \"66e73b60-7610-4efe-8f1d-33818be6f571\",\n //Ticket id, generado por la pasarela HGIPay.\n //Tipo: public int.\n \"TicketId\": 25725,\n //Estado de la transacción.\n //Tipo: public int.\n //0 - Aprobado.\n //1 - Rechazado.\n //2 - Pendiente.\n //3 - Fallido.\n \"Estado\": 2,\n //Url de regreso al comercio.\n //Tipo: public string.\n \"url_response\": \"https://pruebas.hgipay.co//Pago.aspx?datakey=b4eaf884b20d86e8d74ca2cc855f8397455727bac0f28285523f771ece6419d815407da438dee0e83c36d304fc68a65d470c3ec3dcdac893d35c922820d37c59&IdSeguridad=66e73b60-7610-4efe-8f1d-33818be6f571\"\n }\n}"}],"_postman_id":"8c441e42-da91-47af-a0ef-975457119a79"},{"name":"Consulta información de una transacción","id":"cf6e9b91-b3ec-4392-92cd-df27a2e309d8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://pruebas.hgipay.co/api/transactions/v1/ConsultarID?datakey=b4eaf884b20d86e8d74ca2cc855f8397455727bac0f28285523f771ece6419d815407da438dee0e83c36d304fc68a65d470c3ec3dcdac893d35c922820d37c59&IdSeguridad=b302d9b5-e552-41f4-be29-eec7cdeb6134","description":"Por medio de esta petición se consulta información de una transacción previamente registrada.
\nNecesitaremos dos parámetros para realizar esta petición:
\n","urlObject":{"protocol":"https","path":["api","transactions","v1","ConsultarID"],"host":["pruebas","hgipay","co"],"query":[{"description":{"content":"Código facilitado por la pasarela HGIPay a cada comercio.
\n","type":"text/plain"},"key":"datakey","value":"b4eaf884b20d86e8d74ca2cc855f8397455727bac0f28285523f771ece6419d815407da438dee0e83c36d304fc68a65d470c3ec3dcdac893d35c922820d37c59"},{"description":{"content":"Es el identificador de pagos enviado en la creación del registro (payment_identifier).
\n","type":"text/plain"},"key":"IdSeguridad","value":"b302d9b5-e552-41f4-be29-eec7cdeb6134"}],"variable":[]}},"response":[{"id":"7ed5bb24-501f-484f-aada-5730a8a0ae7c","name":"Consulta realizada exitosamente","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://pruebas.hgipay.co/api/transactions/v1/ConsultarID?datakey=b4eaf884b20d86e8d74ca2cc855f8397455727bac0f28285523f771ece6419d815407da438dee0e83c36d304fc68a65d470c3ec3dcdac893d35c922820d37c59&IdSeguridad=b302d9b5-e552-41f4-be29-eec7cdeb6134","protocol":"https","host":["pruebas","hgipay","co"],"path":["api","transactions","v1","ConsultarID"],"query":[{"key":"datakey","value":"b4eaf884b20d86e8d74ca2cc855f8397455727bac0f28285523f771ece6419d815407da438dee0e83c36d304fc68a65d470c3ec3dcdac893d35c922820d37c59"},{"key":"IdSeguridad","value":"b302d9b5-e552-41f4-be29-eec7cdeb6134"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Expires","value":"-1"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"X-Powered-By-Plesk","value":"PleskWin"},{"key":"Date","value":"Tue, 04 Oct 2022 21:11:04 GMT"},{"key":"Content-Length","value":"595"}],"cookie":[],"responseTime":null,"body":"{\n //Fecha de la transacción.\n //Tipo: public DateTime.\n \"FechaRegistro\": \"2022-10-04T15:40:28.933\",\n //Fecha del documento.\n //Tipo: public DateTime.\n \"FechaDocumento\": null,\n //Fecha de confirmación de la transacción.\n //Tipo: public DateTime.\n \"FechaConfirmacion\": \"2022-10-04T16:11:04.1968154\",\n //Id de seguridad de HGIPay.\n //Tipo: public string.\n \"IdSeguridad\": \"66e73b60-7610-4efe-8f1d-33818be6f571\",\n //Identificador de HGIPay.\n //Tipo: public int.\n \"TicketId\": 25725,\n //En el caso de pago PSE, código CUS.\n //Tipo: public string.\n \"TransaccionCUS\": null,\n //Estado de la transacción.\n //Tipo: public int.\n \"Estado\": 3,\n //Código del banco.\n //Tipo: public string.\n \"CodigoBanco\": null,\n //Descripción del banco.\n //Tipo: public string.\n \"Banco\": null,\n //Descripción del pago.\n //Tipo: public string.\n \"Descripcion\": \"Prueba HGI SAS\",\n //Franquicia.\n //Tipo: public string.\n \"Franquicia\": null,\n //Mensaje de verificación.\n //Tipo: public string.\n \"MensajeVerificacion\": \"Pago Abandonado\",\n //Referencias.\n //Tipo: public string.\n \"Referencia1\": \"Pago desde HGIPay\",\n //Referencias 2.\n //Tipo: public string.\n \"Referencia2\": \"Referencia 2\",\n //Referencias 3.\n //Tipo: public string.\n \"Referencia3\": \"Referencia 3\",\n //Url de destino.\n //Tipo: public string.\n \"RutaDestino\": \"https://hgipay.co/\",\n //Url de sincronización.\n //Tipo: public string.\n \"RutaSync\": \"https://hgipay.co/\",\n //Valor de la transacción.\n ////Tipo: public int.\n \"Valor\": 250,\n //Método de pago.\n //Tipo: public string.\n \"MetodoPago\": \"0\",\n //Valor del iva.\n //Tipo: public string.\n \"ValorIva\": null,\n //Número de documento o factura del tercero.\n //Tipo: public int.\n \"Documento\": 25,\n //En el caso de pago PSE, ciclo.\n //public int.\n \"Ciclo\": null,\n //En el caso de pagos con tarjeta de crédito, código de aprobación.\n //Tipo: public string.\n \"CodAprobacion\": null\n}"}],"_postman_id":"cf6e9b91-b3ec-4392-92cd-df27a2e309d8"}]}