4.9.3生活缴费代扣模式接口规范


接口涉及两个接口

  • 生活平台请求缴费机构
  • 缴费机构请求生活平台

整个缴费不同的业务接口用字段接口编号trancode区分,不同的接口编号,业务参数(bizdata)内容不一致。

注意事项:

1.如果是沙箱环境,设置is_sandbox=1

2.如果生活缴费平台请求缴费机构是沙箱环境,缴费机构需要返回is_sandbox=1,并且随后发起的callback接口也要带上is_sandbox=1。

3.文档里类型是int的,一定要保证是数字,否则会报异常

接口编号(trancode)

交易名称

交易用途

交易发起方

交易响应方

papayconfigquery

查询代扣配置接口

 

该接口提供给用户在代扣签约之前,需要先查询户号相关信息

建议延迟一秒发起代扣配置请求

生活缴费平台

缴费机构

papayconfigcallback

查询代扣配置通知接口

 

由缴费机构发起,通知用户具体的代扣配置详情

缴费机构

生活缴费平台

papaycontractsign

申请签约/解约接口

由生活缴费平台发起,通知用户已签约或解约

生活缴费平台

缴费机构

papaycontractcallback

申请签约/解约结果回调通知接口

申请签约结果回调通知:用户签约之后,由缴费机构侧通知微信用户的最终解约结果

 

申请解约结果回调通知:用户解约发起申请之后,由缴费机构侧通知微信用户的最终解约结果

缴费机构

生活缴费平台

papayconfigmodify

修改签约配置接口

用户签约之后,如果机构支持可修改代扣配置,可通过该接口进行代扣的配置修改

生活缴费平台

缴费机构

papay

申请代扣扣费接口

 

缴费机构发起代扣申请

缴费机构

生活缴费平台

orderquery

代扣扣费状态查询接口

缴费机构向生活平台查询缴费结果

缴费机构

生活缴费平台

 

  1. 用户进入微信生活缴费小程序,微信主动发起签约配置(papayconfigquery),通联平台会转发到缴费机构(物业,水电煤商户),缴费机构返回收到请求成功
  2. 同时缴费机构调用papayconfigcallback告知微信生活缴费平台签约情况
  3. 假如未签约,微信生活缴费平台引导用户点击签约,调用接口papaycontractsign,通知缴费机构用户发起签约,缴费机构返回已收到通知
  4. 同时缴费机构调用papaycontractcallback告知微信生活缴费平台签约成功
  5. 签约完成后,缴费机构调用papay接口申请代扣扣费
  6. 扣费成功后,通联调用标准交易结果通知接口通知缴费机构交易结果。

缴费机构如果没有收到通知结果,可以调用订单查询接口(orderquery)进行缴费结果查


yinjr 2025年12月11日 11:56 收藏文档