---
title: "Start A Refund"
method: POST
path: "/devices/{code}/payment/refund"
tags: ["Device"]
---

# Start A Refund

`POST /devices/{code}/payment/refund`

This operation requires the provided API key to have Processing permission set to 'Admin'.

## Path parameters

- `code` string, required

## Request body

- RefundRequest
  - `transactionAmount` number, required — The amount to be refunded in the currency on the original transaction.
  - `originalTransactionId` integer, required — The identifier of the original transaction to refund. This identifier must correspond to the transaction Id of the original transaction to be refunded.

## Response `202`

Accepted

## Other responses

- `403` — Unauthorized
- `404` — Device Not Found
- `409` — Device Not Listening
- `500` — Internal server error

---

[API](https://skmtc.net/helcim/apis/the-helcim-api.md) · [All operations](https://skmtc.net/helcim/apis/the-helcim-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/helcim/the-helcim-api/versions/345052ca6578/schema)