支付宝微信合单支付

文章来自:https://blog.vchar.top/java/1613828179.html

什么场景下会用到合单支付呢?下面举个例子:最常见的就是商城系统了,比如用户在一笔订单里面选择了多个不同商户的商品, 为了用户体验,在支付的时候肯定是只需要支付一次即可的;
如果我们使用传统的方式即实际后就是一笔订单,直接支付下单即可,这里确实简单了,但是我们在给商户做结算的时候就麻烦了,需要后台去统计相关的财务信息然后再打款给商户;
但是如果不想去做这样复制的结算步骤,或者是可能刚开始我们的平台名气小,商户不太信任,想自己看到相关的支付账单信息。

此时我们就可以采用 微信的电商收付通 和 支付宝互联网平台直付通产品;它们都提供了多笔订单一起支付,最后金额自动分配的商家的账户上、账单资金冻结、结算、平台抽成的功能。
下面来谈谈在与它们对接的相关注意事项吧。

相关接口文档

关于二级商户进件

打开接口文档微信和支付的进件需要的资料都是一大坨,一看就是感觉很麻烦!在对接的时候不要管那么多,先用需要资料最少最简单的参数进件成功一个再说(快速理清认证流程和需要的相关资料),同时也方便其他对接支付的同学可以调试后面的支付和结算相关接口(不然后面就会卡住,很多问题不能提前发现);

微信的电商收付通二级商户进件说明

进件的相关参数直接看官方文档即可,需要说明的是在进件的通过后,会返回一个认证的链接的二维码,需要商户去扫码确认,同时银行卡认证微信需要打款确认。

支付宝的互联网平台直付通二级商户进件说明

  • 默认结算规则必须传入(虽然不传入也是可以成功的),否则后面进行支付下单的时候会失败;
  • 虽然文档中写了结算账号可以是银行卡,但是实际是不支持,只支持支付宝账号;
  • 进件接口请求成功后,在支付宝中登陆设置的结算账号的支付宝账号,然后搜索 '签约助手' 进入里面签约;具体的流程图
  • 在进件商户签约成功后(也就是上面一步的操作完成后),支付宝会回调通知我们(通知地址需要在支付宝开发者中配置);
  • 注意选择使用的支付宝SDK alipay-sdk-java 的包最好用最新的;因为旧的版本创建进件的接口中自带的AntMerchantExpandIndirectZftCreateModel转换json转换不出sites,导致进件请求失败。

关于支付接口

微信的合单支付说明

  • 生成的合单订单号在后面查询订单的时候是需要的,不能通过子单号进行查询;但是在退款、分账操作的时候使用的是子单的订单号。
  • 支付成功回调通知说明:支付成功后会将支付信息返回,其结构类似如下:
{
  "combine_out_trade_no": "合单订单号",
  "sub_orders": [
    {
      "out_trade_no": "子单订单号",
      "transaction_id": "子单交易订单号",
      ...
    },
    {
      "out_trade_no": "子单订单号",
      "transaction_id": "子单交易订单号",
      ...
    }
    ...
  ],
  ...
}
  • 其他的流程和操作和普通的支付是一样的;退款的时候合单支付有专门的接口进行,同时合单支付使用的是新版本接口;
  • 注意H5和微信公众号的jsapi支付需要在微信后台配置的安全域名,直接配置域名根目录即可(如:https://www.baidu.com/),否则将无法成功唤起支付(提示当前URL未注册);同时需要注意微信是会区分http和https的,不要用特殊字符。

支付宝的合单支付接口说明

  • 生成的合单订单号就只在预下单的时候有用,后面都不会用了;
  • 支付成功回调通知说明:虽然是合单支付的,但是支付宝的通知还是一笔笔的分开通知,即有多少个子单就有多少个通知(和普通的没有区别);其结构类似如下:
{
  "out_trade_no": "子单订单号",
  "trade_no": "子单交易订单号",
  ...
}
  • 如果只有一笔订单,那么不能使用合单支付的接口,要使用普通的单个支付的接口接口,如手机网站支付就使用alipay.trade.wap.pay接口即可;和普通下单的区别就是添加SettleInfo信息(支付宝提供的skd是支持设置这个的参数的:AlipayTradeWapPayModel.setSettleInfo());下面是一个示例:
{
  "outTradeNo": "202002220016444498",
  "productCode": "QUICK_WAP_WAY",
  "settleInfo": {
    "settleDetailInfos": [
      {
        "amount": "0.01",
        "transInType": "defaultSettle"
      }
    ],
    "settlePeriodTime": "365d"
  },
  "subMerchant": {
    "merchantId": "11112464984"
  },
  "subject": "网球排一个",
  "timeoutExpress": "15m",
  "totalAmount": "0.01"
}
  • 关于统一收单合并支付预创建接口中的产品码productCode说明:注意文档上的是错误的,我们按实际使用修改即可。app 支付上送:QUICK_MSECURITY_PAY,wap 支付上送:QUICK_WAP_WAY。可以直接参考 支付宝的下单示例 ;注意看文档中的注意说明。
  • 如果不清楚的话或者接口一直报错找不到问题,直接找支付宝的人工技术支持吧。

关于订单结算接口

微信和支付宝的分账接口还是存在细微差别的。注意如果你不需要分账的话,那么就不需要调用分账接口。
如果分账失败的话在重试的时候建议还是使用原来的分账单号,避免多分(支付宝和微信那边是做了幂等的);

退款是先退该订单冻结的金额,如果不够的话会直接从商户的账号上扣除金额;如果都不够那么就会退款失败

微信的订单结算说明

微信分账接口是异步处理的,因此你需要在请求分账接口后,手动去查询一下分账是否成功。如果不需要分账的话,那么直接调用完结分账即可;注意完结分账也是异步的。

调用分账或者是完结分账接口后,资金会自动解冻(也就是二级商户可以直接提现到银行卡了);

注意:微信是提供了查询二级商户资金信息的操作接口的,如:账户余额信息、提现到银行卡等。

支付宝的订单结算说明

支付宝在调用分账接口前需要先调用确认结算接口,注意调用确认结算接口后,该笔订单的资金就会解冻到商户绑定的支付宝账号上去了;同时支付宝的分账接口是同步的(即请求后立即就知道分账结果了)。

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

推荐阅读更多精彩内容