微信

:::tip[]
请确保已经查阅接入准备-微信文档，并完成相关前置准备后查看本文档。
:::

接入流程指引

:::tip[]
微信支付有四种支付产品，请参考对应产品的接入流程指引。
:::

微信主扫

商户服务器端调用连连 [网关支付-统一创单](https://api-doc.lianlianpay.com/openplatform/api-3477937) 接口，支付方式`pay_type`传`WECHAT_NATIVE`微信扫码，接口返回微信扫码支付的参数，下方附`payload`参考示例。 ```json "payload":"https://payment.lianlianpay.com/mpayweb/qrcodepay?token=81E4830ED853DF12D5043A060023****" ``` 获取`payload`参数的地址后，按链接生成二维码，让用户扫码完成支付。有如下两种方式用于获取交易结果，请按需选择。 - 接入 [收款结果异步通知](https://api-doc.lianlianpay.com/openplatform/api-3477973) ，连连会异步下发收款结果。（推荐） - 调用 [收款查询](https://api-doc.lianlianpay.com/openplatform/api-3477956) 接口主动查询收款结果。

微信小程序

商户网页端选择微信支付时，通过微信官方H5短链生成方法拉起微信小程序，传入商品订单信息。 > 获取小程序 URL Link，适用于短信、邮件、网页、微信内等拉起小程序的业务场景。目前仅针对国内非个人主体的小程序开放，详见微信官方调用说明。

    [微信官方调用说明获取URL Link](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/qrcode-link/url-link/generateUrlLink.html)
    [微信官方调用说明调用支付SDK](https://developers.weixin.qq.com/miniprogram/dev/api/payment/wx.requestPayment.html)
      
    > 下面为微信小程序demo，解密密码是 20220427
      
    [微信小程序Demo](https://mpay-static.oss-cn-hangzhou.aliyuncs.com/assets/file/mpay-mini-program-web-0712.zip)
  </Step>
  <Step title="获取用户openid">
    小程序用户 [静默授权获取用户openid](https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html)，根据网页端端传入的商品订单信息向服务器端发起支付请求。
  </Step>
  <Step title="获取拉起微信支付的参数">
    商户服务器端调用连连 [网关支付-统一创单](https://api-doc.lianlianpay.com/openplatform/api-3477937) 接口，支付方式`pay_type`传`WECHAT_APPLET`微信小程序，接口返回拉起微信小程序支付的参数，下方附`payload`参考示例。

{
    "payload": "{\"metadata\":{\"timeStamp\":\"1705406805\",\"rateLevel\":\"W3\",\"package\":\"prepay_id=wx162006457806863aa123703cdf********\",\"paySign\":\"RQjqbWjRlgv57Yq2D9+NKx1LqrDqXmi4YlInHykhDXU8stU4jhjGvOQAGMZrBgH2zr8arvPtIplklbLP5uG2oThUJz14IBf8UbaCLMZo/AH2jgRDsrYCw8IZrRmT5O7AGbXsI5gRUcdGvMaR47FqIgLzMrViwykab57MVibuuoRxVcvbX57vgHEAJvPkV7UXJsABJBuSo5efXtNIOnSWb0SDUHxSrHFjhmVcj7kRiX1540S/OwuCja/vt//gqHCbSI17UWZm+NM9yumnBzl5G93Q2nxqSnRfiCahKA0oR5tNywyu23RCoSfyVDg6ZUrA5PrvCXuRe322/Q5n********\",\"appId\":\"wx24b70f0ad2a9****\",\"signType\":\"RSA\",\"nonceStr\":\"0be49d5fc1034e05859bfee02e******\"},\"gateway_url\":\"\"}"
}

  </Step>
  <Step title="拉起微信小程序支付">
    小程序使用上一步获取的`payload`中的参数拉起微信小程序支付，供用户完成支付。
  </Step>
  <Step title="获取交易结果">
      有如下两种方式用于获取交易结果，请按需选择。

      接入 [收款结果异步通知](https://api-doc.lianlianpay.com/openplatform/api-3477973) ，连连会异步下发收款结果。（推荐）

      调用 [收款查询](https://api-doc.lianlianpay.com/openplatform/api-3477956) 接口主动查询收款结果。
</Step>

APP端选择微信支付时，通过微信SDK拉起小程序，传入商品订单信息 > 考虑到部分场景下 APP 需要通过小程序来承载服务，为此 OpenSDK 提供了移动应用（APP）拉起小程序功能。移动应用（APP）接入此功能后，用户可以在 APP 中跳转至微信某一小程序的指定页面，完成服务后再跳回至原 APP。移动应用拉起小程序功能已向全体开发者开放，开发者在微信开放平台帐号下申请移动应用并通过审核后，即可获得移动应用拉起小程序功能权限。详情请参考下方官方调用说明。

  [微信官方说明-Android](https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/Android_Development_example.html)
  [微信官方说明-iOS](https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/iOS_Development_example.html)
    
  > 下面为微信小程序demo，解密密码是 20220427
    
  [微信小程序Demo](https://mpay-static.oss-cn-hangzhou.aliyuncs.com/assets/file/mpay-mini-program-web-0712.zip)
</Step>
<Step title="获取用户openid">
  小程序用户 [静默授权获取用户openid](https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html)，根据APP端传入的商品订单信息向服务器端发起支付请求。
</Step>
<Step title="获取拉起微信支付的参数">
  商户服务器端调用连连 [网关支付-统一创单](https://api-doc.lianlianpay.com/openplatform/api-3477937) 接口，支付方式`pay_type`传`WECHAT_APPLET`微信小程序，接口返回拉起微信小程序支付的参数，下方附`payload`参考示例。

{
    "payload": "{\"metadata\":{\"timeStamp\":\"1705406805\",\"rateLevel\":\"W3\",\"package\":\"prepay_id=wx162006457806863aa123703cdf********\",\"paySign\":\"RQjqbWjRlgv57Yq2D9+NKx1LqrDqXmi4YlInHykhDXU8stU4jhjGvOQAGMZrBgH2zr8arvPtIplklbLP5uG2oThUJz14IBf8UbaCLMZo/AH2jgRDsrYCw8IZrRmT5O7AGbXsI5gRUcdGvMaR47FqIgLzMrViwykab57MVibuuoRxVcvbX57vgHEAJvPkV7UXJsABJBuSo5efXtNIOnSWb0SDUHxSrHFjhmVcj7kRiX1540S/OwuCja/vt//gqHCbSI17UWZm+NM9yumnBzl5G93Q2nxqSnRfiCahKA0oR5tNywyu23RCoSfyVDg6ZUrA5PrvCXuRe322/Q5n********\",\"appId\":\"wx24b70f0ad2a9****\",\"signType\":\"RSA\",\"nonceStr\":\"0be49d5fc1034e05859bfee02e******\"},\"gateway_url\":\"\"}"
}

  </Step>
  <Step title="拉起微信小程序支付">
    小程序使用上一步获取的`payload`中的参数拉起微信小程序支付，供用户完成支付。支付完成后，***微信小程序自带返回APP按钮，返回商户APP。***
  </Step>
  <Step title="获取交易结果">
      有如下两种方式用于获取交易结果，请按需选择。

      接入 [收款结果异步通知](https://api-doc.lianlianpay.com/openplatform/api-3477973) ，连连会异步下发收款结果。（推荐）

```
      调用 [收款查询](https://api-doc.lianlianpay.com/openplatform/api-3477956) 接口主动查询收款结果。
</Step>
```
:::caution[注意事项] B小程序：需要先开通微信支付功能后对接微信官方的支付SDK，并且将小程序发布到体验版。 [参考微信官方文档](https://developers.weixin.qq.com/miniprogram/dev/api/payment/wx.requestPayment.html) ::: A小程序服务器端调用连连 [网关支付-统一创单](https://api-doc.lianlianpay.com/openplatform/api-3477937) 接口，支付方式`pay_type`传`WECHAT_APPLET`微信小程序，接口返回拉起微信小程序支付的参数，下方附`payload`参考示例。 ```json { "payload": "{\"metadata\":{\"timeStamp\":\"1705406805\",\"rateLevel\":\"W3\",\"package\":\"prepay_id=wx162006457806863aa123703cdf********\",\"paySign\":\"RQjqbWjRlgv57Yq2D9+NKx1LqrDqXmi4YlInHykhDXU8stU4jhjGvOQAGMZrBgH2zr8arvPtIplklbLP5uG2oThUJz14IBf8UbaCLMZo/AH2jgRDsrYCw8IZrRmT5O7AGbXsI5gRUcdGvMaR47FqIgLzMrViwykab57MVibuuoRxVcvbX57vgHEAJvPkV7UXJsABJBuSo5efXtNIOnSWb0SDUHxSrHFjhmVcj7kRiX1540S/OwuCja/vt//gqHCbSI17UWZm+NM9yumnBzl5G93Q2nxqSnRfiCahKA0oR5tNywyu23RCoSfyVDg6ZUrA5PrvCXuRe322/Q5n********\",\"appId\":\"wx24b70f0ad2a9****\",\"signType\":\"RSA\",\"nonceStr\":\"0be49d5fc1034e05859bfee02e******\"},\"gateway_url\":\"\"}" } ``` A小程序利用`wx.navigateToMiniProgram`方法跳转到B小程序，并通过`extraData`将参数传递给B小程序。参考 [微信官方文档](https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html)

B小程序使用连连微信支付宝支付接口返回payload中的参数调用wx.requestPayment拉起微信收银台进行支付。

有如下两种方式用于获取交易结果，请按需选择。

      接入 [收款结果异步通知](https://api-doc.lianlianpay.com/openplatform/api-3477973) ，连连会异步下发收款结果。（推荐）

```
      调用 [收款查询](https://api-doc.lianlianpay.com/openplatform/api-3477956) 接口主动查询收款结果。
</Step>
```
常见问题
- 如何将被跳转的微信小程序发布？
  
  小程序发布体验版流程、发布正式版流程参考本文档
- 被跳转的微信小程序需要发布到正式版吗？
  由于微信的限制，若跳转小程序是正式版本，则被跳转的小程序必须发布到正式版本，若跳转小程序是体验版，则发布到体验版即可。参数通过enVersion指定。

小程序用户静默授权获取用户openid，传入商品订单信息向服务器端发起支付请求。服务器端调用连连[网关支付-统一创单](https://api-doc.lianlianpay.com/isv/api-3487941) 接口，支付方式method传WECHAT_APPLET 微信小程序,拓展字段传小程序appid和openid，接口返回拉起微信小程序支付的参数，下方附payload 参考示例。 ```json { "payload":"{\"metadata\":{\"timeStamp\":\"1705406805\",\"rateLevel\":\"W3\",\"package\":\"prepay_id=wx162006457806863aa123703cdf********\",\"paySign\":\"RQjqbWjRlgv57Yq2D9+NKx1LqrDqXmi4YlInHykhDXU8stU4jhjGvOQAGMZrBgH2zr8arvPtIplklbLP5uG2oThUJz14IBf8UbaCLMZo/AH2jgRDsrYCw8IZrRmT5O7AGbXsI5gRUcdGvMaR47FqIgLzMrViwykab57MVibuuoRxVcvbX57vgHEAJvPkV7UXJsABJBuSo5efXtNIOnSWb0SDUHxSrHFjhmVcj7kRiX1540S/OwuCja/vt//gqHCbSI17UWZm+NM9yumnBzl5G93Q2nxqSnRfiCahKA0oR5tNywyu23RCoSfyVDg6ZUrA5PrvCXuRe322/Q5n********\",\"appId\":\"wx24b70f0ad2a9****\",\"signType\":\"RSA\",\"nonceStr\":\"0be49d5fc1034e05859bfee02e******\"},\"gateway_url\":\"\"}" } ``` 小程序使用连连微信支付宝支付接口返回 payload 中的参数拉起微信小程序支付https://developers.weixin.qq.com/miniprogram/dev/api/payment/wx.requestPayment.html 支付成功后，实时触发异步通知到商户服务器端。

 </Steps>
</Tab>

微信公众号

商户服务端调用 [网关支付-统一创单](https://api-doc.lianlianpay.com/openplatform/api-3477937) 接口，支付方式`pay_type`选择`WECHAT_JSAPI`微信公众号，扩展参数中必须上传`appid`以及`openid`,接口返回拉起微信公众号支付的`payload`参数。调用微信sdk，用上一步返回的参数拉起公众号支付，供用户完成支付。详情请参考 [官方调用说明](https://developers.weixin.qq.com/miniprogram/dev/api/payment/wx.requestPayment.html) 有如下两种方式用于获取交易结果，请按需选择。 - 接入 [收款结果异步通知](https://api-doc.lianlianpay.com/openplatform/api-3477973) ，连连会异步下发收款结果。（推荐） - 调用 [收款查询](https://api-doc.lianlianpay.com/openplatform/api-3477956) 接口主动查询收款结果。

微信被扫

用户出示微信付款码。扫描用户付款码获取用户付款码信息`auth_code`，微信付款码规则为18位纯数字，前缀以10、11、12、13、14、15开头，支付方式`pay_type`传入微信付款码`WECHAT_MICROPAY`，调用 [条码支付-统一支付](https://api-doc.lianlianpay.com/openplatform/api-3477938) 接口传入对应参数进行支付。有如下两种方式用于获取交易结果，请按需选择。 - 接入 [收款结果异步通知](https://api-doc.lianlianpay.com/openplatform/api-3477973) ，连连会异步下发收款结果。（推荐） - 调用 [收款查询](https://api-doc.lianlianpay.com/openplatform/api-3477956) 接口主动查询收款结果。

微信

接入流程指引

微信主扫

微信小程序

常见问题

微信公众号

微信被扫