开发指引

开发前，开发者需要完成如下两个步骤：配置开发参数和配置产品功能。

• 当用户通过商户提供的入口申请使用服务后，商户系统调用支付分从业机构预授权接口，再根据返回参数拉起支付分授权界面。

• 用户授权后商户调用支付分创单接口，创单成功后商户向用户提供服务。

• 服务结束后商户通过完结订单接口告知支付分需要收款，由支付分完成自动扣款，最后通过下载交易账单进行对账。特殊需要退款的服务订单，也可调用退款接口完成退款。

• 整个业务开发过程中的前端UI交互，需要满足支付分合作品牌线上应用规范。

• 用户申请使用服务时，商户需要先查询该用户是否授权使用服务。

• 未授权用户申请使用服务时，商户需调用从业机构预授权接口获取预授权token(1小时内有效)，再根据使用支付分的载体选择对应API接口拉起支付分小程序授权页让用户完成授权，移动应用类型使用APP调起支付分授权服务，公众号类型使用JSAPI调起支付分授权服务，小程序类型使用小程序调起支付分授权服务，授权成功或解除授权会有开启授权/解除授权回调通知，商户也可调用查询用户授权记录主动查询。已授权用户可以直接到下一创单环节。

预授权接口需要注意的参数：

商户调用创建支付分订单API接口生成订单

下单接口需要注意的参数：

• 商户创单成功后可以开始向用户提供服务。

• 服务完成后，商户需调用完结支付分订单API，通知微信支付服务已结束(collection.state参数变为USER_PAYING状态，即用户待支付状态)。在接口参数中，商户需要通过post_payments字段，上传本笔订单实际的付费项目明细，不同的场景有不同的传值要求，详见：post_payments(后付费项目)字段传参说明

• 订单完结后，支付分会持续自动扣款，无需重复调用完结接口。

完结订单接口需要注意的参数：

商户调用完结支付分订单API成功后，可以登记扣款信息并通过清算机构(银联/网联)的委托代扣接口进行自动扣款。

商户也可以调起支付分小程序订单详情页引导用户主动支付，用户尝试主动支付时会发送商户预下单通知，此时商户需要调用清算机构(银联/网联)统一下单接口，并将下单结果返回给微信，由微信拉起收银台让用户主动支付。

间连支付分不支持使用代金券。

自动扣款成功或失败清算机构(银联/网联)会给商户系统发送代扣结果通知，主动支付成功后微信会向商户发送支付成功回调，支付成功后支付分订单结束。商户系统也通过调用查询支付分订单API或者银联查单接口主动查询订单支付情况。

下面介绍几种扣款过程中的异常处理情况(存在登记生效的扣款单，需要等24h扣款单失效或者调用清算机构(银联/网联)关单接口关闭扣款单)：

• 如果订单在“待支付”状态下（collection.state: USER_PAYING），若扣款金额有误可调用修改订单金额API修改订单金额，系统将按照修改后的金额发起扣款(注意只能下调扣款金额)。

• 如果订单在“待支付”状态下（collection.state: USER_PAYING），若不需要继续扣款，希望微信支付分停止继续扣款。可调用取消支付分订单API取消待支付的支付分订单，支付分订单将变成已取消状态。

• 如果订单在“待支付”状态下（collection.state: USER_PAYING），用户通过其他方式完成支付，商户可调用同步订单信息API将订单支付成功状态同步给微信支付，后续微信支付将不再发起扣款，支付分订单将变成已完成状态。

商户可以通过清算机构(银联/网联)接口下载账单文件对账，如对账单文件有疑惑请咨询清算机构(银联/网联)。

支付分订单支付后，若订单需要退款，商户调用清算机构(银联/网联)接口申请退款，如退款接口有疑惑请咨询清算机构(银联/网联)。

2、当支付分订单状态在待支付状态(collection.state: USER_PAYING)下，商户可以调用接口修改订单金额，修改成功后微信侧将按新金额发起扣款。

3、当支付分订单状态为已创建(state:CREATED)和用户已确认订单(collection.state: USER_CONFIRM)和待支付状态(collection.state: USER_PAYING)下，商户可以调用取消服务订单接口，取消支付分服务订单。

• state：EXPIRED

• state：REVOKED

• state：DONE

商户侧使用测试微信号完成开发测试后，需按照以下流程进行验收和上线工作(验收审核通过后对应服务才能配置上线并开放用户使用)：