开发文档

参数规定

| body字段格式建议

线下门店支付

店名-销售商品类目

天虹南山店-超市

线上APPJSAPINATIVE

应用市场上的APP名字-商品概述

美团-KTV

线上H5支付

H5主页title-商品概述

腾讯充值中心-QQ会员充值


| 交易金额

交易金额默认为人民币交易,接口中参数支付金额单位为【分】,参数值不能带小数。对账单中的交易金额单位为【元】。

外币交易的支付金额精确到币种的最小单位,参数值不能带小数点。


| 支付场景

JSAPI--公众号支付、NATIVE--生扫码支付、APP--APP支付,统一下单接口trade_type的传参可参考这里

MICROPAY--付款码支付,付款码支付有单独的支付接口,不调用统一下单接口


| 货币类型

货币类型的取值列表: CNY:人民币


| 时间

标准北京时间,时区为东八区;如果商户的系统时间为非标准北京时间,参数值必须根据商户系统所在时区先换算成标准北京时间, 例如商户所在地为0时区的伦敦,当地时间为20141111000秒,换算成北京时间为20141111800秒。


| 时间戳

标准北京时间,时区为东八区,自197011日 000秒以来的秒数。注意:部分系统取到的值为毫秒级,需要转换成秒(10位数字)


| 商户订单号

商户支付的订单号由商户自定义生成,QQ钱包支付要求商户订单号保持唯一性(建议根据当前系统时间加随机序列来生成订单号)。重新发起一笔支付要使用原订单号,避免重复支付;已支付过或已调用关单、撤销(请见后文的API列表)的订单号不能重新发起支付。


| 交易状态定义列表

SUCCESS—交易成功 

REFUND—已经退款

PROCESSING—退款处理中

CLOSED—订单已经关闭

USERPAYING—用户正在支付  

NOTPAY—订单尚未支付


| 退款方式定义

ORIGINAL—原路退款

BALANCE—退回到余额


| 退款状态定义

SUCCESS—退款成功 

FAIL—退款失败 

PROCESSING—退款处理中

NOTSURE—用户正在支付

NOTPAY—未确定,需要商户原退款单号重新发起

CHANGE—转入代发,退款到银行发现用户的卡作废或者冻结了,导致原路退款银行卡失败,资金回流到商户的现金帐号,需要商户人工干预,通过线下或者财付通转账的方式进行退款。  


| 支付方式限制定义

no_balance—不准使用余额

no_credit—不准使用信用卡

no_debit—不准使用借记卡

balance_only—只准使用余额

debit_only—只准使用借记卡

NoBindNoBalan—简化注册用户不允许用余额


| 付款银行列表

字符型银行编码

银行名称

BALANCE 

零钱

CMB_DEBIT 

招商银行-储蓄卡

ICBC_DEBIT 

工商银行-储蓄卡

CCB_DEBIT 

建设银行-储蓄卡

ABC_DEBIT 

农业银行-储蓄卡

BOC_DEBIT 

中国银行-储蓄卡

COMM_DEBIT 

交通银行-储蓄卡

CMBC_DEBIT 

民生银行-储蓄卡

BOC_DEBIT 

中国银行-储蓄卡

CMB_DEBIT 

招商银行-储蓄卡

CCB_DEBIT 

建设银行-储蓄卡

CEB_DEBIT 

光大银行-储蓄卡

GDB_DEBIT 

广发银行-储蓄卡

SPDB_DEBIT 

浦发银行-储蓄卡

HXB_DEBIT 

华夏银行-储蓄卡

CIB_DEBIT 

兴业银行-储蓄卡

PSBC_DEBIT 

邮政储蓄银行-储蓄卡

PAB_DEBIT 

平安银行-储蓄卡

BOC_DEBIT 

中国银行-储蓄卡

ICBC_DEBIT 

工商银行-储蓄卡

PSBC_DEBIT 

邮储银行-储蓄卡

CEB_DEBIT 

光大银行-储蓄卡

ICBC_DEBIT 

工商银行-储蓄卡

COMM_DEBIT 

交通银行-储蓄卡

JSB_DEBIT 

江苏银行-储蓄卡

CBHB_DEBIT 

渤海银行-储蓄卡

GDRCU_DEBIT 

广东农信-储蓄卡

JZB_DEBIT 

晋中商行-储蓄卡

GUILIN_DEBIT 

桂林银行-储蓄卡

SRCB_DEBIT 

上海农商银行-储蓄卡

ORDOSB_DEBIT 

鄂尔多斯银行-储蓄卡

NCB_DEBIT 

南昌银行-储蓄卡

YNRCB_DEBIT 

云南农信-储蓄卡

BSB_DEBIT 

包商银行-储蓄卡

GZCB_DEBIT 

广州银行-储蓄卡

KLB_DEBIT 

昆仑银行-储蓄卡

CQRCB_DEBIT 

重庆农商行-储蓄卡

GDNYB_DEBIT 

广东南粤银行-储蓄卡

JSHB_DEBIT 

晋商银行-储蓄卡

SDRCU_DEBIT 

山东农信-储蓄卡

HRBCB_DEBIT 

哈尔滨银行-储蓄卡

FDB_DEBIT 

富滇银行-储蓄卡

CITIC_DEBIT 

中信银行-储蓄卡

CRB_DEBIT 

华润银行-储蓄卡

HZB_DEBIT 

杭州银行-储蓄卡

CBHB_DEBIT 

渤海银行-储蓄卡

BSB_DEBIT 

包商银行-储蓄卡

CQB_DEBIT 

重庆银行-储蓄卡

NBCB_DEBIT 

宁波银行-储蓄卡

SDEB_DEBIT 

顺德农商行-储蓄卡

QLB_DEBIT 

齐鲁银行-储蓄卡

HSBC_DEBIT 

恒生银行-储蓄卡

ZSXKCCB_DEBIT 

中山小榄村镇银行-储蓄卡

HDCB_DEBIT 

邯郸银行-储蓄卡

XXCB_DEBIT 

新乡银行-储蓄卡

NYCCB_DEBIT 

南阳村镇银行-储蓄卡

JJCCB_DEBIT 

九江银行-储蓄卡

JDZCCB_DEBIT 

景德镇市商业银行-储蓄卡

KUERLECB_DEBIT 

库尔勒市商业银行-储蓄卡

SZRCB_DEBIT 

深圳农商银行-储蓄卡

HRBB_DEBIT 

哈尔滨银行-储蓄卡

BOCD_DEBIT 

成都银行-储蓄卡

BOSH_DEBIT 

上海银行-储蓄卡

ZJTLCB_DEBIT 

浙江泰隆银行-储蓄卡

GDNYB_DEBIT 

南粤银行-储蓄卡

LJB_DEBIT 

龙江银行-储蓄卡

QDCCB_DEBIT 

青岛银行-储蓄卡

NJCB_DEBIT 

南京银行-储蓄卡

XJRCCB_DEBIT 

新疆农信银行-储蓄卡

JSB_DEBIT 

江苏银行-储蓄卡

ORDOSB_DEBIT 

鄂尔多斯银行-储蓄卡

CSRCB_DEBIT 

常熟农商银行-储蓄卡

LZB_DEBIT 

兰州银行-储蓄卡

XAB_DEBIT 

西安银行-储蓄卡

SRCB_DEBIT 

上海农商银行-储蓄卡

GDRCU_DEBIT 

广东农信银行-储蓄卡

WZB_DEBIT 

温州银行-储蓄卡

SDRCU_DEBIT 

山东农信-储蓄卡

JZB_DEBIT 

晋中银行-储蓄卡

JLB_DEBIT 

吉林银行-储蓄卡

PZHCCB_DEBIT 

攀枝花银行-储蓄卡

BOD_DEBIT 

东莞银行-储蓄卡

JUFENGB_DEBIT 

临朐聚丰村镇银行-储蓄卡

FJNX_DEBIT 

福建农信银行-储蓄卡

GYCB_DEBIT 

贵阳银行-储蓄卡

BNC_DEBIT 

江西银行-储蓄卡

DYCCB_DEBIT 

长城华西银行-储蓄卡

CZB_DEBIT 

浙商银行-储蓄卡

GDHX_DEBIT 

广东华兴银行-储蓄卡

GRCB_DEBIT 

广州农商银行-储蓄卡

HKBEA_DEBIT 

东亚银行-储蓄卡

BOB_DEBIT 

北京银行-储蓄卡

HSB_DEBIT 

徽商银行-储蓄卡

HBNX_DEBIT 

湖北农信-储蓄卡

JSHB_DEBIT 

晋商银行-储蓄卡

SJB_DEBIT 

盛京银行-储蓄卡

JXNXB_DEBIT 

江西农信-储蓄卡

WEB_DEBIT 

微众银行-储蓄卡

CSCB_DEBIT 

长沙银行-储蓄卡

GLB_DEBIT 

桂林银行-储蓄卡

HRXJB_DEBIT 

华融湘江银行-储蓄卡

CCAB_DEBIT 

长安银行-储蓄卡

WFB_DEBIT 

潍坊银行-储蓄卡

BOIMCB_DEBIT 

内蒙古银行-储蓄卡

ZYB_DEBIT 

中原银行-储蓄卡

TJB_DEBIT 

天津银行-储蓄卡

TEST_DEBIT 

测试借记卡快捷支付-储蓄卡

WHRC_DEBIT 

武汉农商行-储蓄卡

JSNX_DEBIT 

江苏农商行-储蓄卡

SXXH_DEBIT 

陕西信合-储蓄卡

HNNX_DEBIT 

河南农信-储蓄卡

HEBNX_DEBIT 

河北农信-储蓄卡

GSNX_DEBIT 

甘肃农信-储蓄卡

YNRCCB_DEBIT 

云南农信-储蓄卡

JRCB_DEBIT 

江阴农商行-储蓄卡

FDB_DEBIT 

富滇银行-储蓄卡

BOLB_DEBIT 

洛阳银行-储蓄卡

NCB_DEBIT 

宁波通商银行-储蓄卡

CZCB_DEBIT 

稠州银行-储蓄卡

GZCB_DEBIT 

广州银行-储蓄卡

CQRCB_DEBIT 

重庆农商银行-储蓄卡

DRCB_DEBIT 

东莞农商银行-储蓄卡

ZJRCUB_DEBIT 

浙江农信-储蓄卡

DLB_DEBIT 

大连银行-储蓄卡

BJRCB_DEBIT 

北京农商行-储蓄卡

NMGNX_DEBIT 

内蒙古农信-储蓄卡

TJBHB_DEBIT 

天津滨海农商行-储蓄卡

LNNX_DEBIT 

辽宁农信-储蓄卡

SCNX_DEBIT 

四川农信-储蓄卡

JLNX_DEBIT 

吉林农信-储蓄卡

JZCB_DEBIT 

锦州银行-储蓄卡

JCB_DEBIT 

晋城银行-储蓄卡

HBCB_DEBIT 

湖北银行-储蓄卡

FBB_DEBIT 

富邦华一银行-储蓄卡

BYK_DEBIT 

营口银行-储蓄卡

KRCB_DEBIT 

昆山农商-储蓄卡

WRCB_DEBIT 

无锡农商-储蓄卡

JNRCB_DEBIT 

江南农商-储蓄卡

HUNNX_DEBIT 

湖南农信-储蓄卡

NCCB_DEBIT 

南充市商业银行-储蓄卡

LUZB_DEBIT 

柳州银行-储蓄卡

TZB_DEBIT 

台州银行-储蓄卡

LYYHB_DEBIT 

辽阳银行-储蓄卡

BOTSB_DEBIT 

唐山银行-储蓄卡

HFB_DEBIT 

恒丰银行-储蓄卡

CQTGB_DEBIT 

重庆三峡银行-储蓄卡

XIB_DEBIT 

厦门国际银行-储蓄卡

ZRCB_DEBIT 

张家港农商行-储蓄卡

TCRCB_DEBIT 

太仓农商行-储蓄卡

WJRCB_DEBIT 

吴江农商行-储蓄卡

CDRCB_DEBIT 

成都农商银行-储蓄卡

GXNX_DEBIT 

广西农信-储蓄卡

BHB_DEBIT 

河北银行-储蓄卡

BGZB_DEBIT 

贵州银行-储蓄卡

LWB_DEBIT 

莱商银行-储蓄卡

WHB_DEBIT 

威海市商业银行-储蓄卡

ZJLXRB_DEBIT 

兰溪越商银行-储蓄卡

TRCB_DEBIT 

天津农商-储蓄卡

GZNX_DEBIT 

贵州农信-储蓄卡

SXNX_DEBIT 

山西农信-储蓄卡

HAINNX_DEBIT 

海南农信-储蓄卡

QSB_DEBIT 

齐商银行-储蓄卡

YTB_DEBIT 

烟台银行-储蓄卡

RZB_DEBIT 

日照银行-储蓄卡

BOLFB_DEBIT 

廊坊银行-储蓄卡

SRB_DEBIT 

上饶银行-储蓄卡

KLB_DEBIT 

昆仑银行-储蓄卡

HKB_DEBIT 

汉口银行-储蓄卡

BONX_DEBIT 

宁夏银行-储蓄卡

WLMQB_DEBIT 

乌鲁木齐银行-储蓄卡

BOCDB_DEBIT 

承德银行-储蓄卡

BOZ_DEBIT 

张家口银行-储蓄卡

BOJX_DEBIT 

嘉兴银行-储蓄卡

GSB_DEBIT 

甘肃银行-储蓄卡

ZZB_DEBIT 

郑州银行-储蓄卡

ZJB_DEBIT 

紫金农商银行-储蓄卡

FUXINB_DEBIT 

阜新银行-储蓄卡

XMCCB_DEBIT 

厦门银行-储蓄卡

FJHXB_DEBIT 

福建海峡银行-储蓄卡

BEEB_DEBIT 

鄞州银行-储蓄卡

BOHN_DEBIT 

海南银行-储蓄卡

YRRCB_DEBIT 

黄河农商银行-储蓄卡

URB_DEBIT 

联合村镇银行-储蓄卡

SUZB_DEBIT 

苏州银行-储蓄卡

QHNX_DEBIT 

青海农信-储蓄卡

HUSRB_DEBIT 

湖商村镇银行-储蓄卡

DSB_DEBIT 

大新银行-储蓄卡

BOSZS_DEBIT 

石嘴山银行-储蓄卡

MINTAIB_DEBIT 

民泰银行-储蓄卡

BOSXB_DEBIT 

绍兴银行-储蓄卡

BCZ_DEBIT 

沧州银行-储蓄卡

LSCCB_DEBIT 

乐山市商业银行-储蓄卡

DLRCB_DEBIT 

大连农商行-储蓄卡

DANDONGB_DEBIT 

丹东银行-储蓄卡

DYB_DEBIT 

东营银行-储蓄卡

SHINHAN_DEBIT 

新韩银行-储蓄卡

TACCB_DEBIT 

泰安银行-储蓄卡

HANAB_DEBIT 

韩亚银行-储蓄卡

UOB_DEBIT 

大华银行-储蓄卡

QZCCB_DEBIT 

泉州银行-储蓄卡

LSB_DEBIT 

临商银行-储蓄卡

WB_DEBIT 

友利银行-储蓄卡

BOPDS_DEBIT 

平顶山银行-储蓄卡

BOQHB_DEBIT 

青海银行-储蓄卡

AHRCUB_DEBIT 

安徽省农村信用社联合社-储蓄卡

BOBBG_DEBIT 

北部湾银行-储蓄卡

ICBC_CREDIT 

工商银行-信用卡

CMB_CREDIT 

招商银行-信用卡

ABC_CREDIT 

农业银行-信用卡

BOBBG_CREDIT 

北部湾银行-信用卡

CEB_CREDIT 

光大银行-信用卡

GDB_CREDIT 

广发银行-信用卡

BOC_CREDIT 

中国银行-信用卡

CCB_CREDIT 

建设银行-信用卡

BOC_CREDIT 

中国银行-信用卡

CEB_CREDIT 

光大银行-信用卡

GDB_CREDIT 

广发银行-信用卡

PAB_CREDIT 

平安银行-信用卡

CIB_CREDIT 

兴业银行-信用卡

CITIC_CREDIT 

中信银行-信用卡

BOC_CREDIT 

中国银行-信用卡

SPDB_CREDIT 

浦发银行-信用卡

HXB_CREDIT 

华夏银行-信用卡

CMBC_CREDIT 

民生银行-信用卡

COMM_CREDIT 

交通银行-信用卡

PSBC_CREDIT 

邮政储蓄银行-信用卡

NBCB_CREDIT 

宁波银行-信用卡

HZB_CREDIT 

杭州银行-信用卡

BSB_CREDIT 

包商银行-信用卡

BOSH_CREDIT 

上海银行-信用卡

GDNYB_CREDIT 

南粤银行-信用卡

GZCB_CREDIT 

广州银行-信用卡

SRCB_CREDIT 

上海农商银行-信用卡

JSB_CREDIT 

江苏银行-信用卡

ORDOSB_CREDIT 

鄂尔多斯银行-信用卡

BOD_CREDIT 

东莞银行-信用卡

GRCB_CREDIT 

广州农商银行-信用卡

GYCB_CREDIT 

贵阳银行-信用卡

CZB_CREDIT 

浙商银行-信用卡

DRCB_CREDIT 

东莞农商银行-信用卡

CQRCB_CREDIT 

重庆农商银行-信用卡

CZCB_CREDIT 

稠州银行-信用卡

JZCB_CREDIT 

锦州银行-信用卡

HBCB_CREDIT 

湖北银行-信用卡

WZB_CREDIT 

温州银行-信用卡

BOB_CREDIT 

北京银行-信用卡

ZJRCUB_CREDIT 

浙江农信-信用卡

HAINNX_CREDIT 

海南农信-信用卡

WHRC_CREDIT 

武汉农商-信用卡

BJRCB_CREDIT 

北京农商-信用卡

YRRCB_CREDIT 

黄河农商银行-信用卡

FJHXB_CREDIT 

福建海峡银行-信用卡

ZZB_CREDIT 

郑州银行-信用卡

CSRCB_CREDIT 

常熟农商银行-信用卡

XAB_CREDIT 

西安银行-信用卡

BNC_CREDIT 

江西银行-信用卡

HSB_CREDIT 

徽商银行-信用卡

BEEB_CREDIT 

鄞州银行-信用卡

WFB_CREDIT 

潍坊银行-信用卡

CCAB_CREDIT 

长安银行-信用卡

WHB_CREDIT 

威海商业银行-信用卡

NJCB_CREDIT 

南京银行-信用卡

QDCCB_CREDIT 

青岛银行-信用卡

SZRCB_CREDIT 

深圳农商银行-信用卡

TJBHB_CREDIT 

天津滨海农商行-信用卡

BONX_CREDIT 

宁夏银行-信用卡

DANDONGB_CREDIT 

丹东银行-信用卡

MINTAIB_CREDIT 

民泰银行-信用卡

TACCB_CREDIT 

泰安银行-信用卡

DYB_CREDIT 

东营银行-信用卡

BCZ_CREDIT 

沧州银行-信用卡

DLB_CREDIT 

大连银行-信用卡

LZB_CREDIT 

兰州银行-信用卡

AHRCUB_CREDIT 

安徽省农村信用社联合社-信用卡

LSB_CREDIT 

临商银行-信用卡

FDB_CREDIT 

富滇银行-信用卡

QZCCB_CREDIT 

泉州银行-信用卡

HBNX_CREDIT 

湖北农信-信用卡

XYZF_CREDIT 

信用付-信用卡

ABC_DEBIT 

农业银行-储蓄卡

BALANCE 

零钱

MASTERCARD_CREDIT 

MASTERCARD(信用卡)

VISA_CREDIT 

VISA(信用卡)