获取小程序链接

<p><strong>使用场景：</strong> </p> <ul> <li>业务系统在外部浏览器生成订单参数，获取访问通企付小程序的链接，用户通过对应链接打开通企付小程序收银台，通企付收银台小程序负责渠道下单支付，并返回交易结果。</li> </ul> <p><strong>请求URL：</strong> </p> <ul> <li><code>applet/getAppletUrl</code></li> </ul> <p><strong>请求方式：</strong></p> <ul> <li>POST </li> </ul> <p><strong>请求类型：</strong></p> <ul> <li>application /json</li> </ul> <p><br> <strong>请求参数：</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">orgId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>服务商id，用于服务商模式，传了此参数需要用服务商秘钥进行验签</td> </tr> <tr> <td style="text-align: left;">mchNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>商户号</td> </tr> <tr> <td style="text-align: left;">appId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>应用ID，默认为商户appId，若为服务商模式，需传入服务商appId</td> </tr> <tr> <td style="text-align: left;">reqTime</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>请求时间，13位时间戳</td> </tr> <tr> <td style="text-align: left;">version</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>接口版本，固定：1.0</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>签名</td> </tr> <tr> <td style="text-align: left;">signType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>签名类型，MD5/RSA/SM2</td> </tr> <tr> <td style="text-align: left;">mchOrderNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>商户订单号</td> </tr> <tr> <td style="text-align: left;">amount</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>金额（单位：分）</td> </tr> <tr> <td style="text-align: left;">body</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>描述</td> </tr> <tr> <td style="text-align: left;">goodsInfo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>商品备注，为List<goodsInfo>的JSON字符串，使用B2B订单支付时必填</td> </tr> <tr> <td style="text-align: left;">notifyUrl</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>通知地址</td> </tr> <tr> <td style="text-align: left;">validTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>链接有效期，单位秒，不传默认120秒，最小120秒，最大36000秒</td> </tr> <tr> <td style="text-align: left;">expiredTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>订单有效期,单位秒,默认1小时</td> </tr> <tr> <td style="text-align: left;">remark</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>订单备注</td> </tr> <tr> <td style="text-align: left;">channelExtra</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>渠道参数，JSON字符串，特定渠道发起的额外参数，例：收银宝子商户号cusid</td> </tr> <tr> <td style="text-align: left;">payTypeInfo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>收银台展示的付款方式，以逗号(,)隔开；<br><strong>注释：</strong><br>WX_PAY（微信）,<br>ALI_PAY（支付宝）,<br>C_PAY（个人银行卡）,<br>B_PAY（企业网银）,<br>LOAN_PAY（信用支付）；</td> </tr> <tr> <td style="text-align: left;">directPayType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>直接支付的支付方式，填入该参数则自动使用该支付方式下单并拉起支付，当前支持：<br>WX_LITE：微信小程序支付；<br>SFT_HRJ：通联汇入金；<br>ALI_QR：支付宝支付（访问通企付微信小程序收银台可用）；<br>ALI_JSAPI：支付宝JS支付（访问通企付支付宝小程序收银台可用）；<br>ALI_CREDIT：花呗分期</td> </tr> <tr> <td style="text-align: left;">urlType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>生成链接方式，URL_Common（<strong>返回appletUrl字段值需要业务系统转化为二维码后，由用户使用微信或支付宝扫码完成支付。</strong>此生成链接方式，适用于用户在PC端下单、手机扫码完成支付的场景）</td> </tr> </tbody> </table> <p><br></p> <table> <thead> <tr> <th style="text-align: left;">goodsInfo参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">goodsnm</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商品简称</td> </tr> <tr> <td style="text-align: left;">goodsamt</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>商品金额（单位：元）</td> </tr> <tr> <td style="text-align: left;">goodsnum</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>商品数量</td> </tr> </tbody> </table> <p><br></p> <p><strong>返回参数</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>返回状态：0-处理成功，9999-异常，具体错误详见msg字段</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>返回信息：具体错误原因，例如：签名失败、参数格式校验错误</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>签名信息：对data内数据签名，如data为空则不返回</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>返回数据：json格式数据</td> </tr> </tbody> </table> <p><strong>data数据格式</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">appletUrl</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>访问路径，<strong>该字段值需要业务系统转化为二维码后，由用户使用微信或支付宝扫码完成支付。</strong></td> </tr> <tr> <td style="text-align: left;">urlType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>生成链接方式，URL_Common（该链接支持访问微信、支付宝小程序）</td> </tr> </tbody> </table> <p><strong>返回示例：</strong></p> <p>{ "code": 0, "data": { "appletUrl": "<a href="https://wxaurl.cn/xxxxx&quot">https://wxaurl.cn/xxxxx&quot</a>;, "urlType": "URL_Common" }, "msg": "SUCCESS", "sign": "713B50182CAFC8B7B71CEE94D1D0A1B7" }</p>

通企付

获取小程序链接

页面列表