Consultar Referencia Codigo Barras CS

Desarrollando

POST

/api/v1/transactions/query

Esta consulta se debe usar para los convenios que solo aceptan código de barras. Algunos aspectos que se deben tener en cuenta al realizar la petición son:

Ten en cuenta que es muy importante también la cantidad de referencias que recibes en la petición, ya que estas son las que debes enviar en el pago.

Recuerda que en el campo "aditional" encontrarás la propiedad "permite_modificar_valor"; con esta sabrás si el convenio acepta enviar un valor diferente al retornado en esta consulta.

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": 501004,
        "code_bar": "4123123"
    }
}'

Ejemplo de Respuesta

{
    "statusCode": 200,
    "message": "Exitoso",
    "data": {
        "amountEditable": false,
        "Inputs": [
            {
                "name": "references",
                "type": "hidden",
                "label": "Info referencias",
                "origin": "object",
                "payloadSell": true,
                "disabled": true,
                "value": [
                    {
                        "nom_ref": "Numero de Referencia 1",
                        "longitud_max_ref": 32,
                        "longitud_min_ref": 1,
                        "algoritmo_ref": "N 010 Numérico"
                    }
                ]
            },
            {
                "name": "id_convenant",
                "type": "hidden",
                "label": "Id Convenio",
                "origin": "object",
                "payloadSell": true,
                "disabled": true,
                "value": "1265743412082"
            },
            {
                "name": "referencia_1",
                "label": "Referencia",
                "origin": "object",
                "payloadSell": true,
                "disabled": true,
                "value": "1256123"
            },
            {
                "name": "referencia_2",
                "label": "Referencia",
                "origin": "object",
                "payloadSell": true,
                "disabled": true,
                "value": "0"
            },
            {
                "name": "referencia_3",
                "label": "Referencia",
                "origin": "object",
                "payloadSell": true,
                "disabled": true,
                "value": "0"
            },
            {
                "name": "cod_convenant",
                "label": "Codigo Convenio",
                "origin": "object",
                "payloadSell": true,
                "disabled": true,
                "value": "157430825"
            },
            {
                "name": "id_autorizador",
                "type": "hidden",
                "label": "Id Autorizador",
                "origin": "object",
                "payloadSell": true,
                "disabled": true,
                "value": "89"
            },
            {
                "name": "name_convenant",
                "type": "hidden",
                "label": "Nombre Convenio",
                "origin": "object",
                "payloadSell": true
            },
            {
                "name": "id_convenant_pdp",
                "label": "Id Convenio",
                "origin": "object",
                "payloadSell": true,
                "disabled": true,
                "value": "15743082"
            },
            {
                "name": "reference_1",
                "type": "davivienda-input",
                "label": "Referencia",
                "required": false,
                "disabled": true,
                "value": "123123123"
            },
            {
                "name": "amount",
                "type": "money",
                "label": "Valor transacción",
                "origin": "object",
                "payloadSell": true,
                "value": 288485,
                "disabled": false
            },
            {
                "name": "aditional",
                "type": "hidden",
                "origin": "object",
                "payloadSell": true,
                "value": {
                    "permite_captura_manual": false,
                    "permite_modificar_valor": "0",
                    "tipo_recaudo": "01",
                    "data_codigo_barras": {
                        "pago": 39510.0,
                        "codigoBarras": "]C114157709998112551\u001d802000910690\u001d390000039510\u001d9620251010",
                        "codigosReferencia": [
                            "00910690"
                        ],
                        "codigoEan": "7709998112551",
                        "fechaCaducidad": "2025-10-10"
                    }
                },
                "disabled": true
            }
        ],
        "DefaultPayload": [],
        "Amount": {
            "cost": 0,
            "incentive": 0
        },
        "Error": {
            "message": null
        },
        "sign": "S2irOEf+2n1sYsH7y+6/o16rc1HtXnj03a3qXfZLgBU="
    },
    "_channel": "web"
}

Modificado en 2025-10-06 16:47:59

Pagar Referencia CS

Como funciona los Recaudos Caja Social