Cancel Payment Request

/api/payhub/v1/payment/request/{paymentRequestId}

Updates a Klarna payment request status to 'canceled' before the customer completes the payment. Only the merchant who created the payment request can cancel it.

Request parameters

{
  "Status": "canceled"
}

Responses

{}

{
  "Type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "Title": "Bad Request",
  "Status": 400,
  "Instance": "/api/payhub/v1/payment/request/123",
  "TraceId": null,
  "Detail": "Payment request is not a Klarna payment",
  "Errors": [
    {
      "Name": "Provider",
      "Reason": "Cancellation is only supported for Klarna payments",
      "Code": null,
      "Severity": null
    }
  ]
}

{
  "Type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.3",
  "Title": "Forbidden",
  "Status": 403,
  "Instance": "/api/payhub/v1/payment/request/123",
  "TraceId": null,
  "Detail": "You are not authorized to cancel this payment request",
  "Errors": [
    {
      "Name": "Authorization",
      "Reason": "Payment request belongs to a different merchant",
      "Code": null,
      "Severity": null
    }
  ]
}

{
  "Type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.4",
  "Title": "Not Found",
  "Status": 404,
  "Instance": "/api/payhub/v1/payment/request/123",
  "TraceId": null,
  "Detail": "Payment request not found",
  "Errors": [
    {
      "Name": "PaymentRequest",
      "Reason": "No payment request found with the given ID",
      "Code": null,
      "Severity": null
    }
  ]
}

{
  "Type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.8",
  "Title": "Conflict",
  "Status": 409,
  "Instance": "/api/payhub/v1/payment/request/123",
  "TraceId": null,
  "Detail": "Payment request cannot be cancelled",
  "Errors": [
    {
      "Name": "Status",
      "Reason": "Payment request is already cancelled or completed",
      "Code": null,
      "Severity": null
    }
  ]
}

{
  "Type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "Title": "One or more errors occurred.",
  "Status": 500,
  "Instance": "/api/payhub/v1/payment/request/123",
  "TraceId": null,
  "Detail": "Failed to cancel payment request",
  "Errors": [
    {
      "Name": "Server",
      "Reason": "Internal server error",
      "Code": null,
      "Severity": null
    }
  ]
}

Last modified: 17 June 2026