申请退款

退款接口可支持全额退款及部分退款

请求接口

openplt/jx/pay/trans/refund

公共参数

接口协议 - 公共参数

请求参数

参数payNo、outTradeNo、transactionId参数必须三选一，至少传一个。优先级：payNo > outTradeNo > transactionId

参数	必填	类型	说明
payNo	否	String(64)	聚合支付订单号
outTradeNo	否	String(64)	业务系统订单号
transactionId	否	String(64)	渠道交易流水号，可传收款记录的条形码单号、第三方支付交易流水号。如明确是聚合支付订单号的，请使用payNo字段。注意：如使用了多级间连支付渠道，有可能获取不到订单。
outRefundNo	是	String(64)	业务系统退款订单号，业务方保证唯一
refundAmount	是	Number	退款金额，单位：元
remark	否	String(127)	退款备注/退款原因

响应参数

名称	必填	类型	说明
refundNo	是	String	退款订单号
status	是	int	退款状态

content请求示例

{
  "payNo": "payNo_09f68fd4e5ff",
  "outTradeNo": "outTradeNo_a5987271ba94",
  "transactionId": "transactionId_ef25e8c73ab5",
  "outRefundNo": "outRefundNo_240d36f1a9fc",
  "refundAmount": 0.01,
  "remark": "remark_1bd21c283885"
}

result返回值示例

{
  "payNo": "payNo_4760b7ed2ad8",
  "outTradeNo": "outTradeNo_eb864a63bfb5",
  "transactionId": "transactionId_b40e897a4ac2",
  "chTransactionId": "chTransactionId_c13e4dcf3d3a",
  "subject": "subject_4f7bbe5760c3",
  "payment": "ABC",
  "amount": 0.00,
  "payTime": "2025-09-16 17:50:32",
  "succTime": "2025-09-16 17:50:32",
  "status": 100,
  "attach": "attach_aca6c1620c3a",
  "resultMsg": "resultMsg_d8335e5ad430"
}