Confirmar Recepción P2P

`POST /p2p/:uuid/received`

Confirma la recepción del pago en fiat y completa la oferta P2P. Los fondos en QUSD se liberan al destinatario con una comisión del 0.25% (exenta para usuarios con Golden Check). Solo puede ser ejecutado por quien recibe el fiat.

Autenticación

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

Request

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

Parámetros (URL)

Parámetro	Tipo	Requerido	Descripción
`uuid`	string	Sí	UUID de la oferta P2P

Quién puede confirmar recepción

Tipo de oferta	Quién recibe fiat	Quién confirma
`sell`	Creador (User)	Creador (User)
`buy`	Peer	Peer

Comisión

Se aplica una comisión del 0.25% sobre el monto de la operación. Los usuarios con Golden Check están exentos de esta comisión.

Response (201)

{
  "message": "P2P Recibido",
  "p2p": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "amount": 49.88,
  "fee": 0.12,
  "gross_amount": 50.00
}

Campo	Tipo	Descripción
`p2p`	string	UUID de la oferta completada
`amount`	number	Monto neto acreditado (después de comisión)
`fee`	number	Monto de la comisión cobrada
`gross_amount`	number	Monto bruto de la operación

Webhook

Si la oferta tiene un webhook configurado, se enviará un POST con:

{
  "operation": "completed",
  "p2p": {
    "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "type": "buy",
    "coin": "BANK_CUP",
    "amount": 50.00,
    "receive": 12500.00,
    "status": "completed",
    "updated_at": "2024-06-20T15:00:00.000Z"
  }
}

Errores

Código	Descripción
`400`	P2P no habilitado
`401`	Token de autenticación inválido o ausente
`403`	No tienes permisos para completar esta oferta, o la oferta no está en un estado válido
`404`	Oferta P2P no encontrada
`409`	La oferta ya fue completada, ya no está disponible, o los participantes cambiaron
`429`	Demasiadas solicitudes (límite: 1 cada 5 segundos)
`500`	Error interno al procesar la transacción

On this page