订单被扫支付接口
说明:商户端通过调此富友订单支付被扫接口,富友同步响应支付结果。如果需要用户输入密码。则异步通知支付结果。或者商户主动查询结果
订单支付接口同步响应的结果可能成功。可能待支付(有些场景用户需要输入密码,返回码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\":\"分佣协议号\"}" |