Idioma
Consultar y cambiar el idioma en el que QvaPay le escribe al usuario.
Cada cuenta tiene un idioma: español (es), inglés (en) o portugués (pt). Hoy decide en qué idioma salen los correos que ya están traducidos (acceso y seguridad, depósitos, retiros, transferencias, P2P y compras por PIX); el resto llega en español.
Si el usuario no elige nada, el idioma se deduce en este orden:
- El idioma del dispositivo o del navegador, cuando es español o portugués.
- El país del documento verificado; si no hay, la nacionalidad o la dirección.
- El idioma del dispositivo o del navegador, cuando es inglés.
- Español.
Las apps pueden guardar la elección del usuario con POST /user/locale y deben mandar el locale del dispositivo al registrar el token de push, que es de donde sale el idioma del dispositivo.
GET /user/locale
Retorna el idioma de la cuenta. No exige KYC.
Autenticacion
Bearer Token (Authorization: Bearer {token}).
Request
curl -X GET https://api.qvapay.com/user/locale \
-H "Authorization: Bearer {token}"Response
{
"locale": "pt",
"source": "user",
"chosen": "pt",
"detected": "es",
"available": [
{ "code": "es", "label": "Español" },
{ "code": "en", "label": "English" },
{ "code": "pt", "label": "Português" }
]
}Campos de respuesta
| Campo | Tipo | Descripcion |
|---|---|---|
locale | string | Idioma que se usa hoy con esta cuenta |
source | string | De dónde sale: user (lo eligió), device, browser, country o default |
chosen | string | null | Lo que eligió el usuario; null si está en automático |
detected | string | Idioma que se usaría en automático |
available | array | Idiomas disponibles, con su nombre para mostrar |
POST /user/locale
Guarda el idioma elegido, o vuelve al automático.
Body
| Campo | Tipo | Descripcion |
|---|---|---|
locale | string | es, en, pt o auto. Acepta también la forma con región (pt-BR, en_US) |
Request
curl -X POST https://api.qvapay.com/user/locale \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{ "locale": "pt" }'Response
200 con el mismo objeto de GET /user/locale, ya con el cambio.
Errores
| Estado | code | Significado |
|---|---|---|
| 400 | LOCALE_INVALID | El idioma no es uno de available ni auto |
| 429 | Más de 10 cambios por minuto | |
| 503 | LOCALE_UNAVAILABLE | No se pudo guardar; reintentar más tarde |