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",
  "idempotencyKey": "f4f7d6c0-8f7f-49fc-bd79-1a84e740d8fd"
}

Responses

{
  "refundRequestId": 1234,
  "referenceCode": "4bf0b8df303a45d59f3dd2dc06e55ccf",
  "status": "Succeeded",
  "providerRefundId": "klarna-refund-12345",
  "paymentId": 123,
  "requestedAt": "2026-08-10T11:23:34.5870343Z"
}

{
  "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