Crear Oferta P2P

POST /p2p/createCopy Anchor Link

Crea una nueva oferta P2P de compra o venta. Para ofertas de venta (sell), el monto se deduce automáticamente del saldo del usuario. El usuario debe tener KYC verificado.

AutenticaciónCopy Anchor Link

Bearer Token (Authorization: Bearer <token>) o Credenciales de App (app-id + app-secret en headers).

Cuando se usa Credenciales de App, la oferta se crea en nombre del usuario propietario de la app. Dicho usuario debe cumplir todos los requisitos de P2P (p2p_enabled, KYC verificado, Telegram vinculado y teléfono verificado), y para ofertas de tipo sell el saldo se descuenta de su cuenta.

RequestCopy Anchor Link

Con Bearer Token:

curl -X POST "https://api.qvapay.com/p2p/create" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "buy",
    "coin": "BANK_CUP",
    "amount": 50,
    "receive": 12500,
    "details": [{ "name": "cuenta", "value": "1234567890" }],
    "only_vip": 0,
    "private": 0,
    "message": "Pago rápido",
    "webhook": "https://example.com/webhook"
  }'

Con Credenciales de App:

curl -X POST "https://api.qvapay.com/p2p/create" \
  -H "app-id: {tu-app-uuid}" \
  -H "app-secret: {tu-app-secret}" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "buy",
    "coin": "BANK_CUP",
    "amount": 50,
    "receive": 12500,
    "details": [{ "name": "cuenta", "value": "1234567890" }],
    "only_vip": 0,
    "private": 0,
    "message": "Pago rápido",
    "webhook": "https://example.com/webhook"
  }'

Parámetros (body JSON)Copy Anchor Link

Requisitos para quien apliqueCopy Anchor Link

Con requirements solo podrán aplicar las cuentas que los cumplan:

{ "requirements": { "min_completed": 25, "min_rating": 4.5 } }

Cualquier otro valor responde 400 con code: "INVALID_REQUIREMENTS". Omitir una clave (o mandarla en 0/null) es "sin ese requisito".

La respuesta devuelve requirements (o null).

Response (201)Copy Anchor Link

{
  "msg": "Oferta P2P creada correctamente",
  "p2p": {
    "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "type": "buy",
    "coin": "BANK_CUP",
    "amount": 50.00,
    "receive": 12500.00,
    "only_kyc": 0,
    "private": 0,
    "only_vip": 0,
    "status": "open",
    "details": { "cuenta": "1234567890" },
    "message": "Pago rápido",
    "webhook": "https://example.com/webhook",
    "created_at": "2024-06-20T14:30:00.000Z",
    "updated_at": "2024-06-20T14:30:00.000Z"
  }
}

WebhookCopy Anchor Link

Si se proporciona un webhook, se enviará un POST con el siguiente payload cuando la oferta sea creada:

{
  "operation": "created",
  "p2p": { ... }
}

IdempotenciaCopy Anchor Link

Si se envía idempotency_key y una oferta ya fue creada con esa misma clave, la respuesta es 200 con la oferta original y el campo adicional "duplicate": true (no se crea una segunda oferta ni se debita saldo de nuevo). Si la creación original aún está en proceso, se responde 409 con "code": "DUPLICATE_REQUEST" — reintenta unos segundos después.

ErroresCopy Anchor Link