订单查询接口
说明:用户支付完成之后,如富友未给异步通知或因为商户端系统自己系统问题产生的问题或商户公司网络拦截导致富友通知失败
请商户端主动开发定时跑批系统对接订单查询接口,订单最终终态状态:order_st=1(成功),order_st!=1(失败或其他描述)
生产环境为https协议,测试环境为https协议。
1 请求地址
生产地址:[详情请咨询富友对接群]
测试地址:[详情请咨询富友对接群]
2 接口输入
变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 |
---|---|---|---|---|---|
商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
报文体 | message | MAX | 报文体密文(接口文档-接口概述-签名算法) | 必填 | OsxV9TKk5NzbD................ |
2.1 报文体
变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 |
---|---|---|---|---|---|
商户号码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
订单日期 | order_date | MAX(8) | 订单支付接口,产生的订单日期 | 必填 | 20221110 |
商户订单号 | order_id | MAX(30) | 订单支付接口,产生的订单号 | 非必填(order_id和fy_order_id必填一个) | 20224574214512121 |
富友订单号 | fy_order_id | MAX(12) | 12位数字,富友送给微信支付宝的订单号 | 非必填(order_id和fy_order_id必填一个) | 000123456789 |
版本号 | ver | MAX(5) | 版本控制,目前是1.0.0版本 | 必填 | 1.0.0 |
3 接口输出
变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 说明 |
---|---|---|---|---|---|
商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
应答码 | resp_code | MAX(4) | 接口通讯应答码 | 必填 | 应答码不能当成订单状态码 |
应答描述 | resp_desc | MAX(200) | 应答描述 | 必填 | |
报文体 | message | MAX | 报文体 | 必填 | ADp7YzySKDrGI4UG6JcPwMVW3......... |
3.1 报文体
变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 |
---|---|---|---|---|---|
商户号码 | mchnt_cd | MAX(15) | 同上 | 必填 | 0001000F0040992 |
订单日期 | order_date | MAX(8) | 同上 | 必填 | 20221110 |
订单号 | order_id | MAX(30) | 同上 | 必填 | 20221110551545151212 |
富友订单号 | fy_order_id | MAX(32) | 富友送给支付宝或者微信的订单号,唯一(公众号点金计划使用) | 必填 | 003554041360 |
订单金额 | order_amt | MAX(12) | 订单金额:整数,单位:分 | 必填 | 10000(分)=100(元) |
订单状态 | order_st | MAX(4) | 详情请看-应答描述-订单状态列表 | 必填 | 1=支付成功,5=全额退款成功 |
支付方式 | order_pay_type | MAX(10) | 详情请看-产品概述-产品介绍 | 必填 | LETPAY-微信小程序 |
富友日期 | order_fas_date | MAX(8) | 富友记账日期,富友平台对账查询(订单分账使用) | 必填 | 20221228 |
富友流水 | order_fas_ssn | MAX(12) | 富友记账流水,富友平台对账查询(订单分账使用) | 必填 | 000123456789 |
分账信息 | bill_params | MAX | 分账参数,原路返回 | 必填 | |
通道流水号 | pay_ssn | MAX(64) | 微信和支付宝流水号 | 必填 | |
用户openid | openid | MAX(64) | 用户openid | 非必填 | |
卡属性 | card_type | MAX(2) | 银联免密支付返回 01=借记 02=贷记 03=借贷记 | 非必填 | |
银联优惠信息 | discount_info | MAX(128) | 银联优惠信息json串 | 非必填 | |
支付时间 | pay_time | MAX(20) | 支付时间 | 非必填 | yyyymmddhhmmss |