P2P
Cancelar Oferta P2P
Cancelar una oferta P2P como creador o como contraparte.
POST /p2p/:uuid/cancel
Cancela una oferta P2P. El comportamiento varía según el rol del usuario (creador o peer), el tipo de oferta y su estado actual. Los fondos en custodia se devuelven automáticamente cuando aplica.
Autenticación
Bearer Token (Authorization: Bearer <token> en headers).
Request
curl -X POST "https://api.qvapay.com/p2p/7c9e6679-7425-40de-944b-e07fc1f90ae7/cancel" \
-H "Authorization: Bearer <token>"Parámetros (URL)
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
uuid | string | Sí | UUID de la oferta P2P |
Comportamiento según escenario
| Tipo | Rol | Estado | Resultado |
|---|---|---|---|
sell | Creador | open | Se cancela y se reembolsa el monto al creador |
sell | Creador | processing / paid | Pasa a estado revision |
sell | Peer | processing / paid / revision | Se cancela y vuelve a open sin peer |
buy | Creador | open (sin peer) | Se cancela directamente |
buy | Creador | processing / paid / revision | Se cancela, vuelve a open y se reembolsa al peer |
buy | Peer | processing / paid | Pasa a estado revision |
Las ofertas en estado revision solo pueden ser canceladas por moderadores/admins o por quien paga el fiat.
Response (201)
{
"message": "P2P cancelada",
"p2p": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}Cuando la oferta pasa a revisión:
{
"message": "P2P en revisión",
"p2p": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}Errores
| Código | Descripción |
|---|---|
400 | P2P no habilitado, oferta no está disponible para cancelar, o ya fue completada/cancelada |
401 | Token de autenticación inválido o ausente |
403 | No tienes permisos para cancelar esta oferta |
404 | Oferta P2P no encontrada |
409 | La oferta cambió de estado durante la operación o ya fue cancelada previamente |
429 | Demasiadas solicitudes (límite: 1 cada 20 segundos) |
500 | Error interno al procesar la cancelación |