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" }'| Campo | Tipo | Descripción |
|---|---|---|
code | string | PIN 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
| Estado | code | Motivo |
|---|---|---|
| 400 | CODE_REQUIRED | Falta el código |
| 400 | CODE_INVALID | PIN o código incorrecto |
| 400 | CODE_FORMAT | El código no tiene 4 ni 6 dígitos |
| 403 | Token acotado: este endpoint exige una sesión completa | |
| 409 | La cuenta ya tiene un Telegram vinculado | |
| 423 | CODE_LOCKED | Demasiados códigos incorrectos: espera 30 minutos |