QvaPay API
Merchants

Modificar Factura

Modificar una factura de pago existente que aún no ha sido pagada.

POST /v2/modify_invoice

Modifica una factura existente. Solo se pueden modificar facturas con estado pending.

Autenticación

Credenciales de App (app-id + app-secret en headers).

Request

{
  "transaction_uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "amount": 30.00,
  "description": "Compra actualizada",
  "remote_id": "order-12345-v2",
  "webhook": "https://mitienda.com/webhook/qvapay",
  "products": [
    {
      "name": "Producto actualizado",
      "price": 30.00,
      "quantity": 1
    }
  ],
  "expire_at": "2025-01-31T23:59:59.000Z"
}

Parámetros

ParámetroTipoRequeridoDescripción
transaction_uuidstringSiUUID de la transacción a modificar
amountnumberNoNuevo monto (mayor a 0, máximo 100,000)
descriptionstringNoNueva descripción (1-255 caracteres)
remote_idstringNoNuevo identificador externo (1-255 caracteres)
webhookstringNoNueva URL de webhook (URL válida o vacío)
productsarrayNoNueva lista de productos
expire_atstring | nullNoNueva fecha de expiración (si es null, se establece a 30 días)

Response

{
  "app_id": "550e8400-e29b-41d4-a716-446655440000",
  "amount": 30.00,
  "description": "Compra actualizada",
  "remote_id": "order-12345-v2",
  "transaction_uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "expire_at": "2025-01-31T23:59:59.000Z",
  "url": "https://www.qvapay.com/pay/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Errores

CódigoDescripción
400Falta transaction_uuid o datos inválidos
400La transacción no está en estado pending
403La transacción no pertenece a tu app
404Transacción no encontrada