Actualizar Payment Request

Actualiza los datos de una solicitud de pago existente. Solo puedes actualizar el monto y la descripción si la solicitud tiene el estado waiting_for_payment (no ha sido pagada ni cancelada).

Endpoint

PATCH /api/v1/payment_requests/:id

Parámetros

amount (float)

Nuevo monto a cobrar en la moneda principal (USD).

---

description (string)

Nueva descripción de la solicitud de pago.

---

Respuesta

Retorna el objeto Payment Request actualizado.

Códigos de estado

• 200 OK - La solicitud se actualizó exitosamente
• 400 Bad Request - Error en los parámetros enviados
• 401 Unauthorized - Error de autenticación
• 404 Not Found - No se encontró la solicitud de pago
• 422 Unprocessable Entity - Error de validación

Ejemplo de solicitud

curl -X PATCH https://api.vesvank.com/api/v1/payment_requests/preq_ol0W4jR1XkDxigONJwzdmPOD \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 35.00,
    "description": "Update description"
  }'

Ejemplo de respuesta

{
  "id": "preq_ol0W4jR1XkDxigONJwzdmPOD",
  "description": "Update description",
  "external_id": "order_010203",
  "token": "PR32a5ef75",
  "status": "waiting_for_payment",
  "created_at": 1747521630,
  "updated_at": 1747585234,
  "main_amount": {
    "amount_cents": 3500,
    "amount": 35.0,
    "currency_iso": "USD"
  },
  "conversion_amount": {
    "amount_cents": 318500,
    "amount": 3185.0,
    "currency_iso": "VES"
  },
  "customer": {
    "id": "cus_Pn4r3mwOX5gDf50zpyKYl7Ze",
    "dni": "V18000014",
    "email": "example14@vesvank.com"
  },
  "rate": {
    "amount_cents": 9100,
    "amount": 91.0,
    "currency_iso": "VES"
  },
  "succeeded_payment_intent": null,
  "pending_payment_intents": [],
  "rejected_payment_intents": [],
  "payment_url": "https://subdomain.vesvank.com/payments_portal/payment_requests/PR32a5ef75"
}