Consulta obligacion

Desarrollando

POST

/api/v1/transactions/query

Servicio para consultar la obligación; para este servicio debes tener en cuenta las siguientes condiciones:

En el caso de que se requiera hacer la consulta y el pago con el número de tarjeta, se deben solicitar los primeros 6 dígitos + los últimos 4 dígitos de la tarjeta. En el caso contrario, se ingresa el número de la obligación normalmente.

Hay 3 tipos de pagos que puede realizar el cliente de la obligación: el pago mínimo, el pago total y el pago por valor diferente. Recuerda que si se ingresa un valor diferente este no debe sobrepasar el valor del pago total.

Solicitud

Autorización

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200Éxito

application/json

Bodyapplication/json

🔴500Rechazo

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location '/api/v1/transactions/query' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "data": {
    "productId": 10003106,
    "customerQueryType": "2",
    "reference": "7166297716629721",
    "customerDocType": "01",
    "customerDocument": "7166297",
    "customerPaymentType": "1"
  }
}'

Ejemplo de Respuesta

200 - Éxito

{
    "statusCode": 200,
    "message": "Exitoso",
    "data": {
        "amountEditable": true,
        "Inputs": [
            {
                "icon": "document",
                "name": "customerQueryType",
                "type": "select",
                "label": "Tipo de consulta",
                "options": [
                    {
                        "label": "Nro de Tarjeta",
                        "value": "1"
                    },
                    {
                        "label": "Nro de Obligación",
                        "value": "2"
                    }
                ],
                "required": true,
                "disabled": true,
                "value": "2"
            },
            {
                "icon": "document",
                "name": "reference",
                "note": "Para tarjeta de crédito: Los primeros 6 dígitos de la tarjeta + últimos 4 ejm: 4564216437",
                "type": "text",
                "label": "N° Tarjeta / Obligación",
                "required": true,
                "disabled": true,
                "value": "7166297716629721"
            },
            {
                "icon": "document",
                "name": "customerDocType",
                "type": "select",
                "label": "Tipo de documento",
                "options": [
                    {
                        "label": "Cedula de Ciudadania",
                        "value": "01"
                    },
                    {
                        "label": "Cedula Extranjería",
                        "value": "02"
                    },
                    {
                        "label": "Nit",
                        "value": "03"
                    },
                    {
                        "label": "Tarjeta Identidad",
                        "value": "04"
                    },
                    {
                        "label": "Nit Persona Natural",
                        "value": "12"
                    }
                ],
                "required": true,
                "disabled": true,
                "value": "01"
            },
            {
                "icon": "document",
                "name": "customerDocument",
                "type": "text",
                "label": "Documento del cliente",
                "required": true,
                "disabled": true,
                "value": "7166297"
            },
            {
                "icon": "document",
                "name": "customerPaymentType",
                "type": "select",
                "view": "query",
                "label": "Tipo de Pago",
                "options": [
                    {
                        "eval": [
                            "$indicador_abono_extraordinario",
                            "eq",
                            "S"
                        ],
                        "label": "Pago mínimo",
                        "value": "0001"
                    },
                    {
                        "eval": [
                            "$indicador_abono_extraordinario",
                            "eq",
                            "S"
                        ],
                        "label": "Pago total",
                        "value": "0002"
                    },
                    {
                        "eval": [
                            "$indicador_abono_extraordinario",
                            "eq",
                            "S"
                        ],
                        "label": "Disminución de cuota",
                        "value": "0003"
                    },
                    {
                        "eval": [
                            "$indicador_abono_extraordinario",
                            "eq",
                            "S"
                        ],
                        "label": "Adelanto de cuota",
                        "value": "0004"
                    },
                    {
                        "eval": [
                            "$indicador_abono_extraordinario",
                            "eq",
                            "S"
                        ],
                        "label": "Abono a Capital",
                        "value": "0005"
                    },
                    {
                        "eval": [
                            "$indicador_abono_extraordinario",
                            "eq",
                            "S"
                        ],
                        "label": "Valor diferente",
                        "value": "0006"
                    },
                    {
                        "eval": [
                            "$indicador_abono_extraordinario",
                            "eq",
                            "N"
                        ],
                        "label": "Pago Minimo",
                        "value": "0001"
                    },
                    {
                        "eval": [
                            "$indicador_abono_extraordinario",
                            "eq",
                            "N"
                        ],
                        "label": "Pago Total",
                        "value": "0002"
                    },
                    {
                        "eval": [
                            "$indicador_abono_extraordinario",
                            "eq",
                            "N"
                        ],
                        "label": "Valor diferente",
                        "value": "0006"
                    }
                ],
                "onChange": "self.setForm({amount: ['0001'].includes(val) ? self.form.amount_3 : self.form.amount_2 })",
                "required": true,
                "disabled": false,
                "value": "1"
            },
            {
                "name": "amount",
                "type": "money",
                "view": "query",
                "label": "valor",
                "value": "405000",
                "disabled": false
            },
            {
                "name": "id_query",
                "origin": "object",
                "payloadSell": true,
                "label": "Id Consulta",
                "type": "hidden",
                "value": 3576467,
                "disabled": true
            },
            {
                "name": "uuid_trx",
                "origin": "object",
                "payloadSell": true,
                "label": "Tx Id",
                "type": "hidden",
                "value": "f80a52c0-dc9e-4a21-b6b8-02110a6d6ef9",
                "disabled": true
            },
            {
                "name": "name_holder",
                "origin": "object",
                "payloadSell": true,
                "label": "Nombre Receptor",
                "value": "LUIS",
                "disabled": true,
                "type": "text"
            },
            {
                "name": "lastname_holder",
                "origin": "object",
                "payloadSell": true,
                "label": "Apellidos Receptor",
                "value": "TOLEDA",
                "disabled": true,
                "type": "text"
            },
            {
                "name": "cost",
                "origin": "object",
                "payloadSell": true,
                "label": "Costo",
                "value": 0,
                "disabled": true,
                "type": "text"
            },
            {
                "name": "indicador_abono_extraordinario",
                "origin": "object",
                "payloadSell": false,
                "label": "Indicador Abono",
                "type": "hidden",
                "value": "N",
                "disabled": true
            },
            {
                "name": "amount_2",
                "origin": "object",
                "payloadSell": true,
                "label": "Pago total",
                "disabled": true,
                "type": "hidden",
                "value": 465544
            },
            {
                "name": "amount_3",
                "origin": "object",
                "payloadSell": true,
                "label": "Pago minimo",
                "type": "hidden",
                "value": 405000,
                "disabled": true
            }
        ],
        "DefaultPayload": [],
        "Amount": {
            "cost": 0,
            "incentive": null
        },
        "Error": {
            "message": null
        },
        "sign": "S2irOEf+2n1sYsH7y+6/o16rc1HtXnj03a3qXfZLgBU="
    },
    "_channel": "web"
}

Modificado en 2026-07-03 18:22:20

Como funciona el pago de obligaciones Davivienda

Pago obligacion