请求url:https://pay.swiftpass.cn/pay/gateway
威富通支付接口,请求及返回结果参数对比:
【统一】扫码支付 | 【微信】公众号&小程序支付 |
【微信】APP支付 非原生态预下单API |
【微信】APP支付 原生态预下单API |
【微信】WAP支付 | 【微信】刷脸支付(间连模式) | 【统一】付款码支付 | 【支付宝】扫码支付 | 【支付宝】服务窗支付 | 【银联】银联扫码支付 | 【其它】数字人民币扫码支付 | 【银联】银联WAP&APP支付 | 【银联】银联JS | 【QQ钱包】公众号支付 | 【QQ钱包】扫码支付 | 【QQ钱包】WAP支付 | 【京东】扫码支付 | 【京东】京东WAP&JS支付 | ||||||||||||||||||||||||
接口类型 | unified.trade.native | pay.weixin.jspay | unified.trade.pay | pay.weixin.raw.app | pay.weixin.wappay | unified.trade.micropay | unified.trade.micropay | pay.alipay.native | pay.alipay.jspay | pay.unionpay.native | pay.decp.native | pay.unionpay.raw.app | pay.unionpay.wappay | pay.unionpay.jspay | pay.tenpay.jspay | pay.tenpay.native | pay.tenpay.wappay | pay.jdpay.native | pay.jdpay.jspay | ||||||||||||||||||||||
字段名 | 变量名 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 变量名 | 必填 | 类型 | 说明 |
接口类型 | service | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(32) | 接口类型 |
版本号 | version | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(8) | 版本号,version默认值是2.0 |
字符集 | charset | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(8) | 可选值 UTF-8 ,默认为 UTF-8 |
签名方式 | sign_type | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(12) | 签名类型,取值RSA_1_256或RSA_1_1 |
商户号 | mch_id | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(32) | 商户号,由平台分配 |
商户名称 | merchant_name | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(128) | 商户入网的主体名称 |
连锁商户编号 | groupno | √ | 否 | √ | 否 | String(32) | 连锁商户模式下专用(用到时签名必须使用连锁商户密钥),正常模式下忽略不传此字段 | ||||||||||||||||||||||||||||||||||
appid | appid | √ | 是 | String(32) | 商户app对应的微信开放平台移动应用APPID | ||||||||||||||||||||||||||||||||||||
原生JS | is_raw | √ | 是 | String(1) | 值为1 | ||||||||||||||||||||||||||||||||||||
是否小程序支付 | is_minipg | √ | 否 | String(1) | 值为1,表示小程序支付;不传或值不为1,表示公众账号内支付 | ||||||||||||||||||||||||||||||||||||
商户订单号 | out_trade_no | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(32) | 商户系统内部的订单号 ,5到32个字符、 只能包含字母数字或者下划线,区分大小写,每次下单请求确保在商户系统唯一 |
设备号 | device_info | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 终端设备号 ,终端设备号,商户自定义。特别说明:对于QQ钱包支付,此参数必传,否则会报错。如果是用于苹果app应用里值为iOS_SDK;如果是用于安卓app应用里值为AND_SDK;如果是用于手机网站,值为iOS_WAP或AND_WAP均可 |
操作员 | op_user_id | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 操作员帐号,默认为商户号 |
门店编号 | op_shop_id | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 商家自定义门店id,对应支付宝侧 store_id字段,有参加支付宝加油活动则必传,为支付宝加油产品的外部油站 id |
支付宝加油信息 | thi_extend_params | √ | 否 | String(1024) | 参加支付宝加油活动产品必传,且必须按照规范上传,JSON格式,详见【支付宝加油活动字段说明】 | ||||||||||||||||||||||||||||||||||||
商品描述 | body | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(128) | 商品描述 |
优惠详情 | promotion_detail | √ | 否 | String(6000) | 优惠详情,内容详见【优惠活动字段说明】 | ||||||||||||||||||||||||||||||||||||
公众账号ID 【微信】 | sub_appid | √ | 否 | √ | 是 | √ | 是 | √ | 否 | √ | 否 | String(32) | 微信公众平台基本配置中的AppID(应用ID),传入后支付成功可返回对应公众号下的用户openid | ||||||||||||||||||||||||||||
单品信息 | goods_detail | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(6000) | 单品优惠活动该字段必传,且必须按照规范上传,JSON格式,详见【优惠活动字段说明】 | ||||||||||||||||||||||||
业务参数 | business_params | √ | 否 | String (512) | 业务参数必须按照规范上传,JSON格式,详见【业务参数字段说明】 | ||||||||||||||||||||||||||||||||||||
花呗分期数【支付宝】 | hb_fq_num | √ | 否 | √ | 否 | √ | 否 | String | 只支持传"3"|"6"|"12",只适用于支付宝支付 | ||||||||||||||||||||||||||||||||
承担手续费角色【支付宝】 | hb_fq_seller_percent | √ | 否 | √ | 否 | √ | 否 | String | 只支持传"0"|"100",商家承担手续费传"100",用户承担传"0",在有hb_fq_num字段时默认为“0” | ||||||||||||||||||||||||||||||||
支付宝可打折金额【支付宝】 | discountable_amount | √ | 否 | √ | 否 | √ | 否 | Int | 单位/分 | ||||||||||||||||||||||||||||||||
银联userId | user_id | √ | 否 | String(128) | 银联userId | ||||||||||||||||||||||||||||||||||||
用户ip | customer_ip | √ | 是 | String(16) | 用户的外网ip,需要与访问银联支付页面的ip一致,银联会进行校验 | ||||||||||||||||||||||||||||||||||||
用户openid | sub_openid | √ | 是 | String(128) | 微信用户关注商家公众号的openid(注:使用测试号时此参数置空,即不要传这个参数,使用正式商户号时才传入,参数名是sub_openid,具体请看文档最后注意事项第7点) | ||||||||||||||||||||||||||||||||||||
公众账号或小程序ID | sub_appid | √ | 是 | String(32) | 当发起公众号支付时,值是微信公众平台基本配置中的AppID(应用ID);当发起小程序支付时,值是对应小程序的AppID | ||||||||||||||||||||||||||||||||||||
附加信息 | attach | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(127) | 附加数据,支付成功后在查询API和支付通知API中原样返回,该字段主要用于商户携带订单的自定义数据。另外在业务允许的特殊场景下作为分账字段使用,详情请查看分账产品介绍文档 |
总金额 | total_fee | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | Int | 总金额,以分为单位,不允许包含任何字、符号 |
电子发票 | need_receipt | √ | 否 | √ | 否 | √ | 否 | √ | 否 | 否 | boolean | 需要和微信公众平台的发票功能联合,传入true时,微信支付成功消息和支付详情页将出现开票入口[新增need_receipt【适用于微信】] | |||||||||||||||||||||||||||||
终端IP | mch_create_ip | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(16) | 上传商户真实的发起交易的终端出网IP |
授权码 | auth_code | √ | 是 | √ | 是 | String(128) | 扫码支付授权码, 设备读取用户展示的条码或者二维码信息 | ||||||||||||||||||||||||||||||||||
业务扩展参数 | extend_params | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 业务扩展参数 | ||
└pay_type | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 交易发起方式 | |||
└order_time | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 交易时间 | |||
└mch_name | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 商户名称 | |||
└industry | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 商户类型及代码 | |||
└channel | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 交易渠道 | |||
经纬度 | device_location | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 格式:纬度/经度,+表示北纬、东经,-表示南纬、 西经,精度最长支持小数点后9位。举例:+37.123456789/-121.123456789 |
通知地址 | notify_url | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(255) | 接收平台通知的URL,需给绝对路径,255字符内格式如:http://wap.tenpay.com/tenpay.asp,确保平台能通过互联网访问该地址 | ||||
前台地址 | callback_url | √ | 否 | √ | 是 | √ | 是 | √ | 否 | String(255) | 前端页面跳转的URL(包括支付成功和关闭时都会跳到这个地址,商户需自行处理逻辑),需给绝对路径,255字符内格式如:http://wap.tenpay.com/callback.asp注:该地址只作为前端页面的一个跳转,须使用notify_url通知结果作为支付最终结果。 | ||||||||||||||||||||||||||||||
订单生成时间 | time_start | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(14) | 订单生成时间,格式为yyyyMMddHHmmss,如2009年12月25日9点10分10秒表示为20091225091010。时区为GMT+8 beijing。该时间取自商户服务器。注:订单生成时间与超时时间需要同时传入才会生效。 | ||
订单超时时间 | time_expire | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(14) | 订单失效时间,格式为yyyyMMddHHmmss,如2009年12月27日9点10分10秒表示为20091227091010。时区为GMT+8 beijing。该时间取自商户服务器。注:订单生成时间与超时时间需要同时传入才会生效。 |
订单最晚付款时间 | qr_code_timeout_express | √ | 否 | √ | 否 | String(6) | 该笔订单允许的最晚付款时间,逾期将关闭交易,从下单开始计时。取值范围:1m~15d。m-分钟,h-小时,d-天,1c-当天(1c-当天的情况下,无论交易何时创建,都在0点关闭)。该参数数值不接受小数点,如1.5h,可转换为90m。 | ||||||||||||||||||||||||||||||||||
买家支付宝账号 | buyer_logon_id | √ | 否 | String(100) | 买家支付宝账号,和buyer_id不能同时为空 | ||||||||||||||||||||||||||||||||||||
买家支付宝用户ID | buyer_id | √ | 否 | String(100) | 买家支付宝用户ID,和buyer_logon_id不能同时为空buyer_id获取方法:https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.8ujLD6&treeId=115&articleId=104114&docType=1通过网页授权获取用户信息,同步响应结果中的user_id对应文档中的buyer_id。 | ||||||||||||||||||||||||||||||||||||
商品标记 | goods_tag | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 商品标记,微信平台配置的商品标记,用于优惠券或者满减使用 | |||||||||||||
商品 ID | product_id | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 预留字段此 id 为静态可打印的二维码中包含的商品 ID,商户自行维护。 | ||||||||||||||||||||||||||||||
设备编号 | op_device_id | √ | 否 | √ | 否 | String(32) | |||||||||||||||||||||||||||||||||||
应用名 | mch_app_name | √ | 是 | String(100) | 如果是用于苹果或安卓app应用中,传分别对应在AppStore和安卓分发市场中的应用名(如:王者荣耀)如果是用于手机网站,传对应的网站名(如:京东官网) | ||||||||||||||||||||||||||||||||||||
应用标识 | mch_app_id | √ | 是 | String(100) | 如果是用于苹果或安卓app应用中,苹果传IOS 应用唯一标识(如:com.tencent.wzryIOS)安卓传包名(如:com.tencent.tmgp.sgame)如果是用于手机网站,传网站首页URL地址,必须保证公网能正常访问(如:https://m.jd.com) | ||||||||||||||||||||||||||||||||||||
随机字符串 | nonce_str | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(32) | 随机字符串,不长于 32 位 |
是否限制信用卡 | limit_credit_pay | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 限定用户使用时能否使用信用卡,值为1,禁用信用卡;值为0或者不传此参数则不禁用 | ||||||||||||||||||||||||
签名 | sign | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(344) | RSA_1_256/RSA_1_1签名结果,详见“安全规范” |
受理终端信息 | terminal_info | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(1024) | 商户侧受理终端信息,格式为 json 格式,详见下文子字段说明 | ||||||||||||||||||||||
└ location | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(32) | 受理终端设备实时经纬度信息,格式为纬度/经度,+表示北纬、东经,-表示南 +37.12/-121.213南纬、西经。没有传则取device_location | +37.12/-121.213 | |||||||||||||||||||||||
└ network_license | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(5) | 银行卡受理终端产品入网认证编号。该编号由“中国银联标识产品企业资质认证办公室”为通过入网认证的终端进行分配。格式:5 位字符,例如 P3100 | P3100 | |||||||||||||||||||||||
└ terminal_type | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(2) | 终端设备类型,受理方可参考终端注册时的设备类 型填写,取值如下:01:自动柜员机(含 ATM 和 CDM)和多媒体自助终端; 02:传统 POS ;03: mPOS ;04:智能 POS ;05:II 型固定电话; 06: 云闪付终端;07:保留使用;08:手机 POS;09:刷脸付终端;10:条码支付受理终端;11:条码支 付辅助受理终端;12:行业终端(公交、地铁用于 指定行业的终端);13:MIS 终端;没有传默认取 11 | 02 | |||||||||||||||||||||||
└ terminal_id | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(8) | 终端设备编号,平台为商户终端分配的唯一编号 | |||||||||||||||||||||||
└ serial_num | √ | 否 | √ | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(50) | 终端设备的硬件序列号。没有传默认取op_device_id | ||||||||||||||||||||||||
└ encrypt_rand_num | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(10) | 仅在被扫支付类交易报文中出现:若付款码为 19 位数字,则取后 6 位;若付款码码为EMV二维码,则取其 tag 57 的卡号/token 号的后 6 位 | |||||||||||||||||||||||
└ secret_text | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(16) | 仅在被扫支付类交易报文中出现:64bit的密文数据,对终端硬件序列号和加密随机因子加密后的结果。本子域取值为:64bit 密文数据进行base64 编码后的结果。 | |||||||||||||||||||||||
└ app_version | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(8) | 终端应用程序的版本号。应用程序变更应保证版本号不重复。当长度不足时,右补空格。 | 1.0 | |||||||||||||||||||||||
└ terminal_ip | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(64) | 商户端终端设备 IP 地址。注: 如经 、纬度信息未上送 , 该字段必送。如果没传取mch_create_ip | |||||||||||||||||||||||
└ mobile_country_cd | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(3) | 基站信息,移动国家代码,由国际电联(ITU) 统一分配的移动国家代码(MCC)。中国为 460 | 460 | |||||||||||||||||||||||
└ mobile_net_num | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(2) | 基站信息,移动网络号码,由国际电联(ITU) 统一分配的移动网络号码(MNC)。移动:00、02、04、07;联通:01、06、09;电信:03、05、11 | 01 | |||||||||||||||||||||||
└ icc_id | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(20) | ICCID,SIM 卡卡号 | |||||||||||||||||||||||
└ location_cd1 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(4) | 位置区域码 1,LAC(移动、联通),16进制 | |||||||||||||||||||||||
└ lbs_num1 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(12) | 基站编号 1,CID(移动、联通),16 进制 | |||||||||||||||||||||||
└ lbs_signal1 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(4) | 基站信号 1,SIG(移动、联通),16 进制 | |||||||||||||||||||||||
└ location_cd2 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(4) | 位置区域码 2,LAC(移动、联通),16进制 | |||||||||||||||||||||||
└ lbs_num2 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(12) | 基站编号 2,CID(移动、联通),16 进制 | |||||||||||||||||||||||
└ lbs_signal2 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(4) | 基站信号 2,SIG(移动、联通),16 进制 | |||||||||||||||||||||||
└ location_cd3 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(4) | 位置区域码 3,LAC(移动、联通),16进制 | |||||||||||||||||||||||
└ lbs_num3 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(12) | 基站编号 3,CID(移动、联通),16 进制 | |||||||||||||||||||||||
└ lbs_signal3 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(4) | 基站信号 3,SIG(移动、联通),16 进制 | |||||||||||||||||||||||
└ telecom_sys_id | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(4) | 电信系统识别码,SID(电信),电信系统识别码,每个地级市只有一个 SID | |||||||||||||||||||||||
└ telecom_net_id | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(4) | 电信网络识别码,NID(电信),电信网络识别码,由电信各由地级分公司分配。每个地级市可能有1到3个NID | |||||||||||||||||||||||
└ telecom_lbs | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(4) | 电信基站,BID(电信),电信网络中的小区识别码,等效于基站 | |||||||||||||||||||||||
└ telecom_lbs_signal | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String(4) | 电信基站信号,SIG(电信),16 进制 | |||||||||||||||||||||||
返回结果参数 | |||||||||||||||||||||||||||||||||||||||||
公众账号ID 支付宝appid |
appid | √ | √ | √ | String(32) | 服务商公众号APPID | |||||||||||||||||||||||||||||||||||
版本号 | version | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | String(8) | 版本号,version默认值是2.0。 | |||||||||||||||||||
字符集 | charset | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | String(8) | 可选值 UTF-8 ,默认为 UTF-8。 | |||||||||||||||||||
签名方式 | sign_type | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | String(12) | 签名类型,取值RSA_1_256或RSA_1_1 | |||||||||||||||||||
返回状态码 | status | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | String(16) | 0表示成功,非0表示失败此字段是通信标识,非交易标识,交易是否成功需要查看 result_code 来判断 | |||||||||||||||||||
返回信息 | message | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | String(128) | 返回信息,如非空,为错误原因签名失败参数格式校验错误 | |||||||||||||||||||
网关返回码 | code | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | String(32) | 网关返回码 | ||||||||||||||||||||||||||||
查询判断 | need_query | √ | √ | String(1) | 用来判断是否需要调用查询接口,值为Y时需要,值为N时不需要 | ||||||||||||||||||||||||||||||||||||
以下字段在 status 为 0的时候有返回 | |||||||||||||||||||||||||||||||||||||||||
支持的支付类型 | services | String | 支持的支付类型,多个以“|”连接 | ||||||||||||||||||||||||||||||||||||||
授权码 | token_id | String (64) | 支付授权码 | ||||||||||||||||||||||||||||||||||||||
访问地址 | statecheckhost | String(128) | 后续SDK调用访问区域地址 | ||||||||||||||||||||||||||||||||||||||
公众账号ID | appid | String(32) | 服务商公众号ID | ||||||||||||||||||||||||||||||||||||||
业务结果 | result_code | String(16) | 0表示成功,非0表示失败 | ||||||||||||||||||||||||||||||||||||||
商户号 | mch_id | String(32) | 商户号,由平台分配 | ||||||||||||||||||||||||||||||||||||||
设备号 | device_info | String(32) | 终端设备号 | ||||||||||||||||||||||||||||||||||||||
随机字符串 | nonce_str | String(32) | 随机字符串,不长于 32 位 | ||||||||||||||||||||||||||||||||||||||
错误代码 | err_code | String(32) | 参考错误码 | ||||||||||||||||||||||||||||||||||||||
错误代码描述 | err_msg | String (128) | 结果信息描述 | ||||||||||||||||||||||||||||||||||||||
签名 | sign | String(344) | RSA_1_256/RSA_1_1签名结果,详见“安全规范” | ||||||||||||||||||||||||||||||||||||||
附加信息 | attach | String(127) | 附加数据,原样返回 | ||||||||||||||||||||||||||||||||||||||
以下字段在 status 和 result_code 都为 0的时候有返回 | |||||||||||||||||||||||||||||||||||||||||
银联受理订单号 | tn | √ | 是 | String(32) |
银联受理流水号,商户调用支付控件SDK时使用。 银联iOS SDK下载 银联Android SDK下载 |
||||||||||||||||||||||||||||||||||||
二维码链接 | code_url | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(128) | 商户可用此参数自定义去生成二维码后展示出来进行扫码支付 | ||||||||||||||||||||||||||
二维码图片 | code_img_url | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | String(256) | 此参数的值即是根据code_url生成的可以扫码支付的二维码图片地址 | ||||||||||||||||||||||||||
唯一识别号 | uuid | √ | 否 | √ | 否 | String(64) | 唯一识别号 | ||||||||||||||||||||||||||||||||||
商户订单号 | out_trade_no | √ | 是 | √ | 是 | √ | 是 | String | 商户订单号 | ||||||||||||||||||||||||||||||||
平台订单号 | transaction_id | √ | 是 | √ | 是 | √ | 是 | String | 平台订单号 | ||||||||||||||||||||||||||||||||
服务商appid | appid | √ | 否 | √ | 否 | √ | 否 | √ | 否 | String | 服务商appid | ||||||||||||||||||||||||||||||
动态口令 | token_id | √ | 是 | √ | 是 | √ | 是 | √ | 否 | String(64) |
授权口令 手Q支付生成的token_id |
||||||||||||||||||||||||||||||
原生态js支付信息或小程序支付信息 支付地址 支付信息 唤起js支付的参数 支付结果信息 |
pay_info | √ | 是 | √ | 是 | √ | 是 | √ | 否 | √ | 否 | √ | 是 | √ | 是 | √ | 是 | √ | 是 | √ | 否 | String |
原生态js支付:is_raw为1时返回,json格式的字符串,作用于原生态js支付时的参数 小程序支付:is_minipg为1时返回,json格式的字符串,作用于小程序支付时的参数 唤起手机微信支付url地址 Json格式的字符串,微信官方SDK中需要的参数信息,具体调用可参阅微信官方平台的 "APP端开发步骤" 说明。 唤起手机银联支付url地址 json格式的字符串,作用于原生态js支付时的参数,{"tokenId":"0V41fae78af237d4e35be725eb0f972c","pubAccHint":"","pubAcc":""} 唤起QQ钱包支付url地址 |
||||||||||||||||||
支付链接 银联支付页面 |
pay_url | √ | 否 | √ | 是 | √ | 否 | √ | 否 | String(128) |
仅作为参考使用,商户需自己实现该支付页面 银联支付页面 |
||||||||||||||||||||||||||||||
用户标识 | openid | √ | 否 | √ | 否 | String(128) | 用户在受理商户 appid 下的唯一标识 | ||||||||||||||||||||||||||||||||||
用户标识 | sub_openid | √ | 否 | √ | 否 | String(128) | 用户在子商户appid下的唯一标识 | ||||||||||||||||||||||||||||||||||
交易类型 | trade_type | √ | 是 | √ | 是 | String(32) |
pay.weixin.micropay——微信刷卡支付 pay.alipay.micropay——支付宝刷卡支付 pay.jdpay.micropay——京东刷卡支付 pay.qq.micropay——QQ钱包刷卡支付 pay.shiming.micropay——会员卡支付 pay.unionpay.micropay——银联支付 pay.bestpay.micropay——翼支付 |
||||||||||||||||||||||||||||||||||
是否关注公众账号 | is_subscribe | √ | 否 | √ | 否 | String(1) | 用户是否关注公众账号,Y-关注,N-未关注,仅在公众账号类型支付有效 | ||||||||||||||||||||||||||||||||||
支付结果 | pay_result | √ | 是 | √ | 是 | Int | 支付结果:0—成功;其它—失败 | ||||||||||||||||||||||||||||||||||
支付场景【微信】 | pay_scene | √ | 否 | √ | 否 | String | "micropay"表示反扫,"facepay"表示刷脸 | ||||||||||||||||||||||||||||||||||
第三方订单号 | out_transaction_id | √ | 是 | √ | 是 | String(32) | 第三方订单号 | ||||||||||||||||||||||||||||||||||
子商户是否关注 | sub_is_subscribe | √ | 否 | √ | 否 | String(1) | 用户是否关注子公众账号,Y-关注,N-未关注,仅在公众账号类型支付有效 | ||||||||||||||||||||||||||||||||||
子商户appid | sub_appid | √ | 否 | √ | 否 | String | 子商户appid | ||||||||||||||||||||||||||||||||||
总金额 | total_fee | √ | 是 | √ | 是 | Int | 总金额,以分为单位,不允许包含任何字、符号 | ||||||||||||||||||||||||||||||||||
现金支付金额【微信】 | cash_fee | √ | 否 | √ | 否 | Int | 现金支付金额订单现金支付金额,详见支付金额 | ||||||||||||||||||||||||||||||||||
开票金额 【支付宝】 | invoice_amount | √ | 否 | String(11) | 用户在交易中支付的可开发票的金额 | ||||||||||||||||||||||||||||||||||||
买家支付宝账号【支付宝】 | buyer_logon_id | √ | 否 | String(64) | 买家支付宝账号 | ||||||||||||||||||||||||||||||||||||
买家支付宝用户ID【支付宝】 | buyer_user_id | √ | 否 | String(28) | 买家在支付宝的用户id | ||||||||||||||||||||||||||||||||||||
现金券金额 | coupon_fee | √ | 否 | √ | 否 | Int | 现金券支付金额<=订单总金额, 订单总金额-现金券金额为现金支付金额 | ||||||||||||||||||||||||||||||||||
优惠详情【微信】 | promotion_detail | √ | 否 | √ | 否 | String(6000) | 优惠详情,内容详见【优惠活动字段说明】 | ||||||||||||||||||||||||||||||||||
优惠详情【支付宝】 | discount_goods_detail | √ | 否 | String(1024) | 优惠详情,内容详见【优惠活动字段说明】 | ||||||||||||||||||||||||||||||||||||
交易支付使用的资金渠道 【支付宝】 | fund_bill_list | √ | 是 | ||||||||||||||||||||||||||||||||||||||
└ fundChannel | √ | 是 | String(32) | 交易使用的资金渠道,详见 支付渠道列表 | |||||||||||||||||||||||||||||||||||||
└ amount | √ | 是 | Price(32) | 该支付工具类型所使用的金额 | |||||||||||||||||||||||||||||||||||||
└ realAmount | √ | 否 | Price(11) | 渠道实际付款金额 | |||||||||||||||||||||||||||||||||||||
实收金额【支付宝】 | receipt_amount | √ | 是 | String(11) | 实收金额,单位为元,两位小数。该金额为本笔交易,商户账户能够实际收到的金额 | ||||||||||||||||||||||||||||||||||||
买家实付金额【支付宝】 | buyer_pay_amount | √ | 否 | Price(11) | 买家实付金额,单位为元,两位小数。该金额代表该笔交易买家实际支付的金额,不包含商户折扣等金额 | ||||||||||||||||||||||||||||||||||||
积分支付的金额【支付宝】 | point_amount | √ | 否 | Price(11) | 积分支付的金额,单位为元,两位小数。该金额代表该笔交易中用户使用积分支付的金额,比如集分宝或者支付宝实时优惠等 | ||||||||||||||||||||||||||||||||||||
货币种类 | fee_type | √ | 否 | √ | 否 | String(8) | 货币类型,符合 ISO 4217 标准的三位字母代码,默认人民币:CNY | ||||||||||||||||||||||||||||||||||
附加信息 | attach | √ | 否 | √ | 否 | String(127) | 商家数据包,原样返回 | ||||||||||||||||||||||||||||||||||
付款银行 | bank_type | √ | 否 | √ | 否 | String(32) | 银行类型 | ||||||||||||||||||||||||||||||||||
唯一识别 | uuid | √ | 否 | √ | 否 | String(64) | 唯一识别号 | ||||||||||||||||||||||||||||||||||
银行订单号 | bank_billno | √ | 否 | √ | 否 | String(32) | 银行订单号,若为微信支付则为空 | ||||||||||||||||||||||||||||||||||
支付完成时间 | time_end | √ | 是 | √ | 是 | String(14) | 支付完成时间,格式为yyyyMMddHHmmss,如2009年12月27日9点10分10秒表示为20091227091010。时区为GMT+8 beijing。该时间取自平台服务器 | ||||||||||||||||||||||||||||||||||
免充值金额 | mdiscount | √ | 否 | √ | 否 | Int | 免充值优惠金额 | ||||||||||||||||||||||||||||||||||
现金支付货币种类 | cash_fee_type | √ | 否 | √ | 否 | String(8) | 货币类型,符合 ISO 4217 标准的三位字母代码,默认人民币:CNY | ||||||||||||||||||||||||||||||||||
用户支付时间 | gmt_payment | √ | 否 | √ | 否 | String(14) | 用户支付时间,格式为yyyyMMddHHmmss,如2009年12月27日9点10分10秒表示为20091227091010。时区为GMT+8 beijing。该时间取自平台服务器 | ||||||||||||||||||||||||||||||||||
应结订单金额 | settlement_total_fee | √ | 否 | √ | 否 | Int | 应结订单金额=订单金额-免充值代金券金额,应结订单金额<=订单金额 | ||||||||||||||||||||||||||||||||||
风控信息 | risk_info | √ | 否 | √ | 否 | String(128) | 返回的风控信息,格式为 json 格式 | ||||||||||||||||||||||||||||||||||
└ terminal_ip | √ | 否 | √ | 否 | String(64) | 绑卡设备(付款 APP)所在的公网 IP,可用于定位所属地区,不是 wifi 连接时的局域网 IP。局域网 IP 包括:A 类:10.0.0.0-10.255.255.255;B 类:172.16.0.0-172.31.255.255;C 类:192.168.0.0-192.168.255.255 | | |||||||||||||||||||||||||||||||||||
└ terminal_location | √ | 否 | √ | 否 | String(32) | 设备(付款 APP)GPS 位置,格式为纬度/经度,+表示北纬、东经,-表示南纬、西经。 | +37.123456789/-121.123456789 | | |||||||||||||||||||||||||||||||||||