QvaPay API
User

Vincular Telegram

Generar el enlace para vincular una cuenta de Telegram al usuario autenticado, y desvincularla

Desde Telegram se puede operar la cuenta, así que vincularla o desvincularla pide el mismo segundo factor que mover saldo: el PIN de 4 dígitos o el código de 6 dígitos de la app autenticadora.

Este endpoint no acepta tokens acotados: solo una sesión completa.

POST /user/verify/telegram

Devuelve un enlace al bot. Caduca a los 10 minutos y sirve una sola vez.

Autenticación

Bearer Token (Authorization: Bearer {token}).

Request

curl -X POST https://api.qvapay.com/user/verify/telegram \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{ "code": "1234" }'
CampoTipoDescripción
codestringPIN de 4 dígitos o código de 6 dígitos

Respuesta

{ "verificationLink": "https://t.me/qvapaysupport_bot?start=..." }

GET /user/verify/telegram

Igual que el POST, sin código. Está pensado para las versiones de la app móvil que aún no lo envían y dejará de estar disponible. Nunca mandes el código en la URL.

PUT /user/verify/telegram

Desvincula el Telegram de la cuenta. Acepta code en el cuerpo, igual que el POST.

curl -X PUT https://api.qvapay.com/user/verify/telegram \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{ "code": "1234" }'

Errores

EstadocodeMotivo
400CODE_REQUIREDFalta el código
400CODE_INVALIDPIN o código incorrecto
400CODE_FORMATEl código no tiene 4 ni 6 dígitos
403Token acotado: este endpoint exige una sesión completa
409La cuenta ya tiene un Telegram vinculado
423CODE_LOCKEDDemasiados códigos incorrectos: espera 30 minutos