Comentarios de una Transacción
Notas privadas entre las dos partes de una transacción (quien paga y quien recibe).
Las dos partes de una transacción pueden dejarse comentarios sobre ella: "pago del alquiler de octubre", "te falta el recibo", etc. Solo el pagador y el receptor de esa fila los ven; la otra parte recibe una notificación push y por Telegram cuando se publica uno nuevo. Nadie más (ni una app de comercio con sus propias credenciales) puede leerlos.
Límites: 600 caracteres por comentario, 100 comentarios por transacción, 10 publicaciones por minuto por cuenta.
Autenticación
Bearer Token del usuario (sesión). No se aceptan credenciales de App.
GET /transaction/:uuid/comments
Lista los comentarios, del más antiguo al más nuevo.
curl -X GET "https://api.qvapay.com/transaction/7c9e6679-7425-40de-944b-e07fc1f90ae7/comments" \
-H "Authorization: Bearer <token>"Response
{
"data": [
{
"uuid": "2f1c3a8e-9d0b-4e4a-8f2a-6b1e2c3d4e5f",
"body": "Pago del alquiler de octubre",
"source": "web",
"created_at": "2026-10-22T14:03:11.000Z",
"mine": true,
"author": {
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"username": "johndoe",
"name": "John",
"lastname": "Doe",
"image": "profiles/550e8400.png",
"vip": false,
"golden_check": true
}
}
],
"max": 100,
"max_length": 600
}mine indica si el comentario es de quien consulta. source es web o import (comentario que una versión anterior de la web guardaba solo en el navegador y se migró al servidor).
POST /transaction/:uuid/comments
Publica un comentario. La otra parte recibe la notificación.
curl -X POST "https://api.qvapay.com/transaction/7c9e6679-7425-40de-944b-e07fc1f90ae7/comments" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"body": "Pago del alquiler de octubre"}'Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
body | string | Si | Texto plano, hasta 600 caracteres |
Response
201 Created con el comentario en data, con la misma forma que en el listado.
Errores
| Código HTTP | code | Descripción |
|---|---|---|
| 400 | COMMENT_EMPTY | Texto vacío |
| 400 | COMMENT_TOO_LONG | Más de 600 caracteres (max_length en la respuesta) |
| 404 | — | La transacción no existe o no eres una de sus partes |
| 409 | COMMENTS_LIMIT | La transacción ya tiene 100 comentarios |
| 429 | — | Más de 10 comentarios por minuto |
| 503 | COMMENTS_UNAVAILABLE | Comentarios temporalmente no disponibles |
DELETE /transaction/:uuid/comments/:comment
Borra un comentario propio. Un comentario de la otra parte responde 403.
curl -X DELETE "https://api.qvapay.com/transaction/7c9e6679-7425-40de-944b-e07fc1f90ae7/comments/2f1c3a8e-9d0b-4e4a-8f2a-6b1e2c3d4e5f" \
-H "Authorization: Bearer <token>"Response
{ "data": { "uuid": "2f1c3a8e-9d0b-4e4a-8f2a-6b1e2c3d4e5f", "deleted": true } }