订单支付异步通知
说明:用户支付成功之后,由富友系统主动后台发起订单的终态通知给商户
通知方式是以商户支付传参给与的后台通知地址为准
异步通知报文:通知方式:HTTP, POST, BODY(详情请看最底端描述代码)
通知以HTTP状态码【200=通知商户成功】,商户端无需响应富友任何信息;如商户端系统异常(500 404等等状态码),富友端在2小时内会连续通知商户8次,如超过期限将不再通知商户(商户端可自行调:订单查询接口补偿)
1接口输出
变量名称 | 字段 | 长度 | 说明 | 是否必填 | 说明 |
---|---|---|---|---|---|
商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 比如:0001000F0040992 |
应答码 | resp_code | MAX(4) | 接口通讯应答码 | 必填 | 应答码不能当成订单状态码 |
应答描述 | resp_desc | MAX(200) | 应答描述 | 必填 | 应答描述。比如:成功或失败或余额不足 |
报文体 | message | MAX | 报文体密文 | 必填 | OsxV9TKk5NzbD................ |
1.1响应message报文体
变量名称 | 字段 | 长度 | 说明 | 是否必填 | 样例 |
---|---|---|---|---|---|
商户号码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
订单日期 | order_date | MAX(8) | 下单请求的日期 | 必填 | YYYYMMDD |
订单号 | order_id | MAX(30) | 数字和英文组合,确保唯一性 | 必填 | 16110211240374534607 |
富友订单号 | fy_order_id | MAX(60) | 富友送给支付宝或者微信的订单号,唯一(公众号点金计划用) | 非必填 | 000201154000 |
用户openid | openid | MAX(64) | 用户的openid | 非必填 | |
支付类型 | order_pay_type | MAX(15) | 详情请看(产品概述/产品类型) | 必填 | WeAppletPay |
订单金额 | order_amt | MAX(12) | 支付的交易金额 | 必填 | 1200分,单位:分 |
订单状态 | order_st | MAX(4) | 详情请看(应答描述/订单状态列表) | 必填 | 1 |
清分流水号 | order_fas_ssn | MAX(12) | 富友记账流水号 | 必填 | 000201154112 |
清分日期 | order_fas_date | MAX(8) | 富友记账日期 | 必填 | 20220331 |
交易单号 | pay_ssn | MAX(50) | 微信或支付宝交易单号 | 非必填 | 420000016941241111112121212 |
订单内容 | order_info | MAX | 主要返回分期数据数据 | 非必填 | JSON字符串,详情请看下文 |
分账信息 | bill_params | MAX(1000) | 支持:微信,支付宝多分账 | 非必填 | 以支付请求同步原返回 |
订单内容order_info,json字符串存储
{"periods_num":"分期数","mchnt_mode":"贴息模式","mchnt_fee","商户手续费","bank_card_fee","用户手续费","fee_mode":"手续费模式"}
列表如下
分期数 | periods_num | MAX(10) | 3期,6期,12期,24期 | 必填 | 3 |
贴息模式 | mchnt_mode | MAX(10) | 0是不贴息; 1是部分贴息; 2是贴息 | 必填 | 2 |
商户手续费 | mchnt_fee | MAX(10) | 商户手续费,比如:100元 | 必填 | 100 |
用户手续费 | bank_card_fee | MAX(10) | 用户手续费,比如:100元 | 必填 | 100 |
手续费模式 | fee_mode | MAX(10) | 0:一次性收取,1:分期收取 | 必填 | 1 |
# #