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
statussigue siendoopen, pero no aparece en el listado del mercado. - Nadie puede tomarla:
applyresponde409 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ámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
uuid | string | Sí | UUID de la oferta P2P |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
paused | boolean | Sí | 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:
| Valor | Significado |
|---|---|
null | La 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ódigo | Descripción |
|---|---|
400 | Falta paused o no es booleano |
401 | Token de autenticación inválido o ausente |
403 | No eres el creador de la oferta, o tu token/app no tiene permiso para ese lado del P2P |
404 | Oferta P2P no encontrada |
409 | La oferta está cancelada |
429 | Demasiadas solicitudes (límite: 5 por minuto) |
503 | No se pudo guardar el cambio; inténtalo de nuevo |