账单支付

1. 业务介绍

账单支付是在部分国家很流行的一种支付形式，通常应用于用户缴纳水电费、学费，还贷等场景。账单支付一般覆盖多种支付方式或资产，包括信用卡、借记卡、电子钱包、银行转账、线下便利店等。

通常情况下，用户在使用账单支付时，可以在各个APP或资产设备中输入交易单号或还款合约、还款金额进行主动还款，PayerMax在确认入账后返回对应商户交易状态并通知。

2. 业务流程

%%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#e6f0ff',
    'primaryTextColor': '#333',
    'primaryBorderColor': '#5b9bd5',
    'lineColor': '#888',
    'actorMargin': 40,
    'noteBkgColor': '#0056b3',
    'noteTextColor': '#ffffff',
    'noteBorderColor': '#004a99'
  }
}}%%
sequenceDiagram
    participant User as 用户端
    participant PM as PayerMax
    participant Merchant as 商户端

    %% 1. 输入与校验阶段
    User->>User: 1. 用户输入还款金额、还
款合同号、手机、邮箱
    User->>PM: 2.1 还款校验查询
    PM->>Merchant: 2.2 还款校验查询
    Merchant-->>PM: 2.3 结果响应
    PM-->>User: 2.4 结果响应

    %% 2. 成功通知阶段
    User->>PM: 2.5 支付成功通知
    PM->>PM: 3.1 交易落库
    PM->>Merchant: 3.2 支付成功通知
    Merchant-->>PM: 3.3 商户入账通知

3. 用户体验

以菲律宾GCASH的账单支付为例，用户端的支付流程如下：

4. API集成

接口名称	接口地址	描述
账单支付校验接口	/billPaymentValidationUrl	PayerMax调用该接口请求商户获取本次支付操作的可行性（是否能够支付）
支付成功通知商户	/collectResultNotifyUrlForBillPayment	对客扣款成功后，PayerMax将调用该接口通知商户入账结果，商户无需响应data
商户入账结果确认	/aggregate-pay/api/gateway/orderConfirm	商户收到支付通知且进行内部入账处理后，返回给PayerMax最终的入账结果

注意：

PayerMax提供商户入账结果的同步返回和异步回调。若商户在【支付成功通知】接口中同步返回入账结果，则商户无需对接【入账结果通知】接口；若商户在【支付成功通知】接口中不返回入账结果，则商户对接【入账结果通知】接口返回入账结果；若商户对接了两个接口且都分别返回入账结果，则PayerMax只处理第一次的入账结果。