Sign in

v1

latestOpenAPI 3.0.12026-07-24128351404.9 KB
Refunds

Create an 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.

post/open-api/v3/acquiring/refunds

Request body

merchantTradeNostring required

Merchant-generated order number, globally unique/idempotent

sourceMerchantTradeNostring required

Merchant Order Number of the Source Order

amountstring required

Order amount in string format, up to 6 decimal places

reasonstring required

Reason for Refund

Example request

{
  "merchantTradeNo": "d7f9c511-9b7c-4a4c-a3eb-59a28b414d63",
  "sourceMerchantTradeNo": "202506100638470951564431961",
  "amount": "10.0",
  "reason": "out of stock"
}

Response

OK

codeinteger

Return code

messagestring

Error message