---
title: "Refund"
method: POST
path: "/refund"
---

# Refund

`POST /refund`

The Refund API allows you to issue either full or partial refunds for a Gateway Payment.

## Request body

- object
  - `api_secret` string, required — This is the credential that Vendo will use to authenticate your request
  - `is_test` integer, required — Set to 1 if you want to process a test transaction.
  - `merchant_id` integer, required — Your Vendo Merchant ID.
  - `transaction_id` integer, required — The Vendo Transaction ID you received when requesting the payment.
  - `partial_amount` number, float — Optionally specify the amount for the partial refund. The default is to refund the full amount unless this parameter is present.
  - `currency` string — Optional 3-letter currency code of the amount to be refunded. [Currencies](https://docs.vendoservices.com/docs/data-types#currency-codes).

## Response `200`

200

- union
  - object
    - `status` integer
    - `transaction_id` integer
    - `request_id` string
  - object
    - `status` integer
    - `transaction_id` integer
    - `error` object
      - `code` string
      - `message` string
    - `request_id` string

---

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