Transactions
Pagar Transacción
Pagar una factura o transacción pendiente de otro usuario.
POST /transaction/:uuid/pay
Paga una transacción pendiente creada por otro usuario o aplicación. El monto se deduce de tu balance y se acredita al creador de la transacción. Si la transacción tiene un webhook configurado, se envía una notificación al comercio.
Autenticación
Bearer Token (Authorization: Bearer <token> en headers).
Request
curl -X POST "https://api.qvapay.com/transaction/7c9e6679-7425-40de-944b-e07fc1f90ae7/pay" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"comment": "Pago realizado"
}'Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
uuid | string | Si | UUID de la transacción a pagar (en la URL) |
comment | string | No | Comentario o nota del pago |
Response
{
"message": "Transacción pagada correctamente",
"transaction": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
message | string | Mensaje de confirmación |
transaction | string | UUID de la transacción pagada |
Errores
| Código | Descripción |
|---|---|
400 | Transacción ya pagada, factura expirada o balance insuficiente |
401 | Token de autenticación inválido o ausente |
403 | No puedes pagar tu propia transacción |
404 | Transacción no encontrada |
500 | Error interno al procesar el pago |