跳到主要内容

申请退款

  • 通过该接口,可以对某笔订单进行全量退款或者传入金额进行部分退款

请求接口

openplt/jx/pj/scene/canteen/gy/refund

公共参数

接口协议 - 公共参数

请求参数

参数必填类型说明
flowNoString流水号
campusIdString园区Id, 未传入时则取配置的园区Id
outTradeNoString商家原始订单号
custIdString用户唯一标识,智慧食堂系统用户全局唯一编码
accountNoString传账户编号,则对该账户进行退款,不传账户ID,按照订单的扣款账户优先级顺序退款
refundAmountNumber退款金额,单位:元,保留2位小数
outRefundNoString商家退款单号,保证唯一
remarkString备注信息

响应参数

参数必填类型说明
resultString结果标志,Y 表示成功,N 表示失败
errCodeString错误代码
errMsgString错误或操作信息
payAmountNumber支付金额
refundAmountNumber退款金额
outTradeNoString支付流水号
accountListJsonArray账户明细列表

accountList 列表

参数必填类型说明
accountNoString账户编号
accountTypeString账户类型
tranIdString交易ID
refundAmountNumber退款金额
balanceNumber账户余额

请求示例

{
"flowNo": "186758332706173380018302",
"campusId": "campusId_1dac56a3eea5",
"custId": "custId_df441c61aa0e",
"accountNo": "accountNo_ce5432118890",
"refundAmount": 0.5,
"outTradeNo": "300202409182222492713480104",
"outRefundNo": "301104678796635894868776855",
"remark": "退款"
}

返回值示例

{
"result": "Y",
"errCode": "",
"errMsg": "",
"payAmount": 1.00,
"refundAmount": 0.50,
"outTradeNo": "300202409182222492713480104",
"accountList": [
{
"accountNo": "accountNo_ce5432118890",
"accountType": "01",
"tranId": "2032_720202409182233233181773490_0",
"refundAmount": 0.5,
"balance": 3.5
}
]
}

错误返回值示例

{
"result": "N",
"errCode": "YCEVIAC03015",
"errMsg": "退款金额【5元】超过可退款金额上限【0.5元】。"
}