Skip to content

Listar Comprobantes de Pago

Devuelve los metadatos (no los bytes del archivo) de cada comprobante de pago que has subido para un pago que sigue activo — es decir, que no ha sido eliminado.

GET /v1/payments/:id/proofs

Autenticación

Authorization: Bearer <api-key>

El pago debe pertenecer a una suscripción propiedad de tu tenant.

Parámetros de ruta

ParámetroDescripción
idEl ID del pago

Respuesta

200 OK

json
{
  "ok": true,
  "proofs": [
    {
      "id": "00000000-0000-0000-0000-000000000042",
      "filename": "receipt.pdf",
      "mimeType": "application/pdf",
      "referenceNumber": "SPI-20260628-00931",
      "active": true,
      "createdAt": "2026-06-28T23:14:03.087Z"
    },
    {
      "id": "00000000-0000-0000-0000-000000000043",
      "filename": "bank-statement.png",
      "mimeType": "image/png",
      "referenceNumber": "SPI-20260628-00931",
      "active": true,
      "createdAt": "2026-06-29T10:02:11.400Z"
    }
  ]
}

Aquí solo se devuelven los archivos con active: true — un archivo que hayas eliminado desaparece de esta lista (aunque no desaparece de la vista de tu proveedor; consulta esa página). Usa el id de un comprobante con Download Payment Proof para obtener el archivo real. referenceNumber es la referencia de la transferencia bancaria que indicaste al subirlo — todos los archivos del mismo envío comparten el mismo valor; un reenvío posterior (por ejemplo, después de un rechazo) puede tener uno diferente si hiciste una nueva transferencia.

Errores

Estado HTTPCódigoCuándo ocurre
401UNAUTHORIZEDAPI key faltante o inválida
404PAYMENT_NOT_FOUNDEl pago no existe, o pertenece a otro tenant
429TOO_MANY_REQUESTSSe excedió el límite de tasa

Documentación de la API de Comprobify