Consultar cuenta

Desarrollando

POST

/api/v1/transactions/query

Servicio para consultar la información de la cuenta del cliente. Se debe tener en cuenta que el costo que llega en la consulta es el cobro que le hará el banco al cliente en su cuenta.

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

Ejemplos

Respuestas

🟢200Éxito

application/json

Body

🔴500Rechazo

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": 10003104,
    "customerAccType": "01",
    "reference": "30000000000",
    "customerDocType": "01",
    "customerDocument": "30000000000",
    "curstomerNameDepositer": "Nombre cliente que deposita",
    "amount": 10000
  }
}'

Ejemplo de Respuesta

200 - Éxito

{
    "statusCode": 200,
    "message": "Exitoso",
    "data": {
        "amountEditable": false,
        "Inputs": [
            {
                "icon": "document",
                "name": "customerAccType",
                "type": "select",
                "label": "Tipo de cuenta del cliente",
                "options": [
                    {
                        "label": "Cuenta Ahorros",
                        "value": "01"
                    },
                    {
                        "label": "Cuenta Corriente",
                        "value": "02"
                    }
                ],
                "required": true,
                "disabled": true,
                "value": "01"
            },
            {
                "icon": "cellphone",
                "name": "reference",
                "type": "cellphone",
                "label": "Nro de Cuenta",
                "required": true,
                "disabled": true,
                "value": "30000000000"
            },
            {
                "icon": "document",
                "name": "customerDocType",
                "type": "select",
                "label": "Tipo de documento del cliente",
                "options": [
                    {
                        "label": "Cedula de Ciudadania",
                        "value": "01"
                    },
                    {
                        "label": "Cedula Extranjería",
                        "value": "02"
                    },
                    {
                        "label": "Tarjeta Identidad",
                        "value": "04"
                    }
                ],
                "required": true,
                "disabled": true,
                "value": "01"
            },
            {
                "icon": "document",
                "name": "customerDocument",
                "type": "text",
                "label": "Documento del cliente",
                "required": true,
                "disabled": true,
                "value": "30000000000"
            },
            {
                "icon": "document",
                "name": "curstomerNameDepositer",
                "type": "text",
                "label": "Nombre del cliente",
                "required": true,
                "disabled": true,
                "value": "Nombre cliente que deposita"
            },
            {
                "icon": "price",
                "name": "amount",
                "type": "amount",
                "label": "Valor",
                "required": true,
                "defaultValues": [
                    10000,
                    20000,
                    30000,
                    50000,
                    100000,
                    200000
                ],
                "disabled": true,
                "value": "10000"
            },
            {
                "name": "id_query",
                "origin": "object",
                "payloadSell": true,
                "label": "Id Consulta",
                "value": 3574220,
                "disabled": true,
                "type": "text"
            },
            {
                "name": "cost",
                "origin": "object",
                "payloadSell": true,
                "label": "Costo",
                "value": 0,
                "disabled": true,
                "type": "text"
            },
            {
                "name": "uuid_trx",
                "origin": "object",
                "payloadSell": true,
                "label": "Tx Id",
                "value": "8258784a-c7c6-457a-9694-ef67e0e1f2d8",
                "disabled": true,
                "type": "text"
            },
            {
                "name": "name_holder",
                "origin": "object",
                "payloadSell": true,
                "label": "Nombre Receptor",
                "value": "TRES SESENTA CLIENTE",
                "disabled": true,
                "type": "text"
            }
        ],
        "DefaultPayload": [],
        "Amount": {
            "cost": 0,
            "amount": 10000,
            "incentive": null
        },
        "Error": {
            "message": null
        },
        "sign": "S2irOEf+2n1sYsH7y+6/o16rc1HtXnj03a3qXfZLgBU="
    },
    "_channel": "web"
}

Modificado en 2025-10-09 21:12:56

Cómo funcionan los depósitos de Caja Social

Deposito a la cuenta