API · Consultar detalle de lote

API v1

Una herramienta del MCP envuelve esta operación: Tarjetas guardadas y cobros masivos.

POST /api/v1/collect/get/massive/detail

Qué hace#

Consultar detalle de lote.

Autenticación#

Servidor: https://app.tilopay.com. Requiere el token bearer del API en Authorization: Bearer <token> y la llave de la integración en el cuerpo (key).

Obtener el token del API.

Parámetros#

keystringrequerido#

Llave de la integración.

codestringrequerido#

El code del listado de lotes.

Ejemplo de request#

<api_key> es el marcador de tu llave de integración.

{
  "key": "<api_key>",
  "code": "UnBSdXN0bnZSc0owVXdvU1haVisxZz09"
}

Respuesta#

responseText trae el motivo del rechazo: Daily amount exceeded significa que el afiliado superó su monto máximo diario. El estado Programmed indica un cobro programado aún no procesado.

statusunknown#

status.

errorsunknown#

errors.

paymentsarray#

payments.

{
  "status": 200,
  "errors": "",
  "payments": [
    {
      "id": 12,
      "collect_id": 2,
      "currency": "CRC",
      "amount": "100.00",
      "reference": "0",
      "auth": "",
      "date_programmed": "",
      "reason": "Cobro mensualidad",
      "responseText": "Daily amount exceeded",
      "status": "processed",
      "approved_payment": "0"
    },
    {
      "id": 20,
      "collect_id": 2,
      "currency": "CRC",
      "amount": "100.00",
      "reference": "0",
      "auth": "123456",
      "date_programmed": "",
      "reason": "Cobro mensualidad",
      "responseText": "Approved",
      "status": "processed",
      "approved_payment": "0"
    },
    {
      "id": 9,
      "collect_id": 2,
      "currency": "CRC",
      "amount": "100.00",
      "reference": "",
      "auth": "",
      "date_programmed": "2024-05-19",
      "reason": "Cobro mensualidad",
      "responseText": "",
      "status": "Programmed",
      "approved_payment": "0"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "integer"
    },
    "errors": {
      "type": "string"
    },
    "payments": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "collect_id": {
            "type": "integer"
          },
          "currency": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "reference": {
            "type": "string"
          },
          "auth": {
            "type": "string"
          },
          "date_programmed": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "responseText": {
            "type": "string",
            "description": "Rejection reason; Daily amount exceeded means the affiliate daily maximum was exceeded."
          },
          "status": {
            "type": "string",
            "enum": [
              "processed",
              "Programmed"
            ]
          },
          "approved_payment": {
            "type": "string"
          }
        }
      }
    }
  }
}

Última verificación: 2026-10-20

Ver como Markdown crudo