微信物业缴费接口列表
1、接口清单
| 序号 | 接口名称 | 必须 | 调用链路 | 说明 |
|---|---|---|---|---|
| 1 | 楼房信息推送API | Y | 物业SaaS -> 银盛生活缴费中台 ->微信生活缴费 | 物业公司上送小区房屋信息。每上线一个新项目（小区）时，需调用此接口，将小区楼房信息推送至微信生活缴费，方便用户缴费时选择对应的楼房 |
| 2 | 账单管理API | Y | 物业SaaS -> 银盛生活缴费中台 ->微信生活缴费 | 由物业公司向银盛同步物业缴费账单，用户可通过微信生活缴费平台查询房屋的待缴费账单 |
| 3 | 主动支付核销通知API | Y | 物业SaaS <- 银盛生活缴费中台 <- 微信生活缴费 | 用户支付成功后，微信侧通知银盛发起销账，银盛再通知物业公司发起销账；物业公司收到销账请求后需立即应答，告知已收到销账通知。如需查询销账状态，可通过账单查询结果获取 说明：物业SaaS需提供账单核销通知URL给银盛运营同事 |
| 4 | 账单主动支付核销结果查询API | Y | 物业SaaS -> 银盛生活缴费中台 ->微信生活缴费 | 统一网关封装缴费结果查询接口，物业公司可通过此接口查询账单状态与缴费信息 |
| 5 | 主动支付核销通知API | Y | 物业SaaS <- 银盛生活缴费中台 <- 微信生活缴费 | 统一网关封装物业账单回调通知接口，当物业公司更新账单状态时，可通过此接口将结果同步给银盛生活缴费中台。例如，用户线下完成物业费缴纳后，物业公司销账后调用此接口，将账单状态更新为销账成功 |
| 6 | 申请代扣签约/代扣解约接口API | Y | 物业SaaS <- 银盛生活缴费中台 <- 微信生活缴费 | 用户在微信生活缴费平台申请自动缴费（签约代扣）时，由微信侧发起，通知商户用户已完成签约或解约；用户签约/解约后，商户侧需向微信反馈最终的解约结果 |
| 7 | 账单代扣查询API | Y | 物业SaaS -> 银盛生活缴费中台 ->微信生活缴费 | 物业公司根据账单与房屋签约信息发起代扣申请，微信将自动对签约用户执行代扣扣费 |
| 8 | 代扣结果通知API | Y | 物业SaaS -> 银盛生活缴费中台<- 微信生活缴费 | 异步通知代扣扣费结果，将扣费结果推送至物业SaaS平台 |
| 9 | 账单代扣查询API | Y | 物业SaaS -> 银盛生活缴费中台 | 用于避免代扣过程中，申请代扣扣费结果通知接口出现延迟或异常，导致物业SaaS未收到通知结果。物业SaaS可调用此查询接口，查询用户代扣扣费的具体状态 |
| 10 | 账单退款API | N | 物业缴费订单需调用此接口发起退款，退款成功的结果并非实时返回，可通过退款查询接口查询最终状态 | 物业缴费的订单，需调用此接口发起退款，最终退款成功的结果不是实时返回，可通过退款查询接口查询终态 |
| 11 | 账单退款查询API | N | 物业SaaS -> 银盛生活缴费中台 -> 银盛生活缴费中台 | 通过退款查询接口，查询物业缴费退款账单的最终状态 |
接口调用清单
图 1 接口调用时序图（实线为请求／调用，虚线为应答或异步回执；①～⑪ 对应「1、接口清单」中的接口序号）