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).
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/paid" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"tx_id": "REF-123456789"
}'Parámetros (URL)
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
uuid | string | Sí | UUID de la oferta P2P |
Parámetros (body JSON)
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
tx_id | string | Sí | Identificador o referencia del pago realizado (ej: número de transferencia). Máximo 191 caracteres: el número de operación, no el recibo completo |
Quién puede marcar como pagado
| Tipo de oferta | Quién paga fiat | Quién marca como pagado |
|---|---|---|
buy | Creador (User) | Creador (User) |
sell | Peer | Peer |
Ofertas por rango
En una oferta con offer_kind: "flexible" esta acción se hace sobre una orden, no sobre la oferta: añade ?order=<uuid de la orden>. Ver Ofertas por rango.
Response (200)
{
"message": "P2P marcado como pagado"
}Errores
| Código | Descripción |
|---|---|
400 | P2P no habilitado, tx_id no proporcionado, o la oferta no está en estado processing |
400 TX_ID_TOO_LONG | tx_id supera los 191 caracteres. La respuesta trae max |
401 | Token de autenticación inválido o ausente |
403 | No tienes permisos para marcar esta oferta como pagada |
404 | Oferta P2P no encontrada |
409 | La oferta cambió de estado o el peer cambió durante la operación |
429 | Demasiadas solicitudes (límite: 1 cada 10 segundos) |
500 | Error interno al actualizar la oferta |