ISV Integration Overview
This documentation is for ISV (Independent Software Vendor) customers, explaining how to use OristaPay Open APIs to complete onboarding for end customer (merchants) and conduct daily transaction operations on their behalf.Integration Flow
API Documentation
| Document | Description |
|---|---|
| Authentication & Signing | OAuth2 token acquisition, HMAC signature algorithm, request headers, response envelope, error handling, rate limiting |
| ISV Onboarding API | Merchant onboarding application, IDV link, progress inquiry, company profile query, callback handling |
| ISV Transaction API | Internal transfers, payment order declaration, Payout, bank account management on behalf of merchants |
Authentication & Signing
All APIs use OAuth2 + HMAC dual authentication. After completing onboarding, ISVs can call transaction APIs on behalf of merchants by simply passingwalletId. OristaPay automatically enforces authorization based on the ISV ↔ merchant relationship. See Authentication & Signing for details.
API Quick Reference
Onboarding API (6 endpoints)
| # | Path | Purpose |
|---|---|---|
| 1 | POST /storage/media/dg-putObject | File upload |
| 2 | POST /api/v1/onboarding/application/submit | Submit onboarding application |
| 3 | POST /api/v1/onboarding/application/query | Query application progress |
| 4 | POST /api/v1/onboarding/idv/link | Get IDV link |
| 5 | POST /api/v1/onboarding/link/refresh | Refresh link expiration |
| 6 | POST /api/v1/onboarding/profile | Query full company profile |
Transaction API (15 endpoints)
| Category | API | Purpose |
|---|---|---|
| WalletPayment | internalTransfer | Internal transfer |
| WalletPayment | walletOrderDetail | Order details |
| WalletPayment | payinOrderDeclare | Request Payment order declaration |
| WalletPayment | addRequestPaymentMaterials | Order material supplement |
| WalletPayment | queryReconBill | Download statement |
| Convert > Payout | payoutQuote | Payout quote |
| Convert > Payout | payoutBook | Payout order |
| Convert > Payout | payoutEnquiry | Payout order enquiry |
| Convert > Payout | payoutReSettle | Payout re-settle |
| Convert > Payout | addBankAccount | Add beneficiary bank account |
| Convert > Payout | updateBankAccount | Update beneficiary bank account |
| Convert > Payout | delBankAccount | Delete beneficiary bank account |
| Convert > Payout | getBankAccount | Enquiry beneficiary bank account |
| Callback | Order result notification | Order status change callback |
| Callback | Add bank account result | Bank account add result callback |