Consultar Referencia CS

Desarrollando

POST

/api/v1/transactions/query

Esta consulta se debe usar para los convenios que tienen consulta previa. Algunos aspectos que se deben tener en cuenta al realizar la peticion es:

El campo "references" debe ser enviado en formato String.

El campo "aditional" debe ser enviado en formato String.

Ten en cuenta que es muy importante también la cantidad de referencias que envías en la petición, de acuerdo a la consulta del convenio.

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/json

Ejemplos

Respuestas

🟢200

application/json

Body

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": {
        "productId": 10049201,
        "id_convenant": "15713663",
        "reference_1": "123123123",
        "name_convenant": "CLARO HOGAR",
        "id_autorizator": 89,
        "id_convenant_pdp": "15713663",
        "amount": 0,
        "references": "[{\"nom_ref\":\"Numero de Referencia\",\"longitud_max_ref\":32,\"longitud_min_ref\":1,\"algoritmo_ref\":\"N 010 Numérico\"}]",
        "aditional": "{\"permite_captura_manual\":true,\"permite_modificar_valor\":\"0\",\"tipo_recaudo\":\"02\"}"
    }
}'

Ejemplo de Respuesta

{
    "statusCode": 200,
    "message": "Exitoso",
    "data": {
        "amountEditable": false,
        "Inputs": [
            {
                "name": "reference_1",
                "type": "davivienda-input",
                "label": "Referencia",
                "required": false,
                "disabled": true,
                "value": "123123123"
            },
            {
                "name": "tx_id",
                "type": "hidden",
                "origin": "object",
                "payloadSell": true,
                "value": "",
                "disabled": true
            },
            {
                "name": "amount",
                "type": "money",
                "view": "query",
                "label": "Valor transacción",
                "origin": "object",
                "payloadSell": true,
                "value": 288485,
                "disabled": false
            },
            {
                "name": "aditional",
                "type": "hidden",
                "origin": "object",
                "payloadSell": true,
                "value": {
                    "permite_captura_manual": true,
                    "permite_modificar_valor": "0",
                    "tipo_recaudo": "03",
                    "id_trx": 3567842,
                    "codigo_banco_response": "00",
                    "codigo_autorizacion": "4616059"
                },
                "disabled": true
            }
        ],
        "DefaultPayload": [],
        "Amount": {
            "cost": 0,
            "incentive": 0
        },
        "Error": {
            "message": null
        },
        "sign": "S2irOEf+2n1sYsH7y+6/o16rc1HtXnj03a3qXfZLgBU="
    },
    "_channel": "web"
}

Modificado en 2025-10-03 22:47:42

Consultar convenio CS

Pagar Referencia CS