---
title: "Refund a payment"
method: POST
path: "/v1/charges/{id}/refunds"
---

# Refund a payment

`POST /v1/charges/{id}/refunds`

Make a refund request for a completed financial charge

## Path parameters

- `id` string, required

## Headers

- `x-user-secret-key` string, required
- `Content-Type` string, required

## Request body

- object
  - `amount` string — The amount to be refunded. Omitting this field will refund the full amount of the transaction.
  - `reference` string — A manually defined reference for the refund. If no value is provided charge.reference is used.
  - `reference2` string — A manually defined reference for the refund. If no value is provided, charge.reference2 is used.
  - `custom_fields` object
    - `any_name` string — The custom fields Object allows you to add any key/value pair to the API request to be returned in the response

## Response `200`

200

- object
  - `status` integer
  - `error` unknown
  - `resource` object
    - `type` string
    - `data` object
      - `_id` string
      - `created_at` string
      - `updated_at` string
      - `company_id` string
      - `user_id` string
      - `amount` integer
      - `currency` string
      - `__v` integer
      - `external_id` string
      - `transactions` object[]
        - `created_at` string
        - `amount` integer
        - `currency` string
        - `_id` string
        - `error_code` unknown
        - `error_message` unknown
        - `gateway_specific_description` unknown
        - `gateway_specific_code` unknown
        - `_source_ip_address` string
        - `service_logs` object[]
        - `status` string
        - `type` string
      - `one_off` boolean
      - `archived` boolean
      - `customer` object
        - `customer_id` string
        - `first_name` string
        - `last_name` string
        - `payment_source` object
          - `source_id` string
          - `type` string
          - `card_name` string
          - `card_number_last4` string
          - `card_number_bin` string
          - `card_scheme` string
          - `expire_month` integer
          - `expire_year` integer
          - `address_country` string
          - `gateway_id` string
      - `capture` boolean
      - `status` string
      - `items` object[]
      - `transfer` object
        - `items` object[]

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/commbank/apis/powerboard-api.md) · [All operations](https://skmtc.dev/commbank/apis/powerboard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/commbank/powerboard-api/revisions/2ef3ed32f8c2/schema)