> ## 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.

# HaiPay 集成步骤指南

> 按实施顺序了解 HaiPay 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 调用商户API接口
    H->>B: 2.3 调用上游渠道API接口
    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 调用上游渠道API接口
    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. 接口参数

详情参阅：[接口说明](/docs/zh/guide/api_description_guide)

## 4. 端到端测试

详情参阅：[端到端测试](/docs/zh/guide/end_to_end_testing)

## 相关主题

* [HaiPay 接入流程指南](/docs/zh/guide/integration_process_guide)
* [HaiPay 配置与签名指南](/docs/zh/guide/config_settings_and_signature_rules_guide)
* [HaiPay 接口说明与公共规则](/docs/zh/guide/api_description_guide)