Enlaces de invitación

Un enlace de invitación sirve para invitar empresas a QvaPay. Cada enlace vale para 10 empresas durante 90 días. Cuando una empresa invitada queda aprobada y factura sus primeros $5,000 USD en cobros a sus clientes, quien la invitó recibe un bono de $50 USD en su saldo, una sola vez por empresa.

Cada persona tiene un solo enlace activo por programa. Cuando se agota, caduca o se revoca, puede generar uno nuevo.

El enlace tiene la forma https://www.qvapay.com/i/{code} y lleva al formulario de registro de empresas. El uso se consume cuando la empresa envía la solicitud.

POST /user/referral-linksCopy Anchor Link

Devuelve el enlace activo del usuario. Si no tiene ninguno, crea uno nuevo.

AutenticaciónCopy Anchor Link

Bearer Token (Authorization: Bearer {token}). Requiere la verificación de identidad (KYC) aprobada.

RequestCopy Anchor Link

curl -X POST https://api.qvapay.com/user/referral-links \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{ "program": "enterprise" }'

ResponseCopy Anchor Link

{
  "data": {
    "uuid": "5d0c6f8e-2b8e-4f0a-9c1e-1d2f3a4b5c6d",
    "code": "K7M3Q9XA",
    "program": "enterprise",
    "max_uses": 10,
    "uses": 3,
    "expires_at": "2027-01-27T12:00:00.000Z",
    "revoked_at": null,
    "created_at": "2026-10-29T12:00:00.000Z",
    "state": "active",
    "url": "https://www.qvapay.com/i/K7M3Q9XA"
  },
  "bonus": { "amount": 50, "threshold": 5000 }
}

Campos de respuestaCopy Anchor Link

GET /user/referral-linksCopy Anchor Link

Devuelve los últimos 10 enlaces del usuario, del más reciente al más antiguo, con los mismos campos. Acepta ?program=enterprise.

curl -X GET "https://api.qvapay.com/user/referral-links?program=enterprise" \
  -H "Authorization: Bearer {token}"

Qué cuenta como facturaciónCopy Anchor Link

Cuentan los cobros de terceros que llegan a las cuentas de la empresa (la del dueño y las de sus miembros) desde que pidió el alta: facturas pagadas, cargos de la API, transferencias recibidas, ventas del marketplace y cobros con tarjeta. No cuentan los depósitos que la empresa se hace a sí misma (cripto, banco o P2P), los pagos entre sus propias cuentas ni los pagos de quien la invitó.

ErroresCopy Anchor Link