Contactos

`GET /user/contact`

Retorna los contactos guardados del usuario autenticado. Se puede filtrar para obtener solo los favoritos.

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

curl -X GET https://api.qvapay.com/user/contact \
  -H "Authorization: Bearer {token}"

Para obtener solo los contactos favoritos:

curl -X GET "https://api.qvapay.com/user/contact?favorite=true" \
  -H "Authorization: Bearer {token}"

Parametros (query)

Parametro	Tipo	Requerido	Descripcion
`favorite`	string	No	`"true"` para obtener solo favoritos (max 2, o 6 con GOLD)

Response

{
  "message": "OK",
  "contacts": [
    {
      "id": "123",
      "name": "Juan",
      "favorite": true,
      "Contact": {
        "uuid": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Juan",
        "image": "profiles/uuid/avatar.webp",
        "username": "juan123",
        "kyc": true,
        "vip": false,
        "golden_check": false,
        "phone_verified": true,
        "telegram_verified": false
      },
      "created_at": "2025-01-01T00:00:00.000Z"
    }
  ]
}

Campos de respuesta

Campo	Tipo	Descripcion
`contacts[].id`	string	ID del contacto
`contacts[].name`	string	Nombre asignado al contacto
`contacts[].favorite`	boolean	Si es contacto favorito
`contacts[].Contact`	object	Datos del usuario contacto
`contacts[].Contact.uuid`	string	UUID del contacto
`contacts[].Contact.username`	string	Username del contacto
`contacts[].Contact.kyc`	boolean	Si tiene KYC verificado
`contacts[].Contact.golden_check`	boolean	Si tiene plan GOLD
`contacts[].Contact.phone_verified`	boolean	Si tiene telefono verificado
`contacts[].Contact.telegram_verified`	boolean	Si tiene Telegram vinculado
`contacts[].created_at`	string	Fecha de creacion

`POST /user/contact`

Guarda un nuevo contacto.

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

curl -X POST https://api.qvapay.com/user/contact \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Juan"
  }'

Parametros

Parametro	Tipo	Requerido	Descripcion
`contact_uuid`	string	Si	UUID del usuario a agregar como contacto
`name`	string	No	Nombre personalizado para el contacto

Response

{
  "message": "Contact saved"
}

`DELETE /user/contact`

Elimina un contacto guardado.

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

curl -X DELETE https://api.qvapay.com/user/contact \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "123"
  }'

Parametros

Parametro	Tipo	Requerido	Descripcion
`contact_id`	string	Si	ID del contacto a eliminar

Response

{
  "message": "Contact deleted"
}

`PATCH /user/contact`

Alterna el estado de favorito de un contacto. Los usuarios regulares pueden tener hasta 2 favoritos, los usuarios GOLD hasta 6.

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

curl -X PATCH https://api.qvapay.com/user/contact \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "123"
  }'

Parametros

Parametro	Tipo	Requerido	Descripcion
`contact_id`	string	Si	ID del contacto a marcar/desmarcar como favorito

Response

{
  "message": "Contact favorite updated",
  "favorite": true
}

Errores

Codigo	Descripcion
`400`	Falta el UUID o ID del contacto, o se alcanzo el limite de favoritos
`401`	No autorizado o token invalido
`404`	Contacto o usuario no encontrado
`409`	El contacto ya existe

On this page