威富通支付接口请求及返回结果参数

请求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 |