Consultar Referencia COLP

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 "aditional" debe ser enviado en formato String (Enviar el valor retornado de la consulta anterior).

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.

Tener en cuenta las condiciones de la propiedad "fk_tipo_valor" que fue mencionada anteriormente, ya que dependiendo del caso se debe enviar en el amount un valor. Por defecto es 0.

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",
        "reference_2": "44412312",
        "name_convenant": "CLARO HOGAR",
        "id_autorizator": 44,
        "id_convenant_pdp": "898748190",
        "amount": 0,
        "aditional": "{\"fk_tipo_valor\":2,\"codigo_convenio_pdp\":16}"
    }
}'

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": 12255,
                "disabled": false
            },
            {
                "name": "aditional",
                "type": "hidden",
                "origin": "object",
                "payloadSell": true,
                "value": {
                    "fk_tipo_valor": 2,
                    "codigo_convenio_pdp": 16,
                    "id_trx": 123456789,
                    "codigo_autorizacion": "837301",
                    "id_type_trx": 84,
                    "codigo_banco_response": "00"
                },
                "disabled": true
            }
        ],
        "DefaultPayload": [],
        "Amount": {
            "cost": 0,
            "incentive": 0
        },
        "Error": {
            "message": null
        },
        "sign": "S2irOEf+2n1sYsH7y+6/o16rc1HtXnj03a3qXfZLgBU="
    },
    "_channel": "web"
}

Modificado en 2025-10-06 19:11:05

Pagar Referencia COLP

Consultar convenio COLP