---
title: "Estimate refund fee"
method: POST
path: "/payment/v1/payins/{transactionReference}/refund/estimate"
tags: ["Fiat Payments"]
---

# Estimate refund fee

`POST /payment/v1/payins/{transactionReference}/refund/estimate`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/payment/v1/payins/{transactionReference}/refund/estimate`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/payment/v1/payins/:transactionReference/refund/estimate/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns the estimated processing fee and the maximum remaining refundable balance for the pay-in. The fee will be deducted from your wallet when issuing a refund. The fee amount may vary depending on the merchant contract with BVNK.

## Path parameters

- `transactionReference` string, uuid, required

## Request body

- object
  - `value` number, required: Amount in major currency units that will be refunded. Use dot as decimal separator.
  - `currency` 'GBP' | 'USD' | 'EUR', required: Three-letter ISO-4217 currency code.

## Response `200`

Fee estimate returned successfully.

- object
  - `fee` object, required: Projected fee for processing the refund
    - `value` number, required
    - `currency` string, required
  - `maxAvailableToRefund` object, required: Remaining amount that can still be refunded for the pay-in. If no refund was performed, this parameter will be equal to the full amount
    - `value` number, required
    - `currency` string, required

## Other responses

- `400`: Estimate could not be produced because the pay-in is not refundable or the amount is invalid.
- `500`: Unexpected Error

---

[API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/c386d436bf2c?raw)
