---
title: "Refund"
method: POST
path: "/payments/refund"
tags: ["Refunds"]
deprecated: true
---

# Refund

`POST /payments/refund`

## Request

- Base URL: `https://api-sandbox.tamara.co`
- URL: `https://api-sandbox.tamara.co/payments/refund`
- Auth: HTTP bearer

> **Deprecated.**

Refund

## Request body

- object
  - `order_id` string, uuid, required: Unique Tamara `order_id` from the response of the creation of the checkout session whether online or in-store.
  - `refunds` object[], required: Array of objects of refund data, broken down by capture_id
    - `capture_id` string, required: Tamara capture_id as a result of a previous capture request for this order.
    - `total_amount` object, required: Total amount to be charged to consumer, not including any discount amount.
      - `amount` number
      - `currency` 'SAR' | 'AED' | 'BHD' | 'KWD' | 'OMR'
    - `refund_id` string: Tamara refund_id as a result of a previous refund request for this order.
    - `tax_amount` object
      - `amount` string
      - `currency` 'SAR' | 'AED' | 'BHD' | 'KWD' | 'OMR'
    - `shipping_amount` object: Shipping amount to be refunded, you have to send the full shipping amount, if any, that has been captured for the 1st refund request.
      - `amount` string
      - `currency` 'SAR' | 'AED' | 'BHD' | 'KWD' | 'OMR'
    - `discount_amount` object
      - `amount` string
      - `currency` 'SAR' | 'AED' | 'BHD' | 'KWD' | 'OMR'
    - `items` object[]
      - `name` string, required: Product name. `<=255 characters`.
      - `quantity` number, required: How many of this specific item is being purchased
      - `reference_id` string, required: The unique id of the item from merchant's side
      - `sku` string, required: Product SKU. **`<= 128 characters`**
      - `item_url` string, uri: URL of the item from merchant's website. **`<= 1024 characters`**
      - `image_url` string, uri: URL to an image of the product that can be later displayed to the customer. **`<= 1024 characters`** <br /> **Size** = 2-3 MB maximum <br /> **Resolution** WxH = 1024xY (the Y height of image should be small).
      - `unit_price` object
        - `amount` number
        - `currency` 'SAR' | 'AED' | 'BHD' | 'KWD' | 'OMR'
      - `tax_amount` object
        - `amount` number
        - `currency` 'SAR' | 'AED' | 'BHD' | 'KWD' | 'OMR'
      - `discount_amount` object
        - `amount` number
        - `currency` 'SAR' | 'AED' | 'BHD' | 'KWD' | 'OMR'
      - `total_amount` object, required
        - `amount` string
        - `currency` 'SAR' | 'AED' | 'BHD' | 'KWD' | 'OMR'
      - `type` string, required

## Response `200`

Refund Successful

- object
  - `order_id` string, uuid
  - `refunds` object[]
    - `refund_id` string
    - `capture_id` string
  - `status` 'fully_refunded' | 'partially_refunded'
  - `refunded_amount` object[]
    - `amount` number
    - `currency` 'SAR' | 'AED' | 'KWD' | 'BHD' | 'OMR'

## Changes

- **2026-11-03** `aa481f4d0218`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tamara/apis/tamara-public-apis-v1-0/changes/payments/refund/post.md)

---

[API](https://skmtc.dev/tamara/apis/tamara-public-apis-v1-0.md) - [All operations](https://skmtc.dev/tamara/apis/tamara-public-apis-v1-0/llms.txt) - [OpenAPI document](https://skmtc.dev/tamara/apis/tamara-public-apis-v1-0/revisions/aa481f4d0218?raw)