申请退款

对已支付成功的订单发起退款，支持全额退款和部分退款。退款需验证终端操作密码。

请求接口

POST /open/cashier/trans/refund

通用参数

• 请求签名：Authorization Header，详见签名方法
• 客户端信息：Ikudot-Cashier-Client Header，详见客户端信息；

请求参数

参数	必填	类型	说明
pay_no	是	String	支付单号
refund_amount	是	Long	退款金额，单位：分
out_refund_no	否	String	业务退款单号，不传则自动生成
password	是	Object	退款密码，需 AES 加密传输
remark	否	String	退款备注

password 结构（AES 加密数据）

参数	类型	说明
algorithm	String	加密算法，固定为 AES_256_CBC
ciphertext	String	Base64 编码后的密文
iv	String	Base64 编码的初始化向量

响应参数

参数	类型	说明
refund_no	String	退款单号

请求示例

{
  "pay_no": "PAY20260507000001",
  "refund_amount": 50,
  "password": {
    "algorithm": "AES_256_CBC",
    "ciphertext": "Base64编码的密文",
    "iv": "Base64编码的IV"
  },
  "remark": "客户申请退款"
}

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "refund_no": "REF20260507000001"
  }
}