https://api.khipu.com/
Este método ingresa a la página de Servipag y consulta la deuda pendiente con la empresa especificada.
El uso del campo CallbackUrl
desencadenará un proceso asíncrono y los datos resultantes se enviarán más tarde al webhook especificado. Esta es la forma preferida de interactuar con nuestros servicios, ya que asegura que se harán todos los esfuerzos para extraer los datos y cumplir con su solicitud dentro de un plazo razonable. Si desea la respuesta de inmediato, omita el campo CallbackUrl
pero tenga en cuenta que puede provocar tiempos de espera dependiendo del tamaño del resultado de los datos y las condiciones de la red.
Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.
https://api.khipu.com/v1/com/services/servipag.com/consult-debt
curl -i -X POST \
https://api.khipu.com/v1/com/services/servipag.com/consult-debt \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"RequestData": {
"EnterpriseName": "Aguas Andinas",
"ClientIdentifier": "25252525"
}
}'
Operación exitosa. Retorna un objeto JSON con los datos solicitados.
Identificador único de la operación.
Estado de la operación. OK
significa que el servicio se ha ejecutado correctamente aunque no devuelva datos. ERROR
indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.
Contenedor de la información de deuda.
Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data
está incompleto.
Objeto con los detalles del error, utilizado cuando Status=ERROR
. Si Status=OK
este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace
Indica cómo tratar este código de error específico, en función del tipo de error.
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "Debt": { "DueDate": "2025-05-31", "PendingDebt": 15340 } }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }
Este método se conecta a la cuenta especificada por el usuario en Servipag y retorna las cuentas de los servicios registrados.
El uso del campo CallbackUrl
desencadenará un proceso asíncrono y los datos resultantes se enviarán más tarde al webhook especificado. Esta es la forma preferida de interactuar con nuestros servicios, ya que asegura que se harán todos los esfuerzos para extraer los datos y cumplir con su solicitud dentro de un plazo razonable. Si desea la respuesta de inmediato, omita el campo CallbackUrl
pero tenga en cuenta que puede provocar tiempos de espera dependiendo del tamaño del resultado de los datos y las condiciones de la red.
Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.
https://api.khipu.com/v1/com/services/servipag.com/service-accounts
curl -i -X POST \
https://api.khipu.com/v1/com/services/servipag.com/service-accounts \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"RequestData": {}
}'
Operación exitosa. Retorna un objeto JSON con los datos solicitados.
Identificador único de la operación.
Estado de la operación. OK
significa que el servicio se ha ejecutado correctamente aunque no devuelva datos. ERROR
indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.
Contenedor de las cuentas de servicio.
Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data
está incompleto.
Objeto con los detalles del error, utilizado cuando Status=ERROR
. Si Status=OK
este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace
Indica cómo tratar este código de error específico, en función del tipo de error.
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "ServiceAccount": [ { "CompanyName": "Entel PCS Movil", "ServiceType": "Telefonía Celular", "ClientIdentifier": "221100111" } ] }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }
Este método se está descontinuando y se retirará en los próximos meses. Migre su implementación actual para usar tokens OAuth en su lugar.
Este método se conecta a la cuenta del usuario en Servipag y retorna un token vinculado a esa cuenta que puede ser usado en operaciones futuras, evitando la necesidad de enviar sus credenciales en texto plano al llamar a los servicios bancarios.
Identificación del usuario con acceso a la cuenta en el sitio web (RUN, DNI).
https://api.khipu.com/v1/com/services/servipag.com/token
curl -i -X POST \
https://api.khipu.com/v1/com/services/servipag.com/token \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"Username": "11.111.111-1",
"Password": "wxyz1234!@#$"
}'
Operación exitosa. Retorna un objeto JSON con el token de la cuenta en el campo Data
.
Identificador único de la operación.
Estado de la operación. OK
significa que el servicio se ha ejecutado correctamente aunque no devuelva datos. ERROR
indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.
Si la autenticación se ha realizado correctamente, incluye el 'Account Link' para la cuenta.
Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data
está incompleto.
Objeto con los detalles del error, utilizado cuando Status=ERROR
. Si Status=OK
este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace
Indica cómo tratar este código de error específico, en función del tipo de error.
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "AccountLink": "dFyRCVYNM0aGb1LSR/0B8e+eSVr1Zf1xj9YHmMVoiZWk28XtWEyIxEbGXnr1EdvS+QBPzjweau7tbf5QlDv97IQ2jwfUB==" }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }