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