Cómo demostrar la propiedad del código en una disputa de pago con un cliente
Entregaste la compilación con la funcionalidad completa un viernes. Tres sprints, cuatro meses, una declaración de trabajo firmada. El lunes el cliente se queda en silencio. Dos semanas después, su gerente de operaciones escribe: “Nunca recibimos el código final, y lo que sí vimos no funcionaba según lo acordado”. Luego se detienen las facturas.
Este es el momento que todo freelancer y pequeña agencia teme, y es exactamente el momento en que saber cómo demostrar la propiedad del código durante una disputa de pago con un cliente deja de ser una preocupación teórica y se convierte en la diferencia entre cobrar y dar por perdidos cuatro meses de trabajo.
La pesadilla del freelancer: cuando un cliente se niega a pagar
El escenario se repite con una regularidad casi mecánica:
- Subes el commit final, entregas el acceso y envías la última factura.
- El cliente cuestiona el alcance, alega incumplimiento en la entrega o inventa una lista de defectos dos meses después de la aprobación.
- Ellos tienen un abogado en nómina. Tú tienes una cuenta de Gmail y una página de Notion.
El problema de fondo no es que estés equivocado. Es que sin pruebas independientes de lo que se entregó y cuándo, la disputa se reduce a un concurso de credibilidad, y los concursos de credibilidad los gana quien tiene bolsillos más profundos y mejor papeleo.
Timestamp GIT es la red de seguridad automatizada para exactamente esta situación. Es una GitHub App: la instalas una vez en un repositorio y cada commit que haces queda anclado criptográficamente en la blockchain de Bitcoin durante la noche, sin herramientas CLI ni pasos manuales. Tú sigues trabajando con normalidad; la prueba se acumula en segundo plano. Cuando empieza una disputa con un cliente, no discutes sobre fechas: entregas un recibo verificable.
Este artículo se centra en el caso de uso de disputas de pago. Para el panorama más amplio de prueba de anterioridad —trolls de patentes, disputas laborales, defensas de sala limpia— consulta nuestras publicaciones relacionadas al final.
Por qué las pruebas tradicionales fallan en una disputa de pago
La mayoría de los desarrolladores asumen que su historial de Git es una prueba. No lo es, al menos no por sí solo:
- Las fechas de commit de Git no son evidencia confiable. Las fechas de autor y committer son solo metadatos. Cualquiera con acceso de escritura puede reescribir el historial, e incluso sin reescribirlo, un campo de fecha que un desarrollador escribió en su propia máquina no demuestra nada ante un tercero.
- El historial vive en servidores que no controlas. GitHub puede editarse, recibir un force-push o —en el peor de los casos— perder el acceso por completo si el repositorio pertenece al cliente.
- Los hilos de correo y los registros de chat son fáciles de falsificar o eliminar. Una captura de pantalla de un mensaje de Slack tiene muy poco peso.
- Los registros internos se descartan por interesados. En una auditoría legal, “nuestra propia base de datos dice que lo enviamos” es aproximadamente tan persuasivo como una nota escrita a mano.
Los tribunales, mediadores y árbitros buscan algo distinto: pruebas independientes y a prueba de manipulación que un tercero pueda verificar sin tener que confiar en ninguna de las partes.
Eso es lo que te da un anclaje en Bitcoin. Las pruebas de Timestamp GIT se anclan en la blockchain de Bitcoin mediante el protocolo OpenTimestamps. Una vez que un hash queda confirmado en un bloque, ninguna entidad en la tierra puede alterarlo ni falsificarlo, incluida la empresa que opera el servicio. Timestamp GIT podría desaparecer mañana y tu prueba seguiría siendo verificable, sin conexión, por ti o por cualquier otra persona.
El manual: cómo protegerte antes y durante una disputa
1. Antes de que empiece el proyecto: instala la GitHub App
Instala la GitHub App de Timestamp GIT en el repositorio en el que vas a trabajar —el tuyo, o el del cliente con su permiso (más sobre esto en las preguntas frecuentes). Esa es toda la configuración. No hay herramientas CLI que instalar en las máquinas de tus desarrolladores ni cambios en el flujo de trabajo.
En el Modo Estándar, la app solo lee el hash del commit HEAD de los repositorios monitorizados. Requiere acceso de solo lectura al repositorio de origen y acceso de lectura y escritura a un repositorio de destino, que puede ser el mismo repositorio o uno separado.
2. Durante el proyecto: sigue haciendo commits con normalidad
Esta es la parte que importa para una disputa: tus mensajes de commit son la narrativa de la entrega. Haz referencia al contrato.
git checkout -b feature/checkout-flow
git add .
git commit -m "feat: complete checkout flow per SOW section 4.2"
git push origin feature/checkout-flow
Eso es todo lo que haces de forma diferente. Cada noche, Timestamp GIT agrupa los hashes de commit pendientes, crea un manifiesto (.txt) para cada repositorio, construye un árbol de Merkle, genera pruebas de OpenTimestamps usando calendarios públicos y ancla la raíz de Merkle en Bitcoin. El manifiesto y los archivos de recibo .ots se envían de vuelta a tu repositorio en una rama de timestamps dedicada o en un repositorio sombra.
Algo que conviene planificar: la confirmación de Bitcoin suele tardar alrededor de 3 horas, así que los archivos de prueba llegan unas horas después de la ejecución nocturna. No programes tu entrega para la misma noche en que necesitas el recibo.
3. Si surge una disputa: extrae la evidencia
La página de estado de tu repositorio muestra la longevidad de las pruebas, la fecha del anclaje más antiguo, la regularidad diaria y los datos del bloque y la transacción de Bitcoin detrás de cada día. Desde ahí puedes exportar los dos documentos que importan en una discusión de facturación:
# Full audit ledger for the whole engagement, as CSV
curl -L "https://timestampgit.dev/api/audit/youruser/client-project" \
-o audit-ledger.csv
# PDF certificate for one specific delivery date
curl -L "https://timestampgit.dev/api/report/youruser/client-project/2026-10-14" \
-o certificate-2026-10-14.pdf
El CSV te da los commits exactos y sus confirmaciones en bloques de Bitcoin: un registro de entrega fecha por fecha. El certificado PDF empaqueta el timestamp de un solo día en un documento que puedes adjuntar a un correo o entregar a un abogado.
4. Presenta la evidencia, no discutas sobre ella
Envía los archivos de recibo .ots y el enlace de verificación. La clave es que el cliente —o su abogado— no tiene que confiar en ti. Pueden comprobar el timestamp de forma independiente contra la blockchain de Bitcoin usando herramientas estándar de OpenTimestamps. Timestamp GIT también ofrece un visor web que recorre la cadena de Merkle multinivel paso a paso, calculando todo localmente en tu navegador para que nadie vea lo que verificas.
5. Para mayor tranquilidad: inserta una insignia de verificación
Las páginas de estado del repositorio ofrecen insignias insertables para tu README. Una insignia visible de “commits anclados a Bitcoin” transmite profesionalidad y, sin decirlo, le indica a una factura que podría ser disputada que el registro de entrega no es algo que se pueda rebatir con argumentos. Las URLs de las insignias y los fragmentos de Markdown ya preparados provienen de la página del repositorio conectado tras la instalación.
Qué evitar en una disputa de pago
- No te apoyes únicamente en el historial de commits de GitHub. Puede alterarse, y se caracterizará como autoinformado.
- No esperes a que empiece una disputa para configurar el timestamping. Una prueba solo es creíble si existía antes del conflicto: la prueba retroactiva es imposible.
- No vuelques todo tu código base al cliente en medio de una disputa. El diseño de conocimiento cero de Timestamp GIT significa que puedes compartir las pruebas de hash y los certificados en lugar del código fuente, a menos que un tribunal ordene lo contrario.
- No improvises la criptografía. Podrías intentar armar manualmente una cadena de pruebas de OpenTimestamps: ese es el camino difícil, y un solo error en el flujo de trabajo te deja sin nada. La GitHub App gestionada se encarga de la detección, el agrupamiento, el anclaje y la entrega de forma automática.
Cómo encaja Timestamp GIT en tu flujo de trabajo
Modo Estándar (GitHub App). Instala una vez, conecta el repositorio, listo. La app detecta nuevos commits mediante webhooks, y los hashes pendientes se ponen en cola para el worker nocturno. Obtienes la entrega automática de pruebas en tu rama de timestamps sin tocar nada.
Modo Enterprise ZK. Para equipos que prefieren que sus hashes nunca salgan de su propia infraestructura, una GitHub Action de 12 líneas se ejecuta en tu entorno y envía solo el hash del commit a la API de Timestamp GIT. En este modo no se requiere acceso de lectura al repositorio de origen: solo instalas la Action.
Autoalojado. Para entornos aislados o altamente regulados, Timestamp GIT se distribuye como imagen de Docker con una licencia de demostración por tiempo limitado disponible a través de la página de Licencia de Docker. Una configuración rápida de Docker Compose tiene este aspecto:
services:
timestampgit:
image: rue1401/timestampgit:prod
ports:
- "8080:8080"
volumes:
- ./data:/app/data
restart: unless-stopped
valkey:
image: valkey/valkey:8
restart: unless-stopped
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
La app queda entonces disponible en http://localhost:8080, y un asistente de configuración te guía para conectar tu GitHub App y configurar la instancia.
Verificación. Cualquiera que sea el modo que uses, la verificación es la misma: descarga el archivo .ots y compruébalo contra la blockchain de Bitcoin con herramientas estándar de OpenTimestamps, o usa el visor y los informes PDF. La prueba se apoya únicamente en SHA-256 y en los datos de bloques de Bitcoin: sin tecnología propietaria, sin dependencia de proveedor.
Los precios siguen la misma línea: Open Source es gratis para repositorios públicos, Pro Agency cuesta $49/mes para repositorios privados, y Enterprise ZK cuesta $199/mes con el flujo de trabajo de la GitHub Action.
Preguntas frecuentes
¿Puedo usar Timestamp GIT si el cliente es dueño del repositorio?
Sí. Puedes instalar la GitHub App en el repositorio del cliente con su permiso, o puedes configurar un repositorio sombra que tú controles. En el Modo Estándar, la app necesita acceso de solo lectura al repositorio de origen y acceso de lectura y escritura a un repositorio de destino (que puede ser el mismo o uno separado). En el Modo Enterprise ZK, una GitHub Action en tu infraestructura envía solo el hash del commit, por lo que no se requiere acceso de lectura al repositorio de origen.
¿Y si el cliente elimina el repositorio?
Tus pruebas están a salvo. Timestamp GIT envía el manifiesto y los archivos de recibo .ots a una rama de timestamps dedicada o a un repositorio sombra que tú controlas. Además, el registro en la blockchain de Bitcoin es permanente e inmutable. Aunque el cliente elimine su repositorio, conservas la prueba criptográfica de tus commits.
¿Cuánto tarda en confirmarse un timestamp?
La confirmación de Bitcoin suele tardar alrededor de 3 horas. Timestamp GIT agrupa los commits cada noche, ancla la raíz de Merkle en una transacción de Bitcoin y luego escribe los archivos de prueba de vuelta en tu repositorio. Tendrás un timestamp verificable unas horas después de la ejecución nocturna.
¿Es Timestamp GIT admisible en un tribunal?
Timestamp GIT proporciona evidencia lista para tribunales usando estándares criptográficos reconocidos mundialmente: hashing SHA-256, el protocolo OpenTimestamps y la blockchain de Bitcoin. Las pruebas son inmutables y verificables de forma independiente por cualquiera. Sin embargo, la admisibilidad depende de la jurisdicción y del contexto legal específico, así que consulta con un abogado cualificado.
Conclusión
Una disputa de pago es un problema de documentación mucho antes de ser un problema legal. Los desarrolladores que cobran son los que pueden señalar un registro que ninguna de las partes controla y decir: esto es lo que existía, y este es el bloque que lo demuestra.
Ese es todo el argumento para instalar la GitHub App antes de tu próximo proyecto en lugar de después de tu próxima factura impagada. Requiere una instalación, no cambia nada en tu flujo de trabajo diario y convierte tu historial de commits normal en evidencia que ningún cliente, abogado o mediador puede rebatir.
Empieza con tu próximo repositorio: gratis para repositorios públicos, y un par de minutos de configuración en cualquier caso.
Publicaciones relacionadas
- OpenTimestamps Alternative: Managed GitHub App for Every Commit
- Self-Hosted Git Timestamps: Docker Setup & License Guide
- GitHub App Blockchain Timestamp Setup: Install Once, Timestamp Forever