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

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

## 鉴权与签名

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

## 接口速览

### 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 | 添加收款账号结果通知 | 银行账户添加结果回调 |


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