QvaPay API
P2P

Marcar P2P como Pagado

Marcar una oferta P2P como pagada por la parte que realiza el pago en fiat.

POST /p2p/:uuid/paid

Marca una oferta P2P como pagada. Solo puede ser ejecutado por quien realiza el pago en fiat: el creador en ofertas de compra (buy) o el peer en ofertas de venta (sell). La oferta debe estar en estado processing.

Autenticación

Bearer Token (Authorization: Bearer <token> en headers).

Request

curl -X POST "https://api.qvapay.com/p2p/7c9e6679-7425-40de-944b-e07fc1f90ae7/paid" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "tx_id": "REF-123456789"
  }'

Parámetros (URL)

ParámetroTipoRequeridoDescripción
uuidstringUUID de la oferta P2P

Parámetros (body JSON)

ParámetroTipoRequeridoDescripción
tx_idstringIdentificador o referencia del pago realizado (ej: número de transferencia)

Quién puede marcar como pagado

Tipo de ofertaQuién paga fiatQuién marca como pagado
buyCreador (User)Creador (User)
sellPeerPeer

Response (200)

{
  "message": "P2P marcado como pagado"
}

Errores

CódigoDescripción
400P2P no habilitado, tx_id no proporcionado, o la oferta no está en estado processing
401Token de autenticación inválido o ausente
403No tienes permisos para marcar esta oferta como pagada
404Oferta P2P no encontrada
409La oferta cambió de estado o el peer cambió durante la operación
429Demasiadas solicitudes (límite: 1 cada 10 segundos)
500Error interno al actualizar la oferta