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

# 一站式平台赋能解决方案

# ISV 接入概览

本套文档面向 **ISV（独立软件开发商）** 客户，介绍如何通过 OristaPay Open API 完成终端客户（商户）的 onboarding 开户流程，并代商户进行日常交易操作。

## 接入流程

```mermaid theme={null}
sequenceDiagram
    participant ISV as ISV (A)
    participant RD as OristaPay
    participant Merchant as 商户 (B)

    ISV->>RD: 1. 提交商户开户申请 (Onboarding API)
    RD->>RD: 企业查册 + 合规审核
    RD-->>ISV: webhook 通知可发起 IDV
    ISV->>Merchant: 2. 转发 IDV/签署链接
    Merchant->>RD: 3. 完成 IDV + 签署
    RD-->>ISV: webhook 通知审核通过 + walletId
    ISV->>RD: 4. 代商户调用交易 API
```

## API 文档

ISV 接入涉及两套 API：

| 文档                                         | 用途                                         |
| ------------------------------------------ | ------------------------------------------ |
| [**认证与签名**](./auth)                        | OAuth2 令牌获取、HMAC 签名算法、请求头规范、响应信封、错误处理、限流策略 |
| [**ISV Onboarding API**](./onboarding-api) | 商户开户申请、IDV 链接、进度查询、企业资料查询、回调接收             |
| [**ISV 交易 API**](./transaction-api)        | 代商户完成内部划拨、收款订单申报、Payout、银行账户管理等            |

## 鉴权与签名

本套 API 通过 OAuth2 + HMAC 双重认证，ISV 客户完成 onboarding 后，代商户调用交易 API 时只需正常传入 `walletId`，OristaPay 会按 ISV ↔ 商户的归属关系自动完成鉴权。详见 [认证与签名](./auth)。

## 接口速览

### Onboarding API (6 个接口)

| # | Path                                         | 用途        |
| - | -------------------------------------------- | --------- |
| 1 | `POST /storage/media/dg-putObject`           | 文件上传      |
| 2 | `POST /api/v1/onboarding/application/submit` | 提交开户申请    |
| 3 | `POST /api/v1/onboarding/application/query`  | 查询申请进度    |
| 4 | `POST /api/v1/onboarding/idv/link`           | 获取 IDV 链接 |
| 5 | `POST /api/v1/onboarding/link/refresh`       | 刷新链接过期时间  |
| 6 | `POST /api/v1/onboarding/profile`            | 查询完整企业资料  |

### 交易 API (15 个接口)

| 分类               | 接口                           | 用途                   |
| ---------------- | ---------------------------- | -------------------- |
| WalletPayment    | `internalTransfer`           | 内部划拨                 |
| WalletPayment    | `walletOrderDetail`          | 订单详情                 |
| WalletPayment    | `payinOrderDeclare`          | Request Payment 订单申报 |
| WalletPayment    | `addRequestPaymentMaterials` | 订单材料补充               |
| WalletPayment    | `queryReconBill`             | 对账单下载                |
| Convert > Payout | `payoutQuote`                | Payout 询价            |
| Convert > Payout | `payoutBook`                 | Payout 下单            |
| Convert > Payout | `payoutEnquiry`              | Payout 订单查询          |
| Convert > Payout | `payoutReSettle`             | Payout 重新结算          |
| Convert > Payout | `addBankAccount`             | 添加收款银行账户             |
| Convert > Payout | `updateBankAccount`          | 更新收款银行账户             |
| Convert > Payout | `delBankAccount`             | 删除收款银行账户             |
| Convert > Payout | `getBankAccount`             | 查询收款银行账户             |
| Callback         | 订单结果通知                       | 订单状态变更回调             |
| Callback         | 添加收款账号结果通知                   | 银行账户添加结果回调           |