订单被扫支付接口
说明:商户端通过调此富友订单支付被扫接口,富友同步响应支付结果。如果需要用户输入密码。则异步通知支付结果。或者商户主动查询结果
订单支付接口同步响应的结果可能成功。可能待支付(有些场景用户需要输入密码,返回码0001需要商户主动查询或者等待通知结果)
请求方式HTTP POST BODY JSON提交(详情请看:案例代码/DEMO下载)
1 请求地址
生产地址:[详情请咨询富友对接群]
测试地址:[详情请咨询富友对接群]
2 接口输入
| 变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 | 
|---|---|---|---|---|---|
| 商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 | 
| 报文体 | message | MAX | 报文体密文(详情请看接口文档-接口概述-签名算法) | 必填 | OsxV9TKk5NzbD................ | 
2.1 报文体
| 变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 | 
|---|---|---|---|---|---|
| 商户号码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 | 
| 商户号码 | sub_mchnt_cd | MAX(15) | 商户在富友入网时生成的子商户号 | 非必填 | 0001000F0040992 | 
| 订单日期 | order_date | MAX(8) | 订单日期,由对接商户系统产生,格式:YYYYMMDD | 必填 | 20221110 | 
| 订单号 | order_id | MAX(30) | 订单号:由商户端生成,条件:唯一,数字和英文组合 | 必填 | 20221110551545151212 | 
| 订单金额 | order_amt | MAX(12) | 订单金额:整数,单位:分 | 必填 | 10000(分)=100(元) | 
| 支付方式 | order_pay_type | MAX(10) | 二维码[ALIPAY-支付宝,WECHAT-微信] | 必填 | ALIPAY | 
| 通知地址 | back_notify_url | MAX(200) | 订单支付成功,富友会根据此地址通知对接商户系统(POST) | 必填 | https://xxxxx.test.com/back.do | 
| 商品名称 | goods_name | MAX(60) | 商品名称, | 必填 | 比如:苹果手机 | 
| 商品描述 | goods_detail | MAX(200) | 商品描述 | 必填 | 比如:买了一部苹果手机9000元 | 
| 版本号 | ver | MAX(5) | 版本控制,目前是1.0.0版本 | 必填 | 1.0.0 | 
| 用户授权码 | auth_code | MAX(30) | 用户授权码 | 必填 | 18111111111111 | 
| 分佣参数 | bill_params | MAX(256) | 子商户号收款的钱。分佣给主商户号。分佣参数。 | 非必填 | 字符串格式。"{\"allocate_amt\":\"分佣金额\",\"contract_ssn\":\"分佣协议号\"}" | 
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) | 订单状态,0=待支付,1=成功,2=失败 | 必填 | 1 | 
| 支付方式 | order_pay_type | MAX(30) | 二维码[ALIPAY-支付宝,WECHAT-微信] | 必填 | ALIPAY | 
| 富友日期 | order_fas_date | MAX(8) | 富友记账日期,富友平台对账查询(订单分账用) | 必填 | 20221228 | 
| 富友流水 | order_fas_ssn | MAX(12) | 富友记账流水,富友平台对账查询(订单分账用) | 必填 | 000123456789 | 
| 通道流水号 | pay_ssn | MAX(64) | 微信和支付宝流水号 | 必填 | |
| 用户openid | openid | MAX(64) | 用户openid | 非必填 | |
| 分佣参数 | bill_params | MAX(256) | 子商户号收款的钱。分佣给主商户号。分佣参数。 | 非必填 | 字符串格式。"{\"allocate_amt\":\"分佣金额\",\"contract_ssn\":\"分佣协议号\"}" |