Refund Payment

/api/payhub/v1/payment/{paymentId}/refund

Creates and processes a refund for a paid Klarna payment. The endpoint stores a refund request record and sends the refund to Klarna.

Request parameters

{
  "Amount": 10.5,
  "Reason": "Customer requested refund"
}

Responses

{
  "RefundRequestId": 1234,
  "ReferenceCode": "4bf0b8df303a45d59f3dd2dc06e55ccf",
  "Status": "Succeeded",
  "ProviderRefundId": "klarna-refund-12345",
  "PaymentId": 123,
  "RequestedAt": "2026-06-12T09:32:30.0215645Z"
}

{
  "Type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "Title": "Bad Request",
  "Status": 400,
  "Instance": "/api/payhub/v1/payment/123/refund",
  "TraceId": null,
  "Detail": "RefundPayment is currently supported only for Klarna payments",
  "Errors": null
}

{
  "Type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.3",
  "Title": "Forbidden",
  "Status": 403,
  "Instance": "/api/payhub/v1/payment/123/refund",
  "TraceId": null,
  "Detail": "You are not authorized to refund this payment",
  "Errors": null
}

{
  "Type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.4",
  "Title": "Not Found",
  "Status": 404,
  "Instance": "/api/payhub/v1/payment/123/refund",
  "TraceId": null,
  "Detail": "Payment request not found for the provided payment ID",
  "Errors": null
}

{
  "Type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.8",
  "Title": "Conflict",
  "Status": 409,
  "Instance": "/api/payhub/v1/payment/123/refund",
  "TraceId": null,
  "Detail": "Failed to refund payment with Klarna",
  "Errors": 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/123/refund",
  "TraceId": null,
  "Detail": "An error occurred while processing the refund",
  "Errors": null
}

Last modified: 17 June 2026