Metodos de pago

`GET /user/payment-methods`

Retorna los metodos de pago guardados del usuario autenticado.

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

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

Se puede filtrar por moneda usando el parametro coin:

curl -X GET "https://api.qvapay.com/user/payment-methods?coin=TRC20" \
  -H "Authorization: Bearer {token}"

Parametros (query)

Parametro	Tipo	Requerido	Descripcion
`coin`	string	No	Filtrar por ticker de moneda (ej: `TRC20`, `BTC`)

Response

[
  {
    "id": "123",
    "name": "Mi wallet TRC20",
    "details": "TRx1234567890abcdef",
    "created_at": "2025-01-01T00:00:00.000Z",
    "updated_at": "2025-01-01T00:00:00.000Z",
    "coin": {
      "name": "Tron USDT",
      "tick": "TRC20",
      "logo": "coins/trc20.png"
    }
  }
]

Campos de respuesta

Campo	Tipo	Descripcion
`id`	string	Identificador del metodo de pago
`name`	string	Nombre descriptivo
`details`	string	Detalles del metodo (direccion, cuenta, etc.)
`created_at`	string	Fecha de creacion
`updated_at`	string	Fecha de actualizacion
`coin`	object	Informacion de la moneda asociada
`coin.name`	string	Nombre de la moneda
`coin.tick`	string	Ticker de la moneda
`coin.logo`	string	Ruta del logo de la moneda

`POST /user/payment-methods`

Crea un nuevo metodo de pago guardado.

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

curl -X POST https://api.qvapay.com/user/payment-methods \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "coin": "TRC20",
    "name": "Mi wallet TRC20",
    "details": "TRx1234567890abcdef"
  }'

Parametros

Parametro	Tipo	Requerido	Descripcion
`coin`	string	Si	Ticker de la moneda (ej: `TRC20`, `BTC`)
`name`	string	Si	Nombre descriptivo del metodo de pago
`details`	string	Si	Detalles del metodo (direccion, numero de cuenta, etc.)

Response (201)

{
  "id": "123",
  "name": "Mi wallet TRC20",
  "coin": "TRC20",
  "details": "TRx1234567890abcdef",
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}

`DELETE /user/payment-methods`

Elimina un metodo de pago guardado.

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

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

Parametros

Parametro	Tipo	Requerido	Descripcion
`id`	string	Si	ID del metodo de pago a eliminar

Response (201)

{
  "message": "Payment method deleted"
}

Errores

Codigo	Descripcion
`400`	Datos invalidos (faltan campos requeridos)
`401`	No autorizado o token invalido
`404`	Moneda o metodo de pago no encontrado

On this page