API Pay Out Consultas

API REST JSON para consultar movimientos y saldos disponibles del servicio payout. Permite obtener movimientos de crédito, movimientos de débito y saldos por establecimiento.

REST JSON x-api-key x-user-id Créditos Débitos Saldos

Probar en sandbox Ver monitor Descargar PDF

Endpoints disponibles

Consultas documentadas para payout.

POST Movimientos débito

/api/v1/MovimientoEstablecimiento/debito

Devuelve movimientos financieros de tipo débito por establecimiento y rango de fechas.

POST Movimientos crédito

/api/v1/MovimientoEstablecimiento/credito

Devuelve movimientos financieros de tipo crédito por establecimiento y rango de fechas.

POST Saldos por establecimiento

/api/v1/SaldosEstablecimiento

Consulta el saldo disponible por establecimiento dentro del servicio payout.

Autenticación

Headers requeridos en todos los endpoints.

Headers requeridos

Header	Valor	Uso
x-api-key	Token generado desde el portal administrativo	Autenticación del servicio
x-user-id	NIT del comercio	Identificación del comercio

Notas de integración

Todos los payloads se envían en JSON.
Para movimientos se requiere rango de fechas.
Para saldos no se requiere fecha, solo establecimientos.

Ejemplo de request para movimientos

Body compartido para créditos y débitos.

{
  "establecimientos": [
    "291997",
    "314955",
    "449932"
  ],
  "fechaInicio": "2025-12-01",
  "fechaFin": "2026-01-30"
}

Ejemplo de response para movimientos

Respuesta agrupada por establecimiento.

{
  "data": {
    "lista": [
      {
        "idEstablecimiento": "314955",
        "listaMovimientos": [
          {
            "id": 3,
            "tipoFondeo": 1,
            "moneda": "BOB",
            "monto": 333.34,
            "origen": "PREFONDEO_PDC",
            "fechaOperacion": "2026-01-09T14:51:36.196",
            "modoPayout": null
          }
        ]
      },
      {
        "idEstablecimiento": "449932",
        "listaMovimientos": [
          {
            "id": 1,
            "tipoFondeo": 1,
            "moneda": "BOB",
            "monto": 333.33,
            "origen": "PREFONDEO_PDC",
            "fechaOperacion": "2026-01-09T14:51:36.167",
            "modoPayout": null
          }
        ]
      }
    ]
  },
  "code": "00",
  "errorCode": "",
  "errorMessage": ""
}

Campos clave de movimientos

Parámetros requeridos para consultar débitos y créditos.

Campo	Tipo	Descripción	Requerido
establecimientos	Array[string]	Lista de IDs de establecimientos asociados al NIT	Sí
fechaInicio	String	Fecha inicial en formato yyyy-mm-dd	Sí
fechaFin	String	Fecha final en formato yyyy-mm-dd	Sí

Ejemplo de request para saldos

Body para consultar saldos por establecimiento.

{
  "establecimientos": [
    "291997",
    "314955",
    "449932"
  ]
}

Ejemplo de response para saldos

Respuesta con saldos disponibles por establecimiento.

{
  "data": {
    "establecimientos": [
      {
        "id": 2,
        "idEstablecimiento": 291997,
        "tipoSaldo": 1,
        "moneda": "BOB",
        "saldoDisponible": 3.33,
        "fechaUltimoCredito": "2026-01-09T15:27:57.946",
        "fechaUltimoDebito": "2026-01-09T15:34:21.966"
      },
      {
        "id": 3,
        "idEstablecimiento": 314955,
        "tipoSaldo": 1,
        "moneda": "BOB",
        "saldoDisponible": 6140.63,
        "fechaUltimoCredito": "2026-01-09T15:21:35.851",
        "fechaUltimoDebito": "2026-01-09T15:21:21.466"
      }
    ]
  },
  "code": "00",
  "errorCode": "",
  "errorMessage": "balance obtenido correctamente"
}

Campos clave de saldos

Estructura principal de salida por establecimiento.

Campo	Tipo	Descripción
idEstablecimiento	Bigint	ID del establecimiento
tipoSaldo	Int	1 = PREFONDEO, 2 = FONDEO
moneda	String	Moneda del saldo
saldoDisponible	Decimal	Monto de saldo disponible
fechaUltimoCredito	DateTime	Fecha del último crédito recibido
fechaUltimoDebito	DateTime	Fecha del último débito transaccionado

Ambientes

URLs documentadas para sandbox y producción.

Servicio	Sandbox	Producción
Movimiento establecimiento Débitos	`https://portalconsultascert.redenlace.com.bo:9443/api/v1/MovimientoEstablecimiento/debito`	`https://portalconsultas.redenlace.com.bo:9443/api/v1/MovimientoEstablecimiento/debito`
Movimiento establecimiento Créditos	`https://portalconsultascert.redenlace.com.bo:9443/api/v1/MovimientoEstablecimiento/credito`	`https://portalconsultas.redenlace.com.bo:9443/api/v1/MovimientoEstablecimiento/credito`
Saldos establecimiento	`https://portalconsultascert.redenlace.com.bo:9443/api/v1/SaldosEstablecimiento`	`https://portalconsultas.redenlace.com.bo:9443/api/v1/SaldosEstablecimiento`