1. Consultar Codigo Barras

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:

Se debe enviar el codigo de barras sin caracteres especiales

Esta consulta se realiza con el fin de traer la informacion del convenio y en el caso de Caja Social para verificar si se necesita enviar una referencia adicional.

En la respuesta dentro del parametro "datos_adicionales" si llega el campo "solicita_otra_ref" en true significa que deben habilitar un campo adicional que sera digitado por el cliente. Adicional viene un campo llamado "nombre_otra_ref" el cual contiene la informacion de que referencia debe ingresarse.

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 la 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

Bodyapplication/json

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": 501004,
        "query": "query_code_bar",
        "code_bar": "41577021380000228020240138971871172440053900000000000830009620250425"
    }
}'

Ejemplo de Respuesta

{
    "statusCode": 200,
    "message": "Exitoso",
    "data": {
        "amountEditable": false,
        "Inputs": [
            {
                "icon": "document",
                "name": "barcode",
                "type": "caja-social-cod-bar",
                "label": "Código de barras",
                "disabled": true
            },
            {
                "name": "data",
                "type": "hidden",
                "origin": "object",
                "transformer": "JSON.parse(val)",
                "value": {
                    "cod_convenio": "15010091",
                    "nom_convenio": "COLOMBIA MOVIL S.A. E S P",
                    "referencias": [
                        {
                            "nom_ref": "Ingresar Numero Factura",
                            "longitud_max_ref": 32,
                            "longitud_min_ref": 1,
                            "algoritmo_ref": "N 010 Numérico"
                        }
                    ],
                    "valor_exacto": true,
                    "valor_menor": false,
                    "valor_mayor": false,
                    "valor_en_cero": false,
                    "realizar_consulta": true,
                    "id_autorizador": 89,
                    "id_tipo_transaccion": 204,
                    "pk_convenio_pdp": "15010091",
                    "datos_adicionales": {
                        "permite_captura_manual": false,
                        "permite_modificar_valor": "0",
                        "tipo_recaudo": "02",
                        "data_codigo_barras": {
                            "pago": 83000,
                            "codigoBarras": "]C14157702138000022\u001802024013897187117244005\u001390000000000083000\u0019620250425",
                            "codigosReferencia": [
                                "24013897187117244005"
                            ],
                            "codigoEan": "7702138000022",
                            "fechaCaducidad": "2025-04-25"
                        },
                        "solicita_otra_ref": true,
                        "nombre_otra_ref": "Ingresar Numero Factura"
                    }
                },
                "disabled": true
            },
            {
                "label": "Valor a pagar",
                "name": "amount",
                "value": 0,
                "type": "money",
                "disabled": false
            }
        ],
        "DefaultPayload": [],
        "Amount": {
            "cost": 0,
            "amount": 0,
            "incentive": 0
        },
        "Error": {
            "message": null
        },
        "sign": "Gxax31OLoS3D+X7buFyqcFDUbBSBNCkP66gPgjbIPbk="
    },
    "_channel": "web"
}

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

2. Consultar Referencia Codigo Barras CS

Como funciona los Recaudos Caja Social