[退款结果通知]
退款通知地址来源:申请退款时填写的notify_url信息
注:通知为加密报文,报文内容:{"res_data": "加密内容"}
响应通知报文采用明文返回(无需加密)
Request Parameters
payNotifyBaseData
名字 |
类型 |
描述 |
是否可选 |
version |
String(6) |
服务版本号,默认填2 |
N |
platform |
String(10) |
传 “PaymentEngine” |
N |
request_id |
String(64) |
请求信息标识,渠道或渠道或商户应保持唯一 |
N |
out_user_id |
String(64) |
连尚账户相关:union_id |
二选一可为空 |
guest_id |
String(64) |
放入渠道用户给出的:openid ;用openid + unionid 在支付端进行 查询连尚统一账户信息:uhid; |
二选一不为空 |
client_user_id |
String(64) |
cp方定义的用户id; |
Y |
service_name |
String(32) |
服务名称,通知为”Notify” |
N |
language |
Int |
语言 填0=中文 |
N |
merchant_id |
String(6) |
支付平台渠道或渠道或商户ID,第三方接入支付平台支付前向支付平台支付申请获得 |
N |
time_stamp |
String(14) |
时间戳(请求时的时间) |
N |
compress_type |
String(2) |
压缩类型:0(不压缩),1(gzip) |
N |
payNotifyBizData
名字 |
类型 |
描述 |
是否可选 |
notify_id |
String(16) |
通知编号,支付平台保证唯一,为了保证通知被渠道或商户成功接收,同一个通知会多次重复发送,每次发送对应不同的通知编号 |
N |
transaction_id |
String(64) |
引起通知对应操作请求中的transaction_id |
N |
wk_trade_id |
String(64) |
引起通知对应操作的支付平台流水号,由支付平台支付生成返回给渠道或商户。如果是同步操作,则此流水号也会在支付交易操作服务中返回。 |
N |
notify_time |
String(16) |
通知时间戳,格式同Head中的time_stamp |
N |
out_trade_id |
String(64) |
对应创建支付交易服务时第三方渠道或商户传入的外部订单号 |
N |
out_refund_id |
String(64) |
外部退款单号,第三方自己生成的订单标识 |
N |
coin_amount |
int |
代币金额:单位和币种关联,精确到小数点; ——改为整数 |
Y |
coin_type |
String(50) |
代币币种:lianshang coin 等等 |
Y |
pay_amount |
int |
退款金额(单位为分);如果状态为支付,则为支付金额; |
N |
pay_currency |
String(6) |
币种 人民币为CNY |
N |
trade_type |
String(16) |
D:扣款 R:退款 C:钱包充值charge F:预授权 U:预授权取消 T:预授权完成 |
N |
status |
String(16) |
操作对应的状态:success:成功(比如:扣款成功)fail:失败 (比如:扣款失败) |
N |
message |
String(180) |
操作失败的消息提示 |
N |
security_type |
String(6) |
Sign字段签名方式,目前为 RSA |
N |
Sign |
String(128) |
支付平台签名,签名生规则见 签名、加密机制 章节 |
N |
Request Example
{
"payNotifyBaseData": {
"version": "001",
"platform": "PaymentEngine",
"request_id": "from paymentEngine 000001",
"out_user_id": "",
"guest_id": "GUESTER",
"client_user_id": "ABaabb",
"service_name": "Notify",
"language": 0,
"merchant_id": "yx001",
"time_stamp": "20180329170536",
"compress_type": "0"
},
"payNotifyBizData": {
"notify_id": "0001",
"transaction_id": ",yxorder0001",
"wk_trade_id": "1001",
"notify_time": "20180329170537",
"out_trade_id": "yxdd001",
"out_refund_id": "yxdd002",
"coin_amount": 100,
"coin_type": "lianshang coin",
"pay_amount": 200,
"pay_currency": "CNY",
"trade_type": "D",
"status": "SUCCESS",
"message": "failue info ",
"security_type": "RSA",
"sign": ""
}
}
Response Parameters
payNotifyBaseResponseData
名字 |
类型 |
描述 |
是否可选 |
version |
String(6) |
服务版本号,与请求时的信息一致; |
N |
platform |
String(10) |
最终支付来源,即商户使用何种方式调用开放平台支付,与请求时的信息一致 |
N |
request_id |
String(64) |
信息标识,与请求时的信息一致 |
N |
out_user_id |
String(64) |
信息标识,与请求时的信息一致 |
二选一可为空 |
guest_id |
String(64) |
信息标识,与请求时的信息一致 |
二选一不为空 |
client_user_id |
String(64) |
信息标识,与请求时的信息一致 |
Y |
service_name |
String(32) |
服务名称,与请求时的信息一致 |
N |
language |
Int |
语言与请求时的信息一致 |
N |
merchant_id |
String(32) |
开放平台商户ID,与请求时传值一致 |
N |
time_stamp |
String(14) |
时间戳(返回时的时间),格式yyyyMMddHHmmss,如 2015年03月29号17点01分36秒 对应字符串为:20180329170136 |
N |
compress_type |
String(2) |
压缩类型:0(不压缩),1(gzip) |
N |
payNotifyBizResponseData
名字 |
类型 |
描述 |
是否可选 |
result_code |
String(16) |
返回结果 Success 为成功,其他请参见错误码信息 |
N |
msg |
String(32) |
返回描述 |
N |
transaction_id |
Stirng(64) |
值为请求中的 transaction_id |
N |
wk_trade_id |
String(64) |
为请求中的wk_trade_id |
N |
security_type |
String(6) |
Sign字段的签名方式 目前为RSA |
N |
sign |
String(128) |
渠道或商户签名,签名生规则见 签名、加密机制 章节 |
N |
Response Example Body
{
"payNotifyBaseResponseData": {
"version": "001",
"platform": "PaymentEngine",
"request_id": "from paymentEngine 000001",
"out_user_id": "1084095900",
"guest_id": "9999",
"service_name": "Notify",
"language": 0,
"merchant_id": "yx001",
"time_stamp": "20180329170636",
"compress_type": "0"
},
"payNotifyBizResponseData": {
"result_code": "SUCCESS",
"msg": "say something",
"transaction_id": "yxorder0001",
"wk_trade_id": "1001",
"security_type": "RSA",
"sign": ""
}
}