契约：
post /pai/createRefundOrder
Request Parameters
newBaseData
| 名字 |
类型 |
描述 |
是否可选 |
| version |
String(6) |
服务版本号，默认填写：2，其他版本请与和我们联系确认； |
NO |
| platform |
String(10) |
最终支付来源,即请求支付的商户（每个渠道）使用何种方式调用开放平台支付 H5/Online/Native SDK/Offline/Android/iOS |
NO |
| request_id |
String(64) |
请求信息标识，请求支付的商户（每个渠道）应保持唯一，即：前端发起的一笔支付交易请求流水，非全局的）；不同渠道的这个id，可以重复的； |
NO |
| out_user_id |
String(64) |
连尚账户相关：union_id...uhid... |
YES 二选一可为空 |
| guest_id |
String(64) |
1.CP方给出的：openid ；用openid + unionid 在支付端进行 查询连尚统一账户信息：uhid； 2.游客：传给定值：GUESTER |
YES 二选一可为空 |
| client_user_id |
String(64) |
1.游客时：游戏cp方必传该字段；2.cp方定义的用户id；其他接入渠道不是必传项 |
NO |
| service_name |
String(32) |
服务名称，创建退款请求服务为："CreateRefundOrder” |
NO |
| language |
Int |
语言 填0=中文 |
YES |
| merchant_id |
String(32) |
支付平台商户（渠道）ID，第三方接入开放平台支付前向开放平台支付申请获得（支付平台配置的渠道号，比如：pay001：游戏渠道001） |
NO |
| time_stamp |
String(14) |
时间戳(请求时的时间),格式yyyyMMddHHmmss，如 2015年03月29号17点01分36秒 对应字符串为：20180329170136 |
NO |
| compress_type |
String(2) |
压缩类型：0（不压缩），1（gzip） |
NO |
newBizData
| 名字 |
类型 |
描述 |
是否可选 |
| refund_type |
String(32) |
支付方式: cash \ coin \ mixed \ credit cash \ |
NO |
| refund_way |
String(256) |
限制用于支付的银行，如限制只是用浦发银行进行支付，可以限制支持多个银行支付，传递多个BrandID（BrandID：支付品牌ID，BrandName：支付品牌名称，bankID：支付行），使用逗号分割（CCB_kj,acbc_kj） |
YES |
| refund_msg |
String(256) |
退款原因 |
NO |
| refund_auditor |
String(20) |
退款审核人信息 |
YES |
| refund_portion |
String(10) |
part ：部分退款、all ：全部退 |
YES |
| refund_strong_check |
String(10) |
yes：须强校验、no:弱校验：只做金额比对，即可退款；强校验：比对明细、原交易价格等等； |
YES |
| settlement_id |
String(32) |
结算方标识,向开放平台申请时获得 |
YES |
| appid |
String(32) |
游戏传 appid |
NO |
| out_trade_id |
String(64) |
退款时，传入原交易的订单号；【退款比对字段1：不存在，不退款】 |
NO |
| original_wk_trade_id |
String(64) |
原扣款交易（createPayOrder接口返回）的wk_trade_id，wk_trade_id+ out_trade_id +merchant id + appid 用于 确定扣款唯一性 |
NO |
| out_refund_id |
String(64) |
商户退款订单号: 外部退款单号，第三方商户、各个渠道自己生成的退款单标识，必须要唯一不能重复 |
NO |
| refund_coin_amount |
Decimal |
代币金额：单位和币种关联，整数 |
NO |
| coin_type |
String(50) |
代币币种：lianshang coin 等等 |
NO |
| refund_cash_amount |
Decimal |
退款金额（单位为分），【退款比对字段2：超过原交易 pay_amount 金额，不退款】 |
NO |
| refund_currency |
String(6) |
退款币种(默认人民币 CNY)：按照原交易的 pay_currency 来退；【退款比对字段3：不同币种，不退款】 |
NO |
| refund_product_subject |
String(1024) |
退款商品列表，格式参考 |
NO |
| notify_url |
String(128) |
退款结果通知地址 |
NO |
| refund_expire |
Int |
交易关闭时间，如在规定时间内没有支付成功，则交易将被关闭，单位是分钟 |
NO |
| risk_extend |
String(1024) |
Json格式的风控需要信息内容，具体需要信息和风控确认后后续提供。（目前没有风控：风控值暂时设置为200以内：为中低风险，（有用支付宝的花呗）；） |
NO |
| security_type |
String(6) |
Sign字段的签名方式 目前为RSA |
NO |
| sign |
String(256) |
商户签名，签名明文规则(原始请求报文去除security_type和sign字段，按照key的字母升序排序) |
NO |
响应契约：
newBaseResponseData
| 名字 |
类型 |
描述 |
是否可选 |
| version |
String(6) |
服务版本号，与请求时的信息一致 |
NO |
| platform |
String(10) |
最终支付来源,即商户使用何种方式调用开放平台支付，与请求时的信息一致 |
NO |
| request_id |
String(64) |
信息标识，与请求时的信息一致 |
NO |
| out_user_id |
String(64) |
信息标识，与请求时的信息一致 |
YES |
| guest_id |
String(64) |
|
YES |
| client_user_id |
String(64) |
|
YES |
| service_name |
String(32) |
服务名称，与请求时的信息一致 |
NO |
| language |
Int |
语言与请求时的信息一致 |
NO |
| merchant_id |
String(32) |
开放平台商户ID，与请求时传值一致 |
NO |
| time_stamp |
String(14) |
时间戳(返回时的时间) |
NO |
| compress_type |
String(2) |
压缩类型：0（不压缩），1（gzip） |
NO |
newBizResponseData
| 名字 |
类型 |
描述 |
是否可选 |
| result_code |
String(16) |
返回结果 Success 为成功，其他请参见错误码信息 |
NO |
| result_msg |
String(128) |
返回结果信息描述 |
NO |
| wk_refund_id |
String(64) |
内部退款交易号 —— wk_refund_id |
NO |
| refund_status |
String(64) |
退款状态，仅申请支付宝退款，同步返回成功时有值，如值为SUCCESS 代表退款成功，不再发送退款异步通知消息 |
YES |