---
title: "Refund"
method: POST
path: "/payment/refund"
tags: ["Payment"]
---

# Refund

`POST /payment/refund`

Used to refund a payment. The refund is executed over **paymentTransactionId** (per basket item). You can perform a **full** or **partial** refund for the payment amount.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- RefundPaymentRequest
  - `paymentTransactionId` string, required — Basket item (payment breakdown) identifier (**paymentTransactionId**) to be refunded.
  - `conversationId` string — Unique ID for request/response correlation.
  - `ip` string — IP address the request is sent from.
  - `locale` 'tr' | 'en' — Response language.
  - `price` unknown, required
  - `currency` string — Payment currency.

## Response `200`

Successful response

- RefundPaymentResponse
  - `status` 'success' | 'failure' — Indicates the outcome of the request.
  - `locale` 'tr' | 'en' — Response language.
  - `systemTime` integer — Current **epoch ms** at the time of response.
  - `conversationId` string — Echoes the conversationId sent in the request.
  - `paymentId` string — Payment number.
  - `paymentTransactionId` string — Refunded payment item identifier.
  - `price` unknown
  - `currency` string — Currency.
  - `authCode` string — Authorization (auth) code returned by the bank.
  - `hostReference` string — Reference value provided by the bank for the payment.
  - `refundHostReference` string — Reference value provided by the bank for the refund.
  - `retryable` true | false — Indicates whether the operation can be retried.
  - `signature` string — Signature value that can be used for verification.

## Other responses

- `400` — Error response

---

[API](https://skmtc.net/iyzico/apis/bin-and-installment.md) · [All operations](https://skmtc.net/iyzico/apis/bin-and-installment/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iyzico/bin-and-installment/versions/46976ce5eed9/schema)