订单支付接口(TOKEN版本)
说明:商户端请求富友端,递交的方式必须为POST
通过调此接口,富友响应支付链接,商户端GET打开支付链接,可以打开通道的支付页面进行付款
请求方式HTTP POST BODY JSON提交(详情请看:案例代码/订单支付-TOKEN)
备注:版本号传4.0.0可以在浏览器跳转富友微信小程序不显示中间页。优化用户体验。(只针对使用富友微信小程序生效)
1请求地址
测试地址:[详情请咨询富友对接群]
生产地址:[详情请咨询富友对接群]
2接口输入
变量名称 | 字段 | 长度 | 说明 | 是否必填 | 样例 |
---|---|---|---|---|---|
商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
报文体 | message | MAX | 报文体密文(详情看:接口概述-报文格式) | 必填 | OsxV9TKk5NzbD................ |
2.1请求message报文体
变量名称 | 字段 | 长度 | 说明 | 是否必填 | 样例 |
---|---|---|---|---|---|
商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
子商户代码 | sub_mchnt_cd | MAX(15) | 商户在富友进件得到子商户号,主要用于轮训 | 非必填 | 0001000F0040990 |
付款商户代码 | pay_mchnt_cd | MAX(15) | 使用余额支付,此参数必填 | 非必填 | 0001000F0048879 |
订单日期 | order_date | MAX(8) | 商户的支付请求的日期 | 必填 | 20200508 |
订单号 | order_id | MAX(30) | 数字和英文组合,确保唯一性 | 必填 | 1611F211240374534607 |
订单金额 | order_amt | MAX(12) | 订单金额以分为单位 | 必填 | 比如:1分 就是0.01元 |
页面通知地址 | page_notify_url | MAX(200) | 由富友请求商户后端系统,在跳转商户前端页面。余额支付和云闪付和网银支付必填;其他支付方式不传 | 非必填 | http://域名/方法名 |
后台通知地址 | back_notify_url | MAX(200) | 由富友请求商户后端系统 | 必填 | http://域名/方法名 |
商品名称 | goods_name | MAX(30) | 商品名称 | 必填 | |
商品描述 | goods_detail | MAX(60) | 商品描述 | 必填 | |
货币类型 | fee_type | MAX(5) | 默认:CNY | 必填 | 默认 :人民币 |
版本号 | ver | MAX(5) | 版本控制,目前是4.0.0版本 | 必填 | 4.0.0 |
设备MAC | trx_mac | MAX(12) | 交易设备MAC地址 | 非必填 | 03:03:30:3A:3B:3C |
设备GPS | trx_gps | MAX(23) | 交易设备位置信息经纬度 | 非必填 | 116.397128,39.916527 |
设备ICCID | trx_iccid | MAX(20) | 交易sim卡的iccid | 非必填 | |
设备IMEI | trx_imei | MAX(15) | 交易设备IMEI | 非必填 | |
设备IMSI | trx_imsi | MAX(15) | 交易设备IMSI | 非必填 | |
终端编码 | trx_trm_no | MAX(8) | 交易终端编码 | 非必填 | |
设备WIFI MAC | trx_wifi_mac | MAX(12) | 交易设备WIFI MAC | 非必填 | 03:03:30:3A:3B:3C |
小程序链接地址 | url_link | MAX(200) | 如用富友小程序不用传参,如用商户小程序必传 | 非必填 | http://...... |
微信APPID | appid | MAX(32) | 公众号或小程序APPID,富友小程序不用传参 | 非必填 | wxbqdqqf45qq488fqb |
微信OPENID | openid | MAX(128) | 公众号或小程序用户OPENID,富友小程序不用传参 | 非必填 | oKPjj6NiZ-fPAMq9W5iyG6FXJAfS |
支付方式 | pay_type | MAX(30) | 详情请看(产品概述-产品类型) | 必填 | 由商户根据需求来传参 |
订单超时 | order_timeout | MAX(30) | 目前支持微信和支付宝 | 非必填 | 按分钟计算,支持1-360分钟 |
风控信息域 | risk_rate_info | MAX(256) | 风控信息域 | 非必填,按后面例子填写。动态替换值 | {shippingCountryCode=156&shippingProvinceCode=5200&shippingCityCode=5210&shippingDistrictCode=5217&shippingStreet=某某大道某某大厦某栋&shippingMobile=18611111111&deviceNumber=18611111111} |
风控信息域risk_rate_info 字段说明:
shippingCountryCode 国家代码 156(中国) shippingProvinceCode 省代码 5200(湖北省) shippingCityCode 市代码 5210(武汉市) shippingDistrictCode 区代码 5217(洪山区) shippingStreet 具体地址 某某大道某某大厦某栋 shippingMobile 收货人手机号 18611111111 deviceNumber 注册手机号 18611111111 省市区代码联系富友获取。
3接口输出
变量名称 | 字段 | 长度 | 说明 | 是否必填 | 说明 |
---|---|---|---|---|---|
商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 比如:0001000F0040992 |
应答码 | resp_code | MAX(4) | 接口通讯应答码 | 必填 | 应答码不能当成订单状态码 |
应答描述 | resp_desc | MAX(200) | 应答描述 | 必填 | 应答描述。比如:成功或失败或余额不足 |
报文体 | message | MAX | 报文体密文 | 必填 | OsxV9TKk5NzbD................ |
3.1响应message报文体
变量名称 | 字段 | 长度 | 说明 | 是否必填 | 样例 |
---|---|---|---|---|---|
商户号码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
订单号 | order_id | MAX(30) | 数字和英文组合,确保唯一性 | 必填 | 16110211240374534607 |
支付地址 | token_url | MAX(12) | token跳转支付地址 | 必填 | 有效期2小时 |