退款

接口信息

POST /payment/{apiKey}/refund

• 路径参数：apiKey（商户 API Key）
• 频率限制：30次 / 60秒

请求参数

参数名	类型	长度	必填	参与签名	说明
transactionOrderId	String	200	条件必填	是	交易订单 ID（与 relationId 至少传一个）
relationId	String	200	条件必填	是	关联 ID（与 transactionOrderId 至少传一个）
merchantId	String	200	是	是	商户号
refundAmount	String	(12,2)	是	是	退款金额
sign	String	text	是	否	签名

响应参数

字段	类型	说明
data.transactionOrderId	String	交易订单 ID
data.relationId	String	关联 ID
data.refundTransactionId	String	退款交易 ID
data.status	String	订单状态
data.payAmount	String	退款金额
data.currency	String	货币
data.merchantId	String	商户号

请求示例

{
  "merchantId": "2525555",
  "transactionOrderId": "299322820280791041",
  "relationId": "39d9663d29d9628999",
  "refundAmount": "199",
  "sign": "457b004eb1428c0523f29156f6b4a3f13b235dceb62be9a9e7d993180d2566a3"
}

响应示例

{
  "rtn_code": "0000",
  "success": true,
  "data": {
    "transactionOrderId": "299280419653005313",
    "relationId": "39d966329d9628999",
    "refundTransactionId": "R299967593620742144",
    "status": "100000",
    "payAmount": "199",
    "currency": "USD",
    "merchantId": "202304225878"
  }
}