API Pay Out Asíncrono

API REST JSON orientada a transacciones payout asíncronas. Permite autorizar lotes, consultar estados de lotes o transacciones, consultar bancos disponibles y recibir notificaciones vía webhook.

REST JSON Basic Auth branchCode Lotes Webhook

Probar en sandbox Ver monitor Descargar PDF

Endpoints disponibles

Servicios principales del payout asíncrono.

POST Autorizar lote

/api/v2/lote/autorizar

Autoriza y valida un lote de transacciones payout.

GET Consultar estado

/api/v2/lote/estado

Consulta el estado actual de un lote o de una transacción específica.

POST Consultar bancos

/api/v2/bancos

Devuelve la lista de bancos disponibles para realizar acreditaciones.

Autenticación

Headers requeridos para invocar los servicios.

Headers requeridos

Header	Valor	Uso
Authorization	Basic <base64(User:Pass)>	Autenticación obligatoria
branchCode	Código de establecimiento asignado por ATC	Identificación del establecimiento

Error en credenciales

{
  "data": null,
  "code": "98",
  "message": "Error en la autenticación, Credenciales inválidas"
}

Ejemplo de request

Solicitud para autorizar un lote.

{
  "processId": "66ec5b3d-61ea-4254-b366-7104545aa3c6",
  "codeComercio": "454545",
  "transacciones": [
    {
      "transaccionId": "001002",
      "codeSucursal": "LPZ",
      "codeBanco": "1018",
      "importe": 50.00,
      "fechaTransaccion": "2026-01-19",
      "cuentaDestino": "1311404044",
      "glosa": "PAGO QR",
      "ciNitDestino": "54524525212",
      "titularDestino": "PEPE PEPE",
      "tipoMoneda": "BOB"
    }
  ]
}

Ejemplo de response

Respuesta exitosa de autorización.

{
  "code": "00",
  "message": "success",
  "data": {
    "nroLote": "2601191040",
    "processId": "4554645646446",
    "transacciones": [
      {
        "transaccionId": "001001",
        "estado": "PENDIENTE",
        "numeroReferencia": "502125545442601",
        "mensaje": "Transacción en proceso."
      }
    ]
  }
}

Campos clave del lote

Parámetros principales para autorizar transacciones.

Campo	Tipo	Descripción	Requerido
codeComercio	String	Código único del comercio. Debe coincidir con branchCode	Sí
processId	String	Identificador único del proceso, formato UUID	Sí
codeBanco	String	Código del banco destinatario	Sí
transaccionId	String	Identificador único de la transacción	Sí
importe	Decimal	Monto a transferir	Sí
fechaTransaccion	String	Fecha en formato yyyy-mm-dd	Sí
cuentaDestino	String	Cuenta bancaria destino	Sí
glosa	String	Motivo o descripción de la transacción	Sí
ciNitDestino	String	Documento o NIT del titular	Sí
titularDestino	String	Nombre del titular de la cuenta	Sí
tipoMoneda	String	BOB o USD	Sí

Consulta de estado

Respuesta típica al consultar un lote o transacción.

{
  "data": {
    "nroLote": "2601191046",
    "transacciones": [
      {
        "transaccionId": "001002",
        "numeroReferencia": "4131654455",
        "estado": "PAGADO",
        "mensaje": "Proceso Completado",
        "cuenta": "1311404044",
        "importe": 50,
        "moneda": "BOB",
        "numeroAch": "14262601197202459706",
        "ciCliente": "54524525212",
        "nombreCliente": "PEPE PEPE"
      }
    ]
  },
  "code": "00",
  "message": "Operación exitosa"
}

Webhook de notificación

Endpoint que debe exponer el comercio.

Endpoint del comercio

POST https://dominio.com/qr/confirmed

Seguridad admitida: Basic Auth + x-api-key. La conexión debe coordinarse con Infraestructura y Redes.

Respuesta esperada a Red Enlace

{
  "nroLote": "2601191045",
  "numeroReferencia": "582154541121",
  "codigoRespuesta": "EXITOSO",
  "detalleRespuesta": null
}

Ambientes

Base URL documentada por entorno.

Entorno	URL Base	Credenciales
Sandbox	`https://atcasincert.redenlace.com.bo`	Solicitar user y pass por correo electrónico
Producción	`https://atcasin.redenlace.com.bo`	Solicitar user y pass por correo electrónico