QvaPay API
P2P

Aplicar a Oferta P2P

Aplicar como contraparte a una oferta P2P abierta.

POST /p2p/:uuid/apply

Aplica a una oferta P2P como contraparte (peer). La oferta cambia a estado processing. Para ofertas de compra (buy), el saldo del aplicante se deduce automáticamente. El usuario debe tener KYC verificado.

Autenticación

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

Request

curl -X POST "https://api.qvapay.com/p2p/7c9e6679-7425-40de-944b-e07fc1f90ae7/apply" \
  -H "Authorization: Bearer <token>"

Parámetros (URL)

ParámetroTipoRequeridoDescripción
uuidstringUUID de la oferta P2P

Response (201)

{
  "message": "Aplicado a la oferta",
  "p2p": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "transaction": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

El campo transaction contiene el UUID de la transacción creada (solo para ofertas de tipo buy donde se deduce saldo). Es null para ofertas de tipo sell.

Flujo de aplicación

  • Oferta de compra (buy): El aplicante (vendedor) deposita el monto en QUSD como garantía. Se crea una transacción y se deduce el saldo.
  • Oferta de venta (sell): El aplicante (comprador) no necesita saldo en QUSD. Solo se asigna como peer.

Errores

CódigoDescripción
400P2P no habilitado, KYC requerido, es tu propia oferta, la oferta no está disponible, saldo insuficiente, o límite de ofertas pendientes alcanzado
401Token de autenticación inválido o ausente
403Bloqueo entre usuarios impide aplicar
409La oferta ya no está disponible o ya tiene un peer asignado
429Demasiadas solicitudes (límite: 2 cada 60 segundos)
500Error interno al crear la transacción