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, request signing, 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 require OAuth2 and a request signature. Use signature protocol v2 (Ed25519) for new integrations. After completing onboarding, ISVs can call transaction APIs on behalf of merchants by simply passing walletId. 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

Getting started

Digital Wallet

ISV Enablement Solution

Other Resources

ISV Enablement Solution Overview

ISV Integration Overview

Integration Flow

API Documentation

Authentication & Signing

API Quick Reference

Onboarding API (6 endpoints)

Transaction API (15 endpoints)

​ISV Integration Overview

​Integration Flow

​API Documentation

​Authentication & Signing

​API Quick Reference

​Onboarding API (6 endpoints)

​Transaction API (15 endpoints)

ISV Integration Overview

Integration Flow

API Documentation

Authentication & Signing

API Quick Reference

Onboarding API (6 endpoints)

Transaction API (15 endpoints)