User
Actualizar perfil
Actualizar los datos del perfil del usuario autenticado.
PUT /user/update
Actualiza los datos del perfil del usuario autenticado. Tambien acepta POST.
Autenticacion
Bearer Token (Authorization: Bearer {token}).
Request
curl -X PUT https://api.qvapay.com/user/update \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"name": "Juan",
"lastname": "Perez",
"bio": "Desarrollador",
"address": "La Habana, Cuba",
"twitter": "juanperez",
"telegram": "juanperez"
}'Parametros
| Parametro | Tipo | Requerido | Descripcion |
|---|---|---|---|
name | string | No | Nombre del usuario |
lastname | string | No | Apellido del usuario |
bio | string | No | Biografia o descripcion |
address | string | No | Direccion del usuario |
twitter | string | No | Usuario de Twitter |
telegram | string | No | Usuario de Telegram |
p2p_message | string | No | «Mensaje P2P»: se muestra al inicio del chat en todas tus ofertas (máx. 300 caracteres, URLs eliminadas). Solo cuentas GOLD: si tu cuenta no es GOLD se ignora sin error y la respuesta lo indica en ignored. Vaciarlo ("") sí lo puede cualquier cuenta |
cip | object | No | Datos de identidad del programa CIP (persona de EE. UU., SSN/ITIN y dirección estructurada). Ver «Objeto cip» más abajo |
Response
{
"result": "OK"
}Si algún campo no se guardó porque tu cuenta no tiene acceso, la respuesta lo lista en ignored:
{
"result": "OK",
"ignored": ["p2p_message"]
}Errores
| Codigo | Descripcion |
|---|---|
400 | Error actualizando el usuario |
401 | No autorizado o token invalido |
Objeto cip
Datos de identidad requeridos por el programa de identificación de clientes (BSA § 1022.210). Se guardan en la ficha KYC; el SSN/ITIN se cifra en el servidor y nunca se devuelve (GET /user/cip solo expone los últimos 4 dígitos).
{
"cip": {
"us_person": true,
"ssn": "123456789",
"addr_line1": "818 Leahy Cir",
"addr_line2": "",
"addr_city": "Dover",
"addr_state": "DE",
"addr_postal": "19901",
"addr_country": "US"
}
}| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
us_person | boolean | Sí | Persona de EE. UU. (ciudadana, residente o con obligación fiscal). false borra el SSN guardado |
ssn | string | Si us_person y aún no hay uno guardado | SSN o ITIN de 9 dígitos (con o sin guiones). Omitir el campo conserva el guardado; enviarlo vacío lo borra |
addr_line1, addr_city, addr_state, addr_postal, addr_country | string | Si us_person | Dirección de EE. UU.: addr_state es el código de 2 letras, addr_postal ZIP 12345 o 12345-6789, addr_country siempre US. Para no-US basta calle, ciudad y país |
addr_line2 | string | No | Apartamento, unidad… |
Respuesta 400 con el mensaje de validación si falta algo. Guardar un SSN ya usado por otra cuenta no falla, pero queda marcado para revisión. Una vez completa la ficha, la cuenta puede verificar su SSN con POST /user/cip/verify-ssn.