订单支付接口(收银台模式)
说明:商户端请求富友端,递交的方式必须为POST
通过调此接口,跳转进入富友收银台
请求方式HTTP POST FORM表单提交(详情请看:案例代码/订单支付-收银台)
测试环境演示地址如下(版本号:4.0.0):详情请咨询富友对接群
备注:版本号传4.0.0可以在浏览器跳转富友微信小程序不显示中间页。优化用户体验。(只针对使用富友微信小程序生效)
1请求地址
测试地址[版本号4.0.0]:[详情请咨询富友对接群]
生产地址[版本号4.0.0]:[详情请咨询富友对接群]
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 |
用户ID | user_id | MAX(40) | 一个用户对应一个用户ID主要用于银行卡或分期绑卡操作 | 非必填 | 1352411000000000 |
小程序链接地址 | url_link | MAX(200) | 如用富友小程序不用传参,如用商户小程序必传 | 非必填 | http://...... |
微信APPID | appid | MAX(32) | 公众号或小程序APPID,富友小程序不用传参 | 非必填 | wxbqdqqf45qq488fqb |
微信OPENID | openid | MAX(128) | 公众号或小程序用户OPENID,富友小程序不用传参 | 非必填 | oKPjj6NiZ-fPAMq9W5iyG6FXJAfS |
支付方式 | pay_type | MAX(30) | 目前支持:UNIONPAY(云闪付) | 非必填 | UNIONPAY:传参由富友后台跳转云闪付支付 |
银行卡号 | acct_no | MAX(30) | 目前支持云闪付 | 非必填 | 防盗刷,云闪付锁定卡号支付 |
订单超时 | order_timeout | MAX(30) | 目前支持微信和支付宝 | 非必填 | 按分钟计算,支持1-360分钟 |
返回上一级 | go_back_url | MAX(1000) | 1.0.0版本不支持,2.0.0版本支持 | 非必填 | 返回商户平台上一级页面,不能当页面回调地址 |
风控信息域 | 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接口输入
详情-请看订单支付异步通知
代码请看【案例】