# 账单支付

## 1. 业务介绍

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

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

## 2. 业务流程

```mermaid
%%{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的账单支付为例，用户端的支付流程如下：

![](https://img-cdn-sg.payermax.com/public/20250124-33dbeaa8-2f6e-4556-ae56-ad1cfb27f6ce.jpg)

## 4. API集成

| 接口名称         | 接口地址                                                                                                                                                                      | 描述                                                                   |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| 账单支付校验接口 | [/billPaymentValidationUrl](https://docs.payermax.com/api.html?docName=New%20Version&docVer=v1.0&docLang=cn#/paths/billPaymentValidationUrl/post)                             | PayerMax调用该接口请求商户获取本次支付操作的可行性（是否能够支付）     |
| 支付成功通知商户 | [/collectResultNotifyUrlForBillPayment](https://docs.payermax.com/api.html?docName=New%20Version&docVer=v1.0&docLang=cn#/paths/collectResultNotifyUrlForBillPayment/post)     | 对客扣款成功后，PayerMax将调用该接口通知商户入账结果，商户无需响应data |
| 商户入账结果确认 | [/aggregate-pay/api/gateway/orderConfirm](https://docs.payermax.com/api.html?docName=New%20Version&docVer=v1.0&docLang=cn#/paths/aggregate-pay-api-gateway-orderConfirm/post) | 商户收到支付通知且进行内部入账处理后，返回给PayerMax最终的入账结果     |

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