中信银行微信、支付宝支付接口文档问题集锦

  • 关于重复下单的问题

    • Q:支付宝支付的时候,重复提交同一个支付宝订单会提示“订单账号重复”。
      • A:每次请求下单接口,订单号需要更换,不能重复。
    • Q:微信可以重复下单吗?
      • A: 可以,微信下单没有提示重复。当天,微信未支付的订单 可以采用原支付单号在再次请求支付,当天微信未支付的订单 第二天采用原支付单号再去请求接口就会返回 “订单重复提交,请调用订单查询接口查询订单状态!”。
  • 关于支付查询超时

    • Q: 设定时间内,如2分钟,未检测到支付成功,是不是要调用撤销订单的接口?
      • A:2分钟之内未检测到支付成功,刷卡支付需要调用撤销接口,扫码支付需要调用关闭接口。
  • 技术常见问题

    • 关于关闭订单,分两种情况

      • 对于扫码支付接口

        • 扫码支付成功了会有后台消息通知,如果在收款客户端做订单查询轮询,时间可以长一些,例如2分钟(一般这个时间够用),如果到达了轮询最大时间还是未支付状态,要关闭订单,关于关闭订单,分两种情况:
          • 对于微信,调用关闭订单接口,只有未支付的订单才可以调用关闭订单,支付成功的订单调用关闭订单不起作用
          • 对于支付宝,调用撤销接口,如果支付成功了不允许撤销,撤销接口会返回提示"交易成功,请使用退款接口撤销订单"。
      • 对于刷卡支付接口

        • 刷卡支付是没有后台消息通知的,如果消费者端没有出现输入密码的情况,接口当即返回是否支付成功;如果消费者端有出现输入密码的情况,需要调用订单查询接口做轮询对于刷卡支付,如果到达了轮询最大时间还是未支付状态,需要调用撤销接口,这个也分两种情况:
          • 对于微信,如果支付成功了,撤销会自动退款,相当于消费者未支付
          • 对于支付宝,如果支付成功了不允许撤销,撤销接口会返回提示"交易成功,请使用退款接口撤销订单"
    • 订单为什么不停的发送消息通知

      • 订单支付完成,银行会把微信相关的支付和用户信息通过url发送到商户,商户需要接受并且处理,消息通知是通过下单传的notify_url接收的,格式 xml 格式 接收到的参数,空值不参与签名,有值的参数参与签名进行验签,接收到消息通知需要给我们返回一个xml格式的SUCCESS的报文,我们就不会重复发送消息通知

      • 当收到通知进行处理时,首先检查对应业务数据的状态,判断该通知是否已经处理过,如果没有处理过再进行处理,如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。

      • 推荐的做法是,当收到通知进行处理时,首先检查对应业务数据的状态,判断该通知是否已经处理过,如果没有处理过再进行处理,如果处理过直接给我们返回一个xml格式的success的报文,我们就不会重复发送消息通知。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重复插入数据造成的数据混乱。这是返给我们的xml格式success报文。<xml><return_code>SUCCESS</return_code></xml>

    • 消息通知发送规则

      • 发送16次消息通知 前8次10s,
      • 后8次规则 (x-8)(x-8)20;
      • StreamUtils.copyToString(request.getInputStream(), Charset.forName("utf-8"))
    • 下单支付出现sub_appid and sub_openid not match错误?

      • 中信微信后台未配置“子商户appid”,JSAPI时,商户未传openid或openid有误,请检查openid是否正确(openid是由哪个公众号获取的)。订阅号无法支付,要服务号才可以。

    • body参数格式错误?

      • body参数不能为空。

    • 商户数据包attach格式错误?

      • 缺少“`”字符;门店Id填写(格式)错误。

    • 微信服务端添加子商户移动appid时提示“该appid未完成微信认证”?

      • 由于开放平台未认证开发者资质,请申请认证后重试。

    • 支付成功通知不断的给用户下发?

      • 商户返回的成功信息有误,商户提供的通知地址有误。

    • sub_mch_id与sub_appid不匹配?

      • 商户openid生成错误。

    • 统一支付时返回“签名错误”?

      • key不统一,或者加密方法不一样。

    • 支付成功,未推荐关注

      • 支付成功后推荐关注栏目规则:

        • ① 刷卡支付默认有推荐关注
        • ② 公众号支付和扫码支付需要5元以上才有推荐关注。
        • ③ APP支付默认没有,需要申请配置,需要有一定用户规模才可以申请。
        • ④ 已经关注的不展示推荐栏。
        • ⑤ 服务号未设置头像的在IOS不展示推荐关注栏。
        • ⑥ 用户取消过关注的默认不勾选。
    • 多个公众号ID,openid以哪个为准?

      • openid必须与所传的wx_appid对应。

    • 透传接口

      • 透传接口是微信要求的,大商户交易过程中,要附加子商户信息。

    • 调用支付JSAPI缺少参数:appid 是因为授权的原因吗?

      • 用微信返回的参数直接调起jsapi,不用再做签名了,paySign也用返回的。

    • 缺少参数sub_appid,扫码支付?

      • 跟新绑的公众号有关系,参数有修改。

    • 地址报不信任证书的错误

    • 返回xml格式错误?

      • 头部是否有设置为Content-Type:text/xml。

    • 公众号支付终端获取不到二维码?

      • 看下调用统一下单接口是否成功,能否获取到core-url,是否是前端生成二维码出的问题。

    • openid如何获取?

    • 微信可以做长按识别支付吗?

      • 微信把长摁识别二维码付款的功能限制了,要想实现这个效果需要使用公众号接口自己生成二维码,形式上和扫码接口生成的二维码一样,但是是可以直接长按识别二维码支付的。

    • 每天的结算金额,我是不是可以直接用账单做累加就可以了?

      • 要当天(00:00:00-23:59:59)交易的净额-相对应的手续费=当天的清算金额。

  • 关于对账文件的问题

    • Q:如果获取到了对账单,能否确保对账单的数据是全的无遗漏的。

      • A:一般情况下文件数据是全的。
    • Q:对账单是如何获取的,是根据一个渠道商全部获取到还是一个商户一个商户获取的。

      • A:对账单是根据商户号(一户一报)获取的。

    • Q:下载对账文件时,有的商户没有获取到对账文件,如何判断商户是没有交易 还是数据不全。

      • A:商户没有交易情况,对于支付宝返回return_msg为“账单不存在”,对微信返回return_msg为"No Bill Exist"。
      • 对账文件是我们通过接口自动获取的,我们希望能从接口上确定商户D日是否有交易,这个有判断标记吗?

        • 商户没有交易情况,对于支付宝返回return_msg为“账单不存在”;微信返回return_msg为"No Bill Exist"。

      • 支付宝退款接口返回成功,查询接口返回失败的原因是什么?

        • 判断请求是否请求成功:商户可使用该接口查询自已通过alipay.trade.refund提交的退款请求是否执行成功。 该接口的返回码10000,仅代表本次查询操作成功,不代表退款成功。如果该接口返回了查询数据,则代表退款成功,如果没有查询到则代表未退款成功,可以调用退款接口进行重试。重试时请务必保证退款请求号一致。请求退款接口必须返回的字段,您再看一下您提供的退款报文,请求退款接口成功了,但是返回的报文中支付宝订单号transaction_id 是空的。

      • 验签失败可能的原因有哪些?

        • 1、秘钥是否正确;

        • 2、参数为空值的不参与签名;

      • 拉起app支付时用的是微信的appid,还是用中信给的appid?

        • app拉起微信支付使用统一下单接口返回的pay_info里对应的数据,不能做任何修改,这一点和公众号支付是一样的;

      • 中信银行的appid有包名吗?

        • 中信appid不会和包名发生关系,中信提供的appid、商户号、秘钥key只用于中信支付接口的调用,你所说的包名和你们在微信开发者平台申请的微信appid是关联的;

      • 直联微信APP支付和间联中信APP支付的区别是什么?

        • app使用什么样的包名和微信的appid和原来一样,使用中信APP支付的区别是:

          • 1、拉起微信支付需要的七个参数appid、partnerid、prepayid、timeStamp、nonceStr、package、sign要全部使用中信app支付返回的pay_info里对应的数据;
          • 2、 中信提供的appid、商户号、秘钥key只用于中信支付接口的调用;
          • 其他和原来一样;
      • 微信和支付宝二维码有效期是多久?

        • 支付宝默认的有效时间是20十分钟,微信默认的有效时间是2个小时

      • 当天未支付的订单,重复下单支付宝不允许,但是微信可以;

      • code_url生成的二维码和code_img_url生成的二维码有什么区别?

        • 采用code_url生成二维码好处就是便于你们控制自己产品UI做的好看点,使用code_img_url二维码图片样式固定无法定制

    • Q:用户有可能点击微信支付,扫描支付了,网络问题没有反应或收到支付通知,以为没有支付成功,又点击支付宝进行支付了,一个订单号共支付2次这种情况

      • A:客户的业务系统做互斥处理;切换前需要业务系统先确认一下这笔是否支付成功,然后再决定后面的业务流程。

        • Q:在切换前我们这边也没有收到支付成功的回调通知,我们业务流程还是未支付的状态,这种情况用户还是可以选择其他支付方式的
        • A:这个时候您可以调用查询接口,查询订单状态。
    • 什么是支付授权目录?

      • 支付授权目录指的是支付页面所在的目录(只要是这个目录下的页面都可以);通俗来讲就是用户选完商品然后点击支付这个页面的全路径(不包括页面)最后以 / 结尾

    • 商户验签类问题:

      • 空值不参与签名,有值的参数都参与签名;建议返回的参数不要写死

    • 微信公众号:signType是MD5,为什么pay_info不是MD5而是RSA?

      • 中信新规定。

    • 商户退款报错"退款订单号重复提交",第二次更换退款订单号后报错"退款金额超限",如何处理。

      • 次日对账后发起新的退款即可。

    • 微信固定二维码(公众号)用户完成支付,微信弹出支付完成页面,下面有个完成按钮,点击完成跳转的页面是客户自己配置还是我们配置?

      • 中信通道商户可以用我们的;其它通道客户需要自己配置,否则点击完成会回到输入密码页面,开发如何配置这个页面可以参考微信JS支付官方文档

    • 刷卡接口没有支付结果通知接口,如何判断订单支付成功?

      • 刷卡接口没有支付结果通知接口,需要调用查询接口来判断接口是否返回成功;如果想查询订单是否支付成功,根据trade_state判断即可(result_code和return_code都返回success,trade_state才可以正常返回结果。)

        • 微信:REFUND代表有退款(部分退款或全额退款)。
        • 支付宝:CLOSED代表已关闭(超时关闭,或调用了关闭接口关闭,或已经全额退款)。
    • 聚合扫码提示“获取预支付信息失败”是什么原因?

      • 商户管理端没有配置。
    • 聚合扫码和普通扫码有什么区别?

      • 聚合码并不是一种实际的支付类型,而是一种产品。(它实际还是指向微信js、支付宝服务窗、银联扫码【一般不说】)

    • 微信公众号支付时商户传入xxx参数不正确,请联系商户

      • 商户要将下单返回的pay_info里的6个参数原封不动的传给支付js

    • 关于微信和支付宝的time_start 和 time_expire问题

      • 扫码接口支付宝二维码默认有效期20分钟,微信没有控制需要商户自己下单控制。

      • 支付宝的time_start 和 time_expire 相差时间 最低1分钟,不足1分钟按1分钟计算,例如1分1秒,按照2分钟计算,1秒按照1分钟计算。

    • 关于支付宝订单超过有效期调用查询接口返回userpaying和colse问题

      • 有两种情况

        • ①商户下单后,用户完成了扫码动作,超过订单有效期也未支付的情况,调用查询接口则返回CLOSED;

        • ②商户下单后,用户未扫码,超过订单有效期后,调用查询接口则返回USERPAYING;

      如果您想超过订单有效期后都返回CLOSED,可以在超过订单有效期后调用关闭
      • 刷卡接口问题

        • 对于刷卡接口,不管返回成功或失败都要做订单查询。
      • 为什么对账单要先做xml解析

        • 因为有账单文件才会返回,没有就会返回xml提示未生成或者在生成

      • 关于return_code和result_code的问题

      • 我们在协议级做了拦截,只有当协议级正确的情况下才会有业务级数据产生,应该先判断return_code,如成功再判断result_code;如果return_code返回了fail,可直接将本次请求调用接口定义为失败。

      • 退款状态异常如何处理,银盈通:

      • 1.调用退款接口,result_code返回FAIL, 或者 return_code 返回FAIL,就代表这笔订单退款接口调用失败,可以认定为退款失败。

      • 2.如果返回信息是“xxx异常”,或“xxx超时”。条件1不能完全作为判断标准,需要调用查询接口,确认最终状态。

      • 3.根据对账单处理:对账单第二天生成后,当天退款异常的订单,可以根据第二天的对账结果处理。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容

  • 关于微信支付 生活中的微信支付 目前我们日常生活中接触得比较多的线上电子支付方式主要有两种,一种是支付宝,另一种就...
    积_渐阅读 3,907评论 3 26
  • 大雨, 逼着我踏入破庙 这破庙真大, 大到我都迷惘。 红瓦黄檐 朱红却斑驳的门上 留下一个不起眼的 小手印。 雷声...
    龙雨寒阅读 206评论 0 1
  • 自从和轻舞飞扬见过面之后,我们的关系并没有如我想象中进展迅速。那仍然还是一个没有手机的年代,我们的联系也只能通过论...
    舍山阅读 511评论 4 1
  • 小赌怡情,大赌伤身。很多人都有听到过这句话,也基本是很多喜欢对赌游戏的人所常常信奉的。这话的意义大多数人理解都是认...
    赵程冲阅读 276评论 0 0
  • 刚刚看完《不二情书》,看到小虾怯生生的把最后一封信交给正在给小虾写信的Daniel,双目的对视。一切的猜测在Dan...
    傻傻的塔工阅读 487评论 0 1