QvaPay API
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ámetroTipoRequeridoDescripción
uuidstringUUID de la oferta P2P

Comportamiento según escenario

TipoRolEstadoResultado
sellCreadoropenSe cancela y se reembolsa el monto al creador
sellCreadorprocessing / paidPasa a estado revision
sellPeerprocessing / paid / revisionSe cancela y vuelve a open sin peer
buyCreadoropen (sin peer)Se cancela directamente
buyCreadorprocessing / paid / revisionSe cancela, vuelve a open y se reembolsa al peer
buyPeerprocessing / paidPasa 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ódigoDescripción
400P2P no habilitado, oferta no está disponible para cancelar, o ya fue completada/cancelada
401Token de autenticación inválido o ausente
403No tienes permisos para cancelar esta oferta
404Oferta P2P no encontrada
409La oferta cambió de estado durante la operación o ya fue cancelada previamente
429Demasiadas solicitudes (límite: 1 cada 20 segundos)
500Error interno al procesar la cancelación