---
title: "Create an acquiring refunds"
method: POST
path: "/open-api/v3/acquiring/refunds"
tags: ["Refunds"]
---

# Create an acquiring refunds

`POST /open-api/v3/acquiring/refunds`

A transaction is eligible for a refund only after it has been successfully paid.
 Multiple partial refunds are allowed, but the total refunded amount must not exceed the original transaction amount.
 For multiple partial refunds, only one refund request for the same transaction may be in progress at any given time;
 the next refund can only be initiated after the current one has been completed.

## Request body

- AcquiringPaymentRefundReqDTO
  - `merchantTradeNo` string, required — Merchant-generated order number, globally unique/idempotent
  - `sourceMerchantTradeNo` string, required — Merchant Order Number of the Source Order
  - `amount` string, required — Order amount in string format, up to 6 decimal places
  - `reason` string, required — Reason for Refund

## Response `200`

OK

- AcquiringPaymentRefundResultVO
  - `code` integer — Return code
  - `message` string — Error message
  - `data` AcquiringPaymentRefundVO, required — Refund order object
    - `tradeNo` string — Refund order number
    - `merchantTradeNo` string — Merchant refund order number
    - `amount` number — Order amount
    - `currency` string — Order currency
    - `orderStatus` 'PENDING' | 'READY' | 'PAID' | 'FAILED' | 'CANCELED' | 'REFUNDED' | 'CANCELING' | 'AUTHORIZED' | 'REFUNDING' | 'CAPTURED' | 'CLOSED' — Order status PENDING: Order Creation in Progress READY: Waiting for Customer Payment PAID: Order Paid FAILED: Order Failed CANCELED: Order Canceled by Customer REFUNDED: Order Refunded CANCELING: Order Canceling AUTHORIZED: Order Authorized REFUNDING: Order Refunding CAPTURED: Payment Captured CLOSED: Order Closed (Typically due to Expiration)
    - `orderType` 'UNDEFINED' | 'PAYMENT' | 'REFUND' — Order type
    - `createTime` string — Refund order creation time
    - `completeTime` string — Refund order completion time
    - `merchant` ApiMerchantVO — Merchant information
      - `subMerchantId` string — Sub-merchant ID (acquiring system sub-merchant ID)
    - `description` string — Merchant-provided information, will be returned as-is

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/interlace/apis/core-resource.md) · [All operations](https://skmtc.net/interlace/apis/core-resource/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interlace/core-resource/revisions/29c08a4da357/schema)