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

⌘I