订单查询接口
说明:为防止商户端系统宕机,商户端系统代码问题,商户端防火墙的问题拦截了富友异步通知
导致用户支付的订单无法推送给商户端系统,此接口主要是给商户端系统补充订单状态
商户端系统:建议加一套定时跑批系统,跑未支付的订单
注!! 此查询接口:同笔订单每5秒一次查询,不可触发高并发同步
请求防守HTTP POST BODY JSON 递交给富友系统(详情请看:案例代码/订单查询)
1请求地址
生产地址:[详情请咨询富友对接群]
测试地址:[详情请咨询富友对接群]
2接口输入
变量名称 | 字段 | 长度 | 说明 | 是否必填 | 样例 |
---|---|---|---|---|---|
商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
报文体 | message | MAX | 报文体密文(详情看:接口概述-报文格式) | 必填 | OsxV9TKk5NzbD................ |
2.1请求message报文体
变量名称 | 字段 | 长度 | 说明 | 是否必填 | 样例 |
---|---|---|---|---|---|
商户号码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
订单日期 | order_date | MAX(8) | 支付请求的日期 | 必填 | 20200508 |
商户订单号 | order_id | MAX(30) | 数字和英文组合,确保唯一性 | 非必填(order_id和fy_order_id必填一个) | 16110211240374534607 |
富友订单号 | 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响应message报文体
变量名称 | 字段 | 长度 | 说明 | 是否必填 | 样例 |
---|---|---|---|---|---|
商户号码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
订单日期 | order_date | MAX(8) | 支付请求的日期 | 必填 | 20200508 |
订单号 | order_id | MAX(30) | 数字和英文组合,确保唯一性 | 必填 | 16110211240374534607 |
富友订单号 | fy_order_id | MAX(60) | 富友送给支付宝或者微信的订单号,唯一(公众号点金计划用) | 非必填 | 000201154000 |
用户openid | openid | MAX(64) | 用户的openid | 非必填 | |
支付类型 | order_pay_type | MAX(15) | 支付方式类型 | 必填 | 详情请看(产品概述/产品类型) |
订单金额 | order_amt | MAX(12) | 支付的交易金额 | 必填 | 1200分,单位:分 |
订单状态 | order_st | MAX(4) | 交易状态 | 必填 | 详情看订单状态列表 |
清分流水号 | 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) | 特殊通道专用 | 非必填 | JSON格式:由富友技术提供 |
3.2分期信息order_info 返回分期支付_json字符串
{"periods_num":"分期数","mchnt_mode":"贴息模式","mchnt_fee","商户手续费","bank_card_fee","用户手续费","fee_mode":"手续费模式"}