ISV 接入概览
本套文档面向 ISV（独立软件开发商） 客户，介绍如何通过 OristaPay Open API 完成终端客户（商户）的 onboarding 开户流程，并代商户进行日常交易操作。接入流程
API 文档
ISV 接入涉及两套 API：| 文档 | 用途 |
|---|---|
| 认证与签名 | OAuth2 令牌获取、HMAC 签名算法、请求头规范、响应信封、错误处理、限流策略 |
| ISV Onboarding API | 商户开户申请、IDV 链接、进度查询、企业资料查询、回调接收 |
| ISV 交易 API | 代商户完成内部划拨、收款订单申报、Payout、银行账户管理等 |
鉴权与签名
本套 API 通过 OAuth2 + HMAC 双重认证，ISV 客户完成 onboarding 后，代商户调用交易 API 时只需正常传入walletId，OristaPay 会按 ISV ↔ 商户的归属关系自动完成鉴权。详见 认证与签名。
接口速览
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 | 添加收款账号结果通知 | 银行账户添加结果回调 |