1.7 线上-退款

公共参数

serviceCode 填 GXFWCP.A5772

1.7.1 业务请求参数（bizData）

参数	类型	长度	必填	描述	示例值	说明
mercOrderNo	String	64	是	商户订单	TRF202110030000000000000000350	商户侧生成的该笔退款单的单号；备注：该笔单号请保持每笔唯一，该单号防重；
merchantNo	String	32	是	商户号	FM0000000000801	入驻商户号
origMercOrderNo	String	64	是	原落单商户订单号	TPO202110030000000000000000349	落单接口中商户侧订单号值：mercOrderNo
orderAmount	String	50	是	订单金额	19988	单位分; 100=1元交易金额，不允许有小数点，取值范围为[1，99999999999999]，如199.88元，则此域为19988, 退款金额说明：1：可以进行全额退，传全部退款金额；2：可以进行部分退款，传部分退款金额，
orderDesc	String		否	订单描述信息	用户退货	用于描述退款原因
productArea	String		否	退款商品域	传jsonArray字符串	[{"productNo": "202501","productName": "222","productAmount": "30","productNum:": "10""}]" ，传json串，具体见报文示示例
productDesc	String	512	否	退款商品描述
backNotifyUrl	String		否	后台通知地址	https://merchant.com/service/backEndNotify.do	分配值
refundType	String		是	退款类型	FULL	refundType枚举值如下：1：全额退款模式:FULL 2：部分退款模式:PART
storeId	String		是	商户门店编号	567175705
storeName	String		是	商户门店名称	FM0000000000801
storeArea	String		是	商户门店区域	FM0000000000801
ext	String	1000	否	拓展域
sscUid	String	64	否	饭卡通平台用户Id		饭卡通平台联登时提供,回传
mobile	String	11	否	手机号码		饭卡通平台联登时提供手机号，回传
canteenNo	String	64	否	食堂编号	S05145265	食堂编号, 如有回传
cardNo	String	64	否	饭卡卡号		如果有就传

报文示例

{
  "ext": "",
  "terminalNo": "",
  "operatorNo": "",
  "mercOrderNo": "TRF202110030000000000000000350",
  "storeId": "567175705",
  "origMercOrderNo": "TPO202110030000000000000000349",
  "refundType": "FULL",
  "backNotifyUrl": "",
  "orderAmount": "19988",
  "productArea": "",
  "productDesc": "IphoneX",
  "storeName": "",
  "orderDesc": "用户退货",
  "storeArea": "",
  "merchantNo": "FM0000000000801"，
  "sscUid":"20240525001",
  "mobile":"18758005800",
  "canteenNo":""，
  "cardNo":""  
}

1.7.2 业务响应参数（bizData）

参数	类型	长度	必填	描述	示例值	说明
respCode	String	6	是	应答码	000000	返回000000时，由orderStatus判断状态。
respMsg	String	200	是	应答码描述	操作成功	具体返回枚举值待补充
busiOrderNo	String	64	否	业务单号	20210918000000000000000000000000000187
orderCompleteTime	String	18	否	交易完成时间	20240308120000	格式：yyyyMMddHHmmss
orderStatus	String	25	否	订单状态	00	枚举值如下：订单状态: 00 成功 02 处理中 03 失败
failCode	String	25	否	失败原因编码		订单状态为失败时存在
failMemo	String	25	否	失败原因描述		订单状态为失败时存在
paymentDetail	JSONArray	10	否	支付明细
payInstrument	String	10	否	支付工具	WLT-b4	枚举值详见1.4.3 附录
subPayAmt	String	10	否	支付工具金额	100	单位：分

报文示例

{
  "orderCompleteTime": "20240308120000",
  "failCode": "",
  "respMsg": "操作成功",
  "orderStatus": "00",
  "busiOrderNo": "20230720000000000000000000000001386614",
  "respCode": "000000",
  "failMemo": ""
}

1.7.3 附录

支付机构	支付机构枚举
饭卡	f1

公共参数#

1.7.1 业务请求参数（bizData）#

1.7.2 业务响应参数（bizData）#

1.7.3 附录#

公共参数

1.7.1 业务请求参数（bizData）

1.7.2 业务响应参数（bizData）

1.7.3 附录