Payment Links

`GET /user/payment-links`

Obtiene todos los enlaces de pago del usuario autenticado, ordenados por fecha de creación descendente.

Autenticación

Bearer Token en header Authorization.

Request

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

Con filtro por producto:

curl -X GET "https://api.qvapay.com/user/payment-links?product_id=abc123" \
  -H "Authorization: Bearer {tu-token}"

Parámetros

Parámetros de query opcionales.

Parámetro	Tipo	Requerido	Descripción
`product_id`	string	No	Filtra los enlaces por identificador de producto

Response

[
  {
    "id": "1",
    "name": "Suscripción mensual",
    "product_id": "prod_001",
    "amount": 9.99,
    "created_at": "2026-03-17T12:00:00.000Z",
    "updated_at": "2026-03-17T12:00:00.000Z"
  }
]

Campos de respuesta

Campo	Tipo	Descripción
`id`	string	Identificador único del enlace de pago
`name`	string	Nombre del enlace de pago
`product_id`	string	Identificador del producto asociado
`amount`	number	Monto del enlace de pago
`created_at`	string	Fecha de creación (ISO 8601)
`updated_at`	string	Fecha de última actualización (ISO 8601)

Errores

Código	Descripción
`401`	No autorizado — token inválido o ausente

`POST /user/payment-links`

Crea un nuevo enlace de pago.

Autenticación

Bearer Token en header Authorization.

Request

curl -X POST https://api.qvapay.com/user/payment-links \
  -H "Authorization: Bearer {tu-token}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Suscripción mensual",
    "product_id": "prod_001",
    "amount": 9.99
  }'

Parámetros

El body debe enviarse como JSON.

Parámetro	Tipo	Requerido	Descripción
`name`	string	Si	Nombre del enlace de pago
`product_id`	string	Si	Identificador del producto asociado
`amount`	number	Si	Monto del enlace de pago (debe ser un número positivo)

Response

{
  "id": "1",
  "name": "Suscripción mensual",
  "product_id": "prod_001",
  "amount": 9.99,
  "created_at": "2026-03-17T12:00:00.000Z",
  "updated_at": "2026-03-17T12:00:00.000Z"
}

Campos de respuesta

Campo	Tipo	Descripción
`id`	string	Identificador único del enlace de pago
`name`	string	Nombre del enlace de pago
`product_id`	string	Identificador del producto asociado
`amount`	number	Monto del enlace de pago
`created_at`	string	Fecha de creación (ISO 8601)
`updated_at`	string	Fecha de última actualización (ISO 8601)

Errores

Código	Descripción
`400`	Datos inválidos — faltan campos requeridos o el monto no es un número positivo
`401`	No autorizado — token inválido o ausente

`DELETE /user/payment-links`

Elimina un enlace de pago existente del usuario autenticado.

Autenticación

Bearer Token en header Authorization.

Request

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

Parámetros

El body debe enviarse como JSON.

Parámetro	Tipo	Requerido	Descripción
`id`	string	Si	Identificador del enlace de pago a eliminar

Response

{
  "message": "Payment link deleted"
}

Errores

Código	Descripción
`400`	Falta el campo `id` en el body
`401`	No autorizado — token inválido o ausente
`404`	Enlace de pago no encontrado o no pertenece al usuario

On this page