---
title: "发起退款/refund"
method: POST
path: "/payin/refund"
tags: ["payin-controller"]
---

# 发起退款/refund

`POST /payin/refund`

## Request body

- RefundRequest — 退款请求对象。
  - `amount` Amount — 金额信息。
    - `currency` string, required — 三字符的[ISO4217货币代码，https://www.iso.org/iso-4217-currency-codes.html]。
    - `value` integer, required — 以自然数表示的 amount 值。默认情况下，此参数的值以最小货币单位为单位。例如，如果货币为 USD，金额为 1.00 USD，则此参数的值设置为 100;或者，如果货币为 JPY 且金额为 ¥1，则将此参数的值设置为 1。
  - `originalReference` string — 原始交易订单号
  - `reason` string — 退款原因
  - `reference` string — 退款订单号

## Response `200`

成功

## Other responses

- `201` — 已创建
- `401` — 未经授权
- `403` — 禁止
- `404` — 未找到

---

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