2. 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:

Despues de consumir este servicio se procede a usar el consumo del pago (Pagar Referencia CS)

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

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,
        "code_bar": "41577021380000228020240138971871172440003900000000000830009620250425",
        "val_another_ref": "Solo si se necesita",
        "result_query": {
            "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\u00e9rico"
                }
            ],
            "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.0,
                    "codigoBarras": "]C14157702138000022\u001d802024013897187117244005\u001d390000000000083000\u001d9620250425",
                    "codigosReferencia": [
                        "24013897187117244005"
                    ],
                    "codigoEan": "7702138000022",
                    "fechaCaducidad": "2025-04-25"
                },
                "solicita_otra_ref": true,
                "nombre_otra_ref": "Ingresar Numero Factura"
            }
        }
    }
}'

Ejemplo de Respuesta

{
    "statusCode": 200,
    "message": "Exitoso",
    "data": {
        "amountEditable": true,
        "Inputs": [
            {
                "icon": "document",
                "name": "barcode",
                "type": "caja-social-cod-bar",
                "label": "Código de barras",
                "disabled": true,
                "value": "41577021380000228020240138971871172440003900000000000830009620250425"
            },
            {
                "name": "amount",
                "type": "money",
                "view": "query",
                "label": "Valor TX",
                "origin": "object",
                "payloadSell": true,
                "value": 37500,
                "disabled": false
            },
            {
                "name": "aditional",
                "type": "hidden",
                "label": "Datos adicionales",
                "origin": "object",
                "payloadSell": true,
                "value": {
                    "permite_captura_manual": false,
                    "permite_modificar_valor": "0",
                    "tipo_recaudo": "03",
                    "data_codigo_barras": {
                        "pago": 83000,
                        "codigoBarras": "]C141577021380000228020240138971871172440053900000000000830009620250425",
                        "codigosReferencia": [
                            "24013897187117244005"
                        ],
                        "codigoEan": "7702138000022",
                        "fechaCaducidad": "2025-04-25"
                    }
                },
                "disabled": true
            },
            {
                "name": "references",
                "type": "hidden",
                "label": "Info referencias",
                "origin": "object",
                "payloadSell": true,
                "value": [
                    {
                        "nom_ref": "Ingresar Numero Factura 1",
                        "longitud_max_ref": 32,
                        "longitud_min_ref": 1,
                        "algoritmo_ref": "N 010 Numérico"
                    }
                ],
                "disabled": true
            },
            {
                "name": "id_convenant",
                "type": "hidden",
                "label": "Id Convenio",
                "origin": "object",
                "payloadSell": true,
                "value": "15010091",
                "disabled": true
            },
            {
                "name": "referencia_1",
                "label": "Referencia",
                "origin": "object",
                "payloadSell": true,
                "value": "24013897187117244005",
                "disabled": true,
                "type": "text"
            },
            {
                "name": "referencia_2",
                "label": "Referencia",
                "origin": "object",
                "payloadSell": true,
                "value": "0",
                "disabled": true,
                "type": "text"
            },
            {
                "name": "referencia_3",
                "label": "Referencia",
                "origin": "object",
                "payloadSell": true,
                "value": "0",
                "disabled": true,
                "type": "text"
            },
            {
                "name": "cod_convenant",
                "label": "Codigo Convenio",
                "origin": "object",
                "payloadSell": true,
                "value": "15010091",
                "disabled": true,
                "type": "text"
            },
            {
                "name": "id_autorizador",
                "type": "hidden",
                "label": "Id Autorizador",
                "origin": "object",
                "payloadSell": true,
                "value": 89,
                "disabled": true
            },
            {
                "name": "name_convenant",
                "type": "hidden",
                "label": "Nombre Convenio",
                "origin": "object",
                "payloadSell": true,
                "value": "COLOMBIA MOVIL S.A. E S P",
                "disabled": true
            },
            {
                "name": "id_convenant_pdp",
                "label": "Id Convenio",
                "origin": "object",
                "payloadSell": true,
                "value": "15010091",
                "disabled": true,
                "type": "text"
            },
            {
                "name": "name_convenant_2",
                "label": "Nombre Convenio",
                "origin": "object",
                "payloadSell": true,
                "value": "COLOMBIA MOVIL S.A. E S P",
                "disabled": true,
                "type": "text"
            }
        ],
        "DefaultPayload": [],
        "Amount": {
            "cost": 0,
            "amount": 0,
            "incentive": 0
        },
        "Error": {
            "message": null
        },
        "sign": "Gxax31OLoS3D+X7buFyqcFDUbBSBNCkP66gPgjbIPbk="
    },
    "_channel": "web"
}

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

3. Pagar Referencia CS

1. Consultar Codigo Barras