QvaPay API
P2P

Pausar Oferta P2P

Sacar una oferta del mercado sin cancelarla, y la pausa automática cuando quien la tomó se va.

POST /p2p/:uuid/pause

Saca tu oferta del mercado al instante sin cancelarla, para corregir la tasa o el monto con calma, y la vuelve a poner cuando quieras. Mientras está pausada:

  • Su status sigue siendo open, pero no aparece en el listado del mercado.
  • Nadie puede tomarla: apply responde 409 OFFER_PAUSED.
  • Puedes editarla normalmente.
  • En una oferta por rango, las órdenes que ya estaban en curso siguen su camino: la pausa solo impide órdenes nuevas.

Solo el creador de la oferta puede pausarla o reactivarla.

Autenticación

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

También puedes llamar a esta ruta con app-id / app-secret en vez de un token de cuenta. Ver Operar con credenciales de app.

Request

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

Parámetros (URL)

ParámetroTipoRequeridoDescripción
uuidstringSíUUID de la oferta P2P

Body

CampoTipoRequeridoDescripción
pausedbooleanSítrue la pausa hasta que la reactives; false la reactiva (también quita la pausa automática)

Response (200)

{
  "message": "Oferta pausada: ya no aparece en el mercado",
  "p2p": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "pause": { "reason": "owner", "until": null }
}

Al reactivar, pause vuelve como null.

Pausa automática

Cuando quien tomó tu oferta se va y la oferta vuelve a quedar libre, la pausamos unos minutos (10 por defecto) antes de que vuelva al mercado y te avisamos por push y Telegram con la tasa publicada. Así, si la tasa estaba mal, tienes tiempo de corregirla antes de que otro la tome. Pasa cuando:

  • la contraparte cancela, se le vence la ventana de pago o un moderador la expulsa (ofertas fijas);
  • una orden se cancela o expira y su parte vuelve a la oferta (ofertas por rango).

Durante esa pausa pause.reason es taker_left y pause.until es la hora en que vuelve sola al mercado. Para reactivarla antes, manda { "paused": false }. La pausa automática nunca acorta una pausa que hayas puesto tú.

El campo pause

El detalle de la oferta y el listado con my=true traen pause:

ValorSignificado
nullLa oferta no está pausada
{ "reason": "owner", "until": null }La pausaste tú; sigue así hasta que la reactives
{ "reason": "taker_left", "until": "2026-10-13T20:10:00.000Z" }Pausa automática; vuelve al mercado en until (ISO 8601, UTC)

Errores

CódigoDescripción
400Falta paused o no es booleano
401Token de autenticación inválido o ausente
403No eres el creador de la oferta, o tu token/app no tiene permiso para ese lado del P2P
404Oferta P2P no encontrada
409La oferta está cancelada
429Demasiadas solicitudes (límite: 5 por minuto)
503No se pudo guardar el cambio; inténtalo de nuevo