Lista de creditos disponibles.

Desarrollando

POST

/api/v1/transactions/query

En el campo name: credits
El valor retornado corresponde a una cadena en formato JSON (JSON String) que contiene la lista de créditos disponibles para el cliente.

Este campo no devuelve una estructura JSON parseada directamente, sino un texto serializado, por lo que debe ser convertido (parseado) por el sistema consumidor antes de su utilización.

Contenido

La cadena incluye la colección de créditos disponibles obtenidos en la preconsulta, cada uno con la información necesaria para su selección y posterior consulta de detalle.

Consideraciones técnicas

El valor debe ser procesado mediante deserialización JSON (por ejemplo JSON.parse()).

La estructura resultante representa una lista (array) de créditos.

Cada elemento del arreglo corresponde a un crédito disponible para pago.

Este campo es utilizado como insumo para el paso de selección del crédito en el flujo de pago.

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

Body

🔴500Error

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/transactions/query' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "data": {
    "query": "get_credits",
    "productId": 10087388,
    "allCredits": "ok",
    "creditUsedInConfirmedSell": false,
    "customerDocumentType": "1",
    "customerDocument": "31282474"

  }
 
}'

Ejemplo de Respuesta

200 - Éxito

{
    "statusCode": 200,
    "message": "Exitoso",
    "data": {
        "amountEditable": false,
        "Inputs": [
            {
                "icon": "document",
                "name": "customerDocumentType",
                "type": "select",
                "label": "Tipo de documento",
                "options": [
                    {
                        "label": "Seleccione...",
                        "value": ""
                    },
                    {
                        "label": "CÉDULA",
                        "value": "1"
                    },
                    {
                        "label": "NIT",
                        "value": "2"
                    },
                    {
                        "label": "EXTRANJERIA",
                        "value": "3"
                    },
                    {
                        "label": "PASAPORTE",
                        "value": "4"
                    }
                ],
                "required": true,
                "disabled": true,
                "value": "1"
            },
            {
                "name": "customerDocument",
                "type": "test",
                "label": "Número de documento",
                "required": true,
                "disabled": true,
                "value": "31282474"
            },
            {
                "name": "credits",
                "type": "input-banco-w",
                "label": "input-banco-w",
                "title": "Créditos disponibles",
                "Description": "Seleccion un crédito con el desea operar",
                "required": false,
                "preQueryProcess": {
                    "check": "creditUsedInConfirmedSell",
                    "method": "start",
                    "complete": "creditUsedInConfirmedSell"
                },
                "disabled": true,
                "value": "[{\"operacionUId\":1573324,\"nroCredito\":\"000522704001436728\",\"codOperacionBT\":\"0010000100111000000000000052270400000001436728009\",\"descripcionTipoOperacion\":\"Micropyme Tasa Fija\",\"totalDeuda\":40433388.16,\"fechaProxCuota\":\"2026-01-21\",\"deudaProxCuota\":1556471,\"diasMora\":0,\"fechaValor\":\"2025-12-16\",\"fechaVencimiento\":\"2028-12-21\",\"saldoCapital\":40000000},{\"operacionUId\":1573363,\"nroCredito\":\"000522704001436765\",\"codOperacionBT\":\"0010006500111000000000000052270400000001436765001\",\"descripcionTipoOperacion\":\"Comercial-Inmueble Productivo\",\"totalDeuda\":40229659,\"fechaProxCuota\":\"2026-01-26\",\"deudaProxCuota\":3755838,\"diasMora\":0,\"fechaValor\":\"2025-12-24\",\"fechaVencimiento\":\"2026-12-26\",\"saldoCapital\":40000000},{\"operacionUId\":1014773,\"nroCredito\":\"000522704000976098\",\"codOperacionBT\":\"0010007100113000000000000052270400000000976098024\",\"descripcionTipoOperacion\":\"Crédito productivo urbano\",\"totalDeuda\":12464711,\"fechaProxCuota\":\"2026-01-08\",\"deudaProxCuota\":813046,\"diasMora\":0,\"fechaValor\":\"2023-10-31\",\"fechaVencimiento\":\"2027-11-08\",\"saldoCapital\":12087189.13}]"
            },
            {
                "label": "Valor a pagar",
                "name": "amount",
                "value": 0,
                "type": "money",
                "disabled": false
            }
        ],
        "DefaultPayload": [],
        "Amount": {
            "cost": 0,
            "amount": 0,
            "incentive": 0
        },
        "Error": {
            "message": null
        },
        "sign": "ypeBEsobvcr6wjGzmiPcTaeG7/gUfE5yuYB3ha/uSLs="
    },
    "_channel": ""
}

Modificado en 2026-02-05 22:37:45

¿Como funciona?

Consulta detalle crédito seleccionado.