Skip to Content
QvaPay API
User

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:

  1. El idioma del dispositivo o del navegador, cuando es español o portugués.
  2. El país del documento verificado; si no hay, la nacionalidad o la dirección.
  3. El idioma del dispositivo o del navegador, cuando es inglés.
  4. 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

CampoTipoDescripcion
localestringIdioma que se usa hoy con esta cuenta
sourcestringDe dónde sale: user (lo eligió), device, browser, country o default
chosenstring | nullLo que eligió el usuario; null si está en automático
detectedstringIdioma que se usaría en automático
availablearrayIdiomas disponibles, con su nombre para mostrar

POST /user/locale

Guarda el idioma elegido, o vuelve al automático.

Body

CampoTipoDescripcion
localestringes, 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

EstadocodeSignificado
400LOCALE_INVALIDEl idioma no es uno de available ni auto
429Más de 10 cambios por minuto
503LOCALE_UNAVAILABLENo se pudo guardar; reintentar más tarde