> ## Documentation Index
> Fetch the complete documentation index at: https://doc.haipay.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 支付接口接入步骤

> 按实施顺序了解 Direct API 的接入步骤，包括支付方式展示、参数对接、回调处理与安全要求。

如果您要对接 HaiPay Direct API，核心链路包括发起下单、获取支付结果、接收异步通知，以及按接口说明完成参数和签名处理。

商户希望在自己的收银台上给用户展示支付方式并支付，HaiPay提供纯API（Direct API）的方式接入。

对于Direct API的接口，商户如果自行处理卡号信息，需要具备PCI-DSS认证资质。

## 1. 代收流程

```mermaid theme={null}
sequenceDiagram
    participant C as 商户客户端
    participant M as 商户服务端
    participant H as HaiPay服务端
    participant B as 钱包/银行

    C->>C: 1. 用户选择下单，进入 checkout 页，填写支付信息
    C->>M: 2.1 发起支付请求
    M->>H: 2.2 发送请求到HaiPay
    H->>B: 2.3 处理请求结果
    B-->>H: 2.4 返回请求结果
    H-->>M: 2.5 返回请求结果
    M-->>C: 2.6 返回请求结果

    B-->>H: 3.1 异步通知支付结果
    H-->>M: 3.2 异步通知支付结果
    M->>M: 3.3 通知获取成功
    H->>H: 3.4 通知获取成功
```

## 2. 代付流程

```mermaid theme={null}
sequenceDiagram
    participant M as 商户服务端
    participant H as HaiPay服务端
    participant B as 钱包/银行

    M->>H: 1.1 发起代付请求
    H->>B: 1.2 处理请求结果
    B-->>H: 1.3 返回请求结果
    H-->>M: 1.4 返回请求结果

    B-->>H: 2.1 异步通知支付结果
    H-->>M: 2.2 异步通知支付结果
    M->>M: 2.3 通知获取成功
    H->>H: 2.4 通知获取成功
```

## 3. 接口参数

详情参阅：[接口说明](https://doc.haipay.net/zh/history/V20260801/get-started/api-conventions.md)

## 4. 端到端测试

详情参阅：[端到端测试](https://doc.haipay.net/zh/history/V20260801/testing/end-to-end.md)

## 相关主题

* [HaiPay 接入流程指南](https://doc.haipay.net/zh/history/V20260801/get-started/integration-process.md)
* [HaiPay 配置与签名指南](https://doc.haipay.net/zh/history/V20260801/get-started/configuration-and-signatures.md)
* [HaiPay 接口说明与公共规则](https://doc.haipay.net/zh/history/V20260801/get-started/api-conventions.md)
* [处理异步通知并验证签名](https://doc.haipay.net/zh/history/V20260801/operations/callback.md)
* [核对上线检查清单（IP 白名单与生产配置）](https://doc.haipay.net/zh/history/V20260801/testing/go-live-checklist.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.