# Introduction
Source: https://docs.oristapay.com/en/acquiring/index
Introduction to the RD Group-OristaPay-Acquiring System.
## Acquiring Core Management System
* **Product Orders:** Product information, on-chain payment information, and payer information are matched among the three parties to determine the financial ownership of the order.
* **Information Storage:** Based on browser or app device fingerprints, the unique payment identity of repeat payers is determined for long-term tracking.
* **Financial Reconciliation:** Achieved by integrating via system APIs with the integrated party's own order management system, financial management system, and member management system.
* **Intelligent Risk Control:** Utilizes an embedded security SDK to accurately identify risks related to transaction environments, device fingerprints, and wallet address associations.
* **On-Chain Penetration:** Integrates world-leading KYA/KYT technology for deep behavioral analysis and asset tracing, effectively blocking high-risk transactions.
* **Global Governance:** Directly connects to major global regulatory risk databases, automatically screening high-risk customers and transactions against sanctions lists.
* **Dynamic Wallet:** Generates a clean receiving wallet address for each order to prevent the main wallet from being contaminated by blacklisted addresses.
* **Fast Aggregation:** Real-time on-chain monitoring of payer activities, enabling monitoring from the generation of the first memory block and providing rapid payment result confirmation capabilities.
* **Ultra-Low Gas:** Utilizes intelligent algorithms to schedule and aggregate funds across multiple chains, solving the problem of high gas fees for aggregating small amounts of funds, achieving advance-level aggregation speed.
* **Fiat Currency Linkage:** The access party can choose to manage fiat currency accounts, and the system will manage multiple fiat currency accounts through bank-level accounts.
* **Digital Currency Transfer:** The access party can choose to receive stable digital currency withdrawals to their own external wallets, supporting most blockchains and stablecoins.
* **Linked Exchange:** The access party can manage the linkage between digital currencies and fiat currencies, holding multiple cryptocurrencies and multiple fiat currencies within the system simultaneously.
## Contact us
Need more support and communication? [Click here](mailto:itsupport@rd.group) to contact us by email.
# API Doc
Source: https://docs.oristapay.com/en/acquiring/quickstart
# 2026/05/08
| Release Date | Description of Product | Version |
| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------ |
| 2026/03/17 | Version V1.0 has been released, supporting automatic aggregation, displaying payment addresses via QR codes, and automated strategies for dynamic payment addresses. | V1.0.0 |
| 2026/05/08 | Version V1.1 has been released, adding payout/settlement functionality for merchant fund settlement to RD Convert wallet. | V1.1.0 |
# Integration process
### Environment Setup
1. **Activate Merchant Account and Obtain API Keys**
1. Complete merchant account setup and configuration in the operations/management backend.
2. Generate the following authentication information in the backend:
1. `AppId`: Merchant Application ID
2. `AppSecret`: Merchant Application Secret (Server-side only, must not be disclosed)
3. `ApiKey`: Used for basic authentication and access control
3. Configure IP whitelist (Recommended to only allow merchant server egress IP).
2. **Select Environment and Complete Connectivity Test**
1. Use the development environment for integration testing and verification.
2. After successful testing, switch to the production environment.
3. **Integrate Core APIs**
1. Order Management: Create Order, Query Order, Query Reconciliation Statement.
2. Refund Management: Create Refund, Query Refund.
3. Payout Management: Create Payout, Query Payout.
4. **Integrate Callback Notifications (Webhook)**
1. Configure Order/Refund/Payout Status Notification URL in the merchant backend.
2. Implement the notification processing interface, supporting:
1. Verify Signature (Required)
2. Idempotent Processing (Required)
3. Retry Reception
5. **Integration Testing and Go-Live**
1. Perform integration testing according to business scenarios (e.g., placing an order, successful payment, timeout cancellation, successful/failed refund).
2. After small-scale verification in the production environment, gradually increase traffic.
### **Basic Environment**
* **Base URL**
* Development environment: [https://gw.uat.rdezlink.tech](https://gw.uat.rdezlink.tech)
* Production environment: [https://gw.rd.group](https://gw.rd.group)
* **Protocol and format**
* Protocol: HTTPS
* Data format: JSON
* Character encoding: UTF-8
* API version: v1 (reflected in the URL as `/api/v1/...`)
* **Standard for amount fields (important)**
* All fields related to amounts, fees, balances, etc. must be transmitted as strings in JSON to avoid precision loss.
* For example: `"amount": "100.00"`
* Do not use `"amount": 100.00`
### Authentication Security
Authentication Method and Signature Mechanism (Mandatory):
All API requests must be made via HTTPS and include the following fields in the header for authentication and tamper-proof verification:
Request Header Fields:
| Field Name | Type | Required | Description |
| :------------ | :----- | :------- | :------------------------------------------------------------------- |
| `X-Api-Key` | String | yes | Merchant API Key (Platform Assignment) |
| `X-App-Id` | String | yes | Merchant Application Identifier |
| `X-Timestamp` | String | yes | Timestamp (milliseconds, 13 digits), used to prevent replay attacks. |
| `X-Nonce` | String | yes | Random string, recommended length ≥ 16 |
| `X-Signature` | String | yes | Request Signature (HMAC-SHA256) |
**Signature algorithm description (recommended implementation):**
1. Concatenate the following items in order into a string `signPayload`:
1. HTTP method (uppercase, e.g., `POST`)
2. Request path (without domain, e.g., `/api/v1/order/create`)
3. `X-App-Id`
4. `X-Timestamp`
5. `X-Nonce`
6. Request body raw JSON string (remove extra spaces, keep it exactly as actually sent)
2. Use `AppSecret `as the key to perform HMAC-SHA256 on `signPayload`; output the result as hexadecimal or Base64, which becomes `X-Signature`.
3. The platform server will verify the signature using the same rules:
Verify `X-Timestamp` is within the allowed time window (for example ±5 minutes).
Verify `X-Nonce` has not been reused (platform stores nonces for deduplication to prevent replay attacks).
Verify `X-Signature` is correct.
**Example pseudocode (for illustration only):**
```javascript theme={null}
// Header
X-Api-Key: your-api-key
X-App-Id: your-app-id
X-Timestamp: "1710576000"
X-Nonce: "random-string-123456"
X-Signature: "计算后的签名字符串"
```
The platform provides signature examples or SDKs for languages such as Java/Go/Node/PHP.
### IP Whitelist
Supports IP whitelist configuration in the following formats (set in the merchant management backend):
* Single IP: `192.168.1.100`
* Multiple IPs: `192.168.1.100,192.168.1.110,192.168.1.120`
**Security Recommendations:**
* Only allow access from the merchant server's egress IP to prevent exposing the API Key to the frontend or uncontrolled environments.
* Avoid directly calling interfaces in environments such as browsers and mobile devices.
**General Response Format:**
All interfaces return a unified response structure:
```json theme={null}
{
"code": "0000",
"msg": "success",
"data": {},
"traceId": "xxx"
}
```
* `code: `response code, 0000 indicates success, non-0000 indicates failure.
* `msg`: Response message with a brief error reason.
* `data`: The content of the business data.
* `traceId`: Request a trace ID for easy troubleshooting (please provide this when troubleshooting with the platform).
**Response Code Examples**
Below are the primary response codes discussed in this document. A complete list of error codes may be extended by the platform in the future.
| code | Description |
| :--- | :----------------------------------------------------------- |
| 0000 | Success |
| 1000 | The user does not exist |
| 1010 | Authentication failed |
| 1015 | The order does not exist |
| 1020 | Risk control refuses |
| 3001 | Invalid wallet address format |
| 3002 | This blockchain network is not supported at this time |
| 3003 | The balance is not enough to cover on-chain gas fees |
| 3004 | Create orders repeatedly |
| 3005 | The refund amount exceeds the refundable amount of the order |
| 3006 | The order has expired and cannot be paid |
## Order Management
### Create Order
Create a new billing order and generate a payment address and checkout URL.
* URL:`POST /api/v1/order/create`
* Content-Type:`application/json`
**Request parameters**
| Field Name | Type | Maximum Length | Required | Description |
| :-------------- | :------ | :------------- | :---------- | :----------------------------------------------------------------------------------------------------------- |
| `bizNo` | String | 128 | yes | Merchant business order number, used for idempotency control, unique within the same merchant. |
| `amount` | String | 64 | yes | Order amount, must be greater than 0, minimum "`0.01`". |
| `currency` | String | 8 | yes | Order currency, please use `USD `currently. |
| `expireSeconds` | Integer | 4 | no | Order expiration time (seconds). If not provided, the system default value will be used (e.g., 600 seconds). |
| `userInfo` | Object | - | Conditional | User information; required when the order amount is ≥ 1000 USD. |
| `productInfo` | Object | - | yes | Product information |
| `successUrl` | String | 256 | no | Front-end notification URL for order status (used when the front-end needs to be aware of status changes). |
| `failureUrl` | String | 256 | no | Front-end notification URL for order status (used when the front-end needs to be aware of status changes). |
`userInfo` Field Description:
| Field Name | Type | Maximum Length | Required | Description |
| :--------- | :----- | :------------- | :------- | :-------------------------------- |
| `clientId` | String | 64 | yes | Merchant-side user identification |
| `name` | String | 128 | yes | User name |
| `address` | String | 512 | yes | User address information |
| `certType` | String | 32 | no | Document type |
| `certNo` | String | 32 | no | ID number |
| `email` | String | 128 | no | User email |
| `phone` | String | 32 | no | User mobile phone number |
`productInfo` Field Description:
| Field Name | Type | Maximum Length | Required | Description |
| :------------ | :------ | :------------- | :------- | :------------------ |
| `productName` | String | 128 | yes | Product Name |
| `productLink` | String | 512 | no | product Link |
| `quantity` | Integer | 11 | no | Purchase Quantity |
| `description` | String | 1024 | yes | Product Description |
**Request Example**
```json theme={null}
{
"bizNo": "BIZ202401010001",
"amount": "100.00",
"currency": "USD",
"expireSeconds": 3600,
"userInfo": {
"clientId": "USER001",
"name": "zhangsan",
"address": "中国深圳南山xxxx",
"email": "user@example.com"
},
"productInfo": {
"productName": "Premium Membership",
"productLink": "https://example.com/product/123",
"quantity": 1,
"description": "1 month premium membership"
},
"successUrl": "https://merchant.example.com/callback/success",
"failureUrl": "https://merchant.example.com/callback/failure"
}
```
**Response Parameters**
| Field Name | Type | Maximum Length | Description |
| :--------------- | :----- | :------------- | :------------------------------------------------------------------------------------------------------ |
| `orderId` | String | 64 | System Order ID |
| `bizNo` | String | 128 | Merchant Business Order Number |
| `amount` | String | 64 | Order Amount (in string format) |
| `status` | String | 16 | Order Status, see "Order Status Description" |
| `expireTime` | Date | - | Expiration Time (in ISO8601 format) |
| `receiveAddress` | List | - | Receiving Address List (multiple records will be returned for multi-chain and multi-currency scenarios) |
| `cashierUrl` | String | 256 | Cashier URL (can be redirected to this page to complete payment) |
`receiveAddress` Field Description:
| Field Name | Type | Maximum Length | Description |
| :-------------- | :------------ | :------------- | :--------------------------------------------------- |
| `address` | String | 64 | Wallet Address |
| `chain` | String | 16 | Chain Type (e.g., `ETH `/ `TRX `/ `SOL `/ `POLYGON`) |
| `tokenCurrency` | List\ | - | Supported Token Currencies (e.g., \["`USDT`"]) |
> **Multi-chain Payment Instructions:**
>
> * The system supports returning multiple receiving addresses (for different chains/currencies).
> * It is recommended that the merchant's front end, when displaying at the checkout, guide users to select **only one chain** to complete the payment, avoiding splitting it into multiple transactions.
> * By default, the system accumulates the received amounts on an order basis. When the cumulative amount of multiple valid receipts under the same order reaches or exceeds the expected amount, the payment can be considered successful. For other strategies, please confirm with the platform.
**Response Example**
```json theme={null}
{
"code": "0000",
"msg": "success",
"data": {
"orderId": "O202401010001",
"bizNo": "BIZ202401010001",
"amount": "100.00",
"status": "PENDING",
"expireTime": "2024-01-01T12:00:00Z",
"receiveAddress": [
{
"address": "0x1234...5678",
"chain": "ETH",
"tokenCurrency": ["USDT","USDC"]
},
{
"address": "TK1234...5678",
"chain": "TRX",
"tokenCurrency": ["USDT","USDC"]
}
],
"cashierUrl": "https://cashier.example.com/pay?order=xxx"
},
"traceId": "trace123"
}
```
### Query Order
Query order details based on the system order ID.
* URL:`POST /api/v1/order/query`
* Content-Type:`application/json`
**Request Parameters**
| Field Name | Type | Maximum Length | Required | Description |
| :--------- | :----- | :------------- | :------- | :-------------- |
| `orderId` | String | 64 | yes | System Order ID |
**Request Example**
```json theme={null}
{
"orderId": "O202401010001"
}
```
**Response Parameters**
| Field Name | Type | Maximum Length | Description |
| :---------------- | :----- | :------------- | :------------------------------ |
| `orderId` | String | 64 | System Order ID |
| `bizNo` | String | 128 | Merchant Business Order Number |
| `orderAmount` | String | 64 | Order Amount (String) |
| `actualAmount` | String | 64 | Actual Received Amount (String) |
| `currency` | String | 8 | Order Currency |
| `chain` | String | 16 | Chain Type |
| `receiveCurrency` | String | 16 | Receiving Currency |
| `receiveAddress` | String | 64 | Receiving Address |
| `txHash` | String | 64 | Blockchain Transaction Hash |
| `status` | String | 16 | Order Status |
| `orderTime` | Date | - | Order Time |
| `finishTime` | Date | - | Completion Time |
**Order Status Description**
| Status | Description |
| :---------------- | :----------------- |
| `PENDING` | Pending Payment |
| `AMOUNT_MISMATCH` | Amount Mismatch |
| `PAY_SUCCESS` | Payment Successful |
| `PAY_FAIL` | Payment Failed |
| `TIMEOUT` | Timed Out |
| `COMPLETED` | Settled |
| `REFUNDED` | Refunded |
**Response Example**
```json theme={null}
{
"code": "0000",
"msg": "success",
"data": {
"orderId": "O202401010001",
"bizNo": "BIZ202401010001",
"orderAmount": "100.00",
"actualAmount": "100.00",
"currency": "USD",
"chain": "ETH",
"receiveCurrency": "USDT",
"receiveAddress": "0x1234...5678",
"txHash": "0xabc123...def456",
"status": "PAY_SUCCESS",
"orderTime": "2024-01-01T10:00:00Z",
"finishTime": "2024-01-01T10:30:00Z"
},
"traceId": "trace123"
}
```
### Query Statement
Query order reconciliation information by paging according to the order placement time range.
* URL:`POST /api/v1/order/queryRecon`
* Content-Type:`application/json`
**Request Parameters**
| Field Name | Type | Maximum Length | Required | Description |
| :---------- | :--- | :------------- | :------- | :--------------------------------------------------------------- |
| `startTime` | Date | - | yes | Query start time (inclusive), based on the order placement time. |
| `endTime` | Date | - | yes | Query end time (exclusive), based on order placement time. |
| `pageId` | Int | 11 | yes | Page number, starting from 1. |
| `pageSize` | Int | 11 | yes | Page size, maximum 1000 entries. |
**Request Example**
```json theme={null}
{
"startTime": "2024-01-01T10:00:00Z",
"endTime": "2024-01-03T10:30:00Z",
"pageId": 1,
"pageSize": 1000
}
```
**Response Parameters**
| Field Name | Type | Maximum Length | Description |
| :---------- | :-------------- | :------------- | :--------------------- |
| `total` | Int | 11 | Total number of orders |
| `orderList` | List\\\ | - | Statement List |
**Statement detail fields**
| Field Name | Type | Maximum Length | Description |
| :---------------- | :----- | :------------- | :----------------------------- |
| `orderId` | String | 64 | System Order ID |
| `bizNo` | String | 128 | Merchant Business Order Number |
| `orderAmount` | String | 64 | Order Amount |
| `actualAmount` | String | 64 | Actual Received Amount |
| `currency` | String | 8 | Order Currency |
| `chain` | String | 16 | Chain Type |
| `receiveCurrency` | String | 16 | Receiving Currency |
| `receiveAddress` | String | 64 | Receiving Address |
| `txHash` | String | 64 | Blockchain Transaction Hash |
| `status` | String | 16 | Order Status |
| `orderTime` | Date | - | Order Placement Time |
| `finishTime` | Date | - | Payment Completion Time |
| `settleTime` | Date | - | Settlement Time |
| `settleAmount` | String | 64 | Settlement Amount |
| `feeList` | List | - | Fee Details List |
**Fee Details Fields**
| Field Name | Type | Maximum Length | Description |
| :------------ | :----- | :------------- | :---------------------- |
| `feeAmount` | String | 64 | Fee Amount |
| `feeCurrency` | String | 16 | Fee Currency |
| `feeType` | String | 16 | Fee Type: WITHDRAW\_FEE |
**Response Example**
```json theme={null}
{
"code": "0000",
"msg": "success",
"data": {
"total": 100,
"orderList": [
{
"orderId": "O202401010001",
"bizNo": "BIZ202401010001",
"userId": "U001",
"orderAmount": "100.00",
"actualAmount": "100.00",
"currency": "USD",
"chain": "ETH",
"receiveCurrency": "USDT",
"receiveAddress": "0x1234...5678",
"txHash": "0xabc123...def456",
"status": "PAY_SUCCESS",
"orderTime": "2024-01-01T10:00:00Z",
"finishTime": "2024-01-01T10:30:00Z",
"settleTime": "2024-01-02T10:30:00Z",
"settleAmount": "90.00",
"feeList": [
{
"feeAmount": "10.00",
"feeCurrency": "USDT",
"feeType": "WITHDRAW_FEE"
}
]
}
]
},
"traceId": "trace123"
}
```
## Refund Management
### Create Refund
Create a refund request for a specified order, only supporting full refunds now (partial refunds will be supported later. Actual capabilities are subject to platform configuration).
To prevent fund theft, refunds will be returned to the` original payment method`.
* URL:`POST /api/v1/refund/create`
* Content-Type:`application/json`
**Request Parameters**
| Field Name | Type | Maximum Length | Required | Description |
| :--------- | :----- | :------------- | :------- | :---------------- |
| `orderId` | String | 64 | yes | Original Order ID |
| `reason` | String | 512 | yes | Refund Reason |
**Request Example**
```json theme={null}
{
"orderId": "O202401010001",
"reason": "User requests a refund"
}
```
**Response Parameters**
| Field Name | Type | Maximum Length | Description |
| :------------- | :----- | :------------- | :----------------------- |
| `refundId` | String | 64 | Refund ID |
| `orderId` | String | 64 | Original Order ID |
| `refundAmount` | String | 64 | Refund Amount |
| `feeAmount` | String | 64 | Refund Fee Amount |
| `currency` | String | 8 | Currency Type |
| `status` | String | 16 | Refund Status, find more |
**Response Example**
```json theme={null}
{
"code": "0000",
"msg": "success",
"data": {
"refundId": "R202401010001",
"orderId": "O202401010001",
"refundAmount": "100.00",
"feeAmount": "10.00",
"currency": "USDT",
"status": "PROCESSING"
},
"traceId": "trace123"
}
```
### Query Refund
Query refund information by Refund ID or Order ID.
* URL:`POST /api/v1/refund/query`
* Content-Type:`application/json`
**Request Parameters**
Choose one of the two parameters: Either `refundId `or `orderId `must be provided, and only one can be provided.
| Field Name | Type | Maximum Length | Required | Description |
| :--------- | :----- | :------------- | :------- | :--------------------------------------------------- |
| `refundId` | String | 64 | no\\\* | Refund ID (choose either this or `orderId`) |
| `orderId` | String | 64 | no\\\* | Original order ID (choose either this or `refundId`) |
**Request Example**
```json theme={null}
{
"refundId": "R202401010001"
}
```
**Response Parameters**
| Field Name | Type | Maximum Length | Description |
| :------------- | :----- | :------------- | :-------------------------- |
| `refundId` | String | 64 | Refund ID |
| `orderId` | String | 64 | Original Order ID |
| `refundAmount` | String | 64 | Refund Amount |
| `feeAmount` | String | 64 | Refund Fee Amount |
| `currency` | String | 8 | Currency |
| `chain` | String | 16 | Chain Type |
| `toAddress` | String | 64 | Refund Target Address |
| `txHash` | String | 64 | Blockchain Transaction Hash |
| `status` | String | 16 | Refund Status |
| `reason` | String | 512 | Refund Reason |
**Refund Status Description**
| Status | Description |
| :----------- | :---------- |
| `PROCESSING` | Processing |
| `SUCCESS` | Success |
| `FAILED` | Failed |
**Response Example**
```json theme={null}
{
"code": "0000",
"msg": "success",
"data": {
"refundId": "R202401010001",
"orderId": "O202401010001",
"refundAmount": "100.00",
"feeAmount": "10.00",
"currency": "USDT",
"chain": "ETH",
"toAddress": "0x9876...5432",
"txHash": "0xdef456...abc123",
"status": "SUCCESS",
"reason": "用户申请退款"
},
"traceId": "trace123"
}
```
## Payout Management
### Create Payout
Initiate a merchant fund settlement to the RD Convert wallet.
* URL:`POST /api/v1/payout/create`
* Content-Type:`application/json`
**Request Parameters**
| Field Name | Type | Maximum Length | Required | Description |
| :---------------- | :----- | :------------- | :------- | :--------------------------------------------------------------------------------------------- |
| `merchantOrderNo` | String | 128 | yes | Merchant business order number, used for idempotency control, unique within the same merchant. |
| `chain` | String | 16 | yes | Chain type (e.g., `ETH` / `TRX` / `SOL` / `POLYGON`). |
| `currency` | String | 8 | yes | Payout currency (e.g., `USDT`). |
| `amount` | String | 64 | yes | Payout amount, must be greater than the minimum (default `10`). |
**Request Example**
```json theme={null}
{
"merchantOrderNo": "PO202401010001",
"chain": "ETH",
"currency": "USDT",
"amount": "1000.00"
}
```
**Response Parameters**
| Field Name | Type | Maximum Length | Description |
| :---------------- | :----- | :------------- | :--------------------------------------------- |
| `payoutId` | String | 64 | System Payout ID |
| `merchantOrderNo` | String | 128 | Merchant Business Order Number |
| `amount` | String | 64 | Payout Amount (in string format) |
| `currency` | String | 8 | Payout Currency |
| `chain` | String | 16 | Chain Type |
| `status` | String | 16 | Payout Status, see "Payout Status Description" |
**Response Example**
```json theme={null}
{
"code": "0000",
"msg": "success",
"data": {
"payoutId": "PO202401010001",
"merchantOrderNo": "PO202401010001",
"amount": "1000.00",
"currency": "USDT",
"chain": "ETH",
"status": "INIT"
},
"traceId": "trace123"
}
```
### Query Payout
Query payout information by Payout ID or merchant business order number.
* URL:`POST /api/v1/payout/query`
* Content-Type:`application/json`
**Request Parameters**
Choose one of the two parameters: Either `payoutId` or `merchantOrderNo` must be provided.
| Field Name | Type | Maximum Length | Required | Description |
| :---------------- | :----- | :------------- | :------- | :---------------------------------------------------------------- |
| `payoutId` | String | 64 | no\* | Payout ID (choose either this or `merchantOrderNo`) |
| `merchantOrderNo` | String | 128 | no\* | Merchant business order number (choose either this or `payoutId`) |
**Request Example**
```json theme={null}
{
"payoutId": "PO202401010001"
}
```
**Response Parameters**
| Field Name | Type | Maximum Length | Description |
| :---------------- | :----- | :------------- | :------------------------------- |
| `payoutId` | String | 64 | System Payout ID |
| `merchantOrderNo` | String | 128 | Merchant Business Order Number |
| `amount` | String | 64 | Payout Amount (in string format) |
| `currency` | String | 8 | Payout Currency |
| `chain` | String | 16 | Chain Type |
| `toAddress` | String | 64 | Payout Destination Address |
| `txHash` | String | 64 | Blockchain Transaction Hash |
| `convertOrderNo` | String | 64 | RD Convert Order Number |
| `status` | String | 16 | Payout Status |
**Payout Status Description**
| Status | Description |
| :----------- | :---------- |
| `INIT` | Initialized |
| `PROCESSING` | Processing |
| `SUCCESS` | Success |
| `FAILED` | Failed |
**Response Example**
```json theme={null}
{
"code": "0000",
"msg": "success",
"data": {
"payoutId": "PO202401010001",
"merchantOrderNo": "PO202401010001",
"amount": "1000.00",
"currency": "USDT",
"chain": "ETH",
"toAddress": "0x9876...5432",
"txHash": "0xdef456...abc123",
"convertOrderNo": "CO202401010001",
"status": "SUCCESS"
},
"traceId": "trace123"
}
```
## Status Notification (Webhook, with Signature)
**Overview**
When the order, refund, or payout status changes, the system sends a status notification to the notification URL configured by the merchant through an HTTPS POST request, and the signature generation and basic legitimacy verification of the callback request are handled by the gateway.
Merchants need to configure the URL for receiving notifications in the management backend, only support the HTTPS protocol, and implement processing logic on the server side.
All notification requests will carry a signature header and merchants must complete signature verification before proceeding with the transaction.
**Notification Request Headers**
Similar to business requests, callback notifications will also carry the following Headers:
| Field Name | Type | Required | Description |
| :------------ | :----- | :------- | :---------------------------------------- |
| `X-Api-Key` | String | yes | Merchant API Key (Platform Assignment) |
| `X-App-Id` | String | yes | Merchant Application Identifier |
| `X-Timestamp` | String | yes | Timestamp, used to prevent replay attacks |
| `X-Nonce` | String | yes | Random string |
| `X-Signature` | String | yes | Callback signature (HMAC-SHA256) |
The signature for callback requests is uniformly generated by the gateway. The signature algorithm is identical to the business request signature algorithm described in Section 3.1. The fixed concatenation rule for the signature payload is as follows:
POST + full callback URL path + X-App-Id + X-Timestamp + X-Nonce + original JSON string of the callback body
The signature algorithm is the same as in Section 3.1, and the body contains the JSON content of the notification. The merchant side must use its own stored AppSecret to verify the signature of the notification and reject requests that fail verification, returning a 401 status code.
> Note: The difference here is that the full callback URL path is used, i.e., the complete URL for **receiving notifications**.
**Trigger Scenarios**
| Trigger Scenario | Description |
| :----------------------- | :-------------------------------------------------------------------------------------- |
| Order Payment Successful | User completes payment, order status changes to `PAY_SUCCESS` |
| Order Payment Failed | Order is actively canceled, status changes to `PAY_FAILED` |
| Order Expired | Order not paid within timeout period, system automatically cancels, status is `TIMEOUT` |
| Refund Successful | Refund processing completed, status changes to `SUCCESS` |
| Refund Failed | Refund processing failed, status changes to `FAILED` |
| Payout Successful | Payout processing completed, status changes to `SUCCESS` |
| Payout Failed | Payout processing failed, status changes to `FAILED` |
### Order Status Notification
* Request Method:
* URL: Notification URL configured by the merchant
* Method: `POST`
* Content-Type:`application/json`
**Request Parameters (Order Notification)**
| Field Name | Type | Maximum Length | Description |
| :---------------- | :----- | :------------- | :------------------------------------------- |
| `orderId` | String | 64 | System Order ID |
| `bizNo` | String | 128 | Merchant Business Order Number |
| `orderAmount` | String | 64 | Order Amount |
| `actualAmount` | String | 64 | Actual Received Amount |
| `currency` | String | 8 | Currency Type |
| `receiveCurrency` | String | 16 | Currency Received on the Chain |
| `receiveAddress` | String | 64 | Address Where Money is Received on the Chain |
| `chain` | String | 16 | Chain Type |
| `status` | String | 16 | Order Status (Consistent with other) |
| `blockHeight` | Long | - | Block Height for On-Chain Verification |
**Request Example**
```json theme={null}
{
"orderId": "O202401010001",
"bizNo": "BIZ202401010001",
"orderAmount": "100.00",
"actualAmount": "100.00",
"currency": "USD",
"receiveCurrency": "USDT",
"receiveAddress": "0x123...xyz",
"chain": "ETH",
"status": "PAY_SUCCESS",
"blockHeight": 19384738
}
```
### Refund Status Notification
Request Parameters (Refund Notification):
| Field Name | Type | Maximum Length | Description |
| :------------- | :----- | :------------- | :-------------------------------------------- |
| `refundId` | String | 64 | Refund ID |
| `orderId` | String | 64 | Original Order ID |
| `refundAmount` | String | 64 | Refund Amount |
| `currency` | String | 16 | Currency |
| `txHash` | String | 64 | Blockchain Transaction Hash (using camelCase) |
| `status` | String | 16 | Refund Status (consistent with other) |
| `blockHeight` | Long | - | Block Height |
**Request Example**
```json theme={null}
{
"refundId": "R202401010001",
"orderId": "O202401010001",
"refundAmount": "100.00",
"currency": "USDT",
"txHash": "0xabc123...def456",
"status": "SUCCESS",
"blockHeight": 19384800
}
```
### Payout Status Notification
Request Parameters (Payout Notification):
| Field Name | Type | Maximum Length | Description |
| :---------------- | :----- | :------------- | :------------------------------------ |
| `payoutId` | String | 64 | System Payout ID |
| `merchantOrderNo` | String | 128 | Merchant Business Order Number |
| `amount` | String | 64 | Payout Amount |
| `currency` | String | 8 | Payout Currency |
| `chain` | String | 16 | Chain Type |
| `txHash` | String | 64 | Blockchain Transaction Hash |
| `status` | String | 16 | Payout Status (consistent with other) |
**Request Example**
```json theme={null}
{
"payoutId": "PO202401010001",
"merchantOrderNo": "PO202401010001",
"amount": "1000.00",
"currency": "USDT",
"chain": "ETH",
"txHash": "0xdef456...abc123",
"status": "SUCCESS"
}
```
**Merchant Response Requirements and Retry Mechanism**
* The merchant service must return an HTTP `200 `status code to indicate successful receipt and processing of the notification.
* A non-`200 `status code or timeout will be considered a failure, and the system will retry a certain number of times (the specific strategy is subject to the platform's actual configuration).
* It is recommended to return a unified response format:
```json theme={null}
{
"code": "SUCCESS"
}
```
> **Important Requirements:**
>
> * The notification processing logic on the merchant side must implement idempotency (for example, deduplication through `orderId`/`refundId `+ status) to avoid duplicate processing of business operations caused by repeated notifications.
> * Before business processing, signature verification and parameter verification must be performed first, and all requests that fail verification should be rejected.
## Best Practice Recommendations
1. **Idempotency Control**
1. Use `bizNo` to ensure idempotency for order creation: Requests with the same `bizNo `will return the same order information.
2. It is recommended to use UUID or a business-unique identifier as `bizNo`.
2. **Order Status Polling**
1. The "Query Order" interface can be polled from the frontend or merchant system based on business needs. Set reasonable polling intervals and maximum polling durations to avoid overly frequent requests.
3. **Callback Notification Handling**
1. Upon receiving order/refund status notifications, first perform signature verification and parameter validation before proceeding with business processing.
2. Implement idempotent logic to ensure that multiple notifications do not result in duplicate deductions or duplicate shipments.
4. **Error Handling and Troubleshooting**
1. Determine request success based on the `code `field. In case of failure, troubleshoot using `msg `prompts and business logs.
2. When troubleshooting with the platform, provide the corresponding `traceId`, request time range, and key business information (e.g., `orderId`/`bizNo`).
5. Security Recommendations
1. `ApiKey`/`AppSecret `should only be used on the server side and not exposed in frontend, mobile, or browser environments.
2. Configure IP whitelists to restrict access to trusted servers only.
3. Use HTTPS throughout to avoid plaintext transmission.
4. Regularly rotate keys and promptly update them in server configurations.
## Frequently Asked Questions (FAQ) Examples
**Q: What should I do if I receive a** `1010 authentication failure` **message when creating an order?**
Please check:
* Whether the request carries the correct `X-Api-Key` and `X-App-Id` in the Header;
* Whether `X-Timestamp` is within the allowed time window (not expired);
* Whether `X-Nonce` is different for each request;
* Whether the signature `X-Signature` is generated according to the documentation requirements;
* Whether the API Key has been enabled in the backend and is not expired;
* Whether the current request IP is within the configured whitelist range.
**Q: What should I do if I don't receive callback notifications?**
Please check:
* Confirm that the notification URL has been correctly configured in the merchant backend;
* Check whether the merchant service can be accessed from the public network and is not blocked by a firewall;
* Review server logs to confirm whether any requests arrived but returned non-200 status codes or timed out;
* Confirm whether signature verification has been correctly handled (platforms that fail verification will log failures, which can be cross-checked with the platform using `traceId`);
* Compare status updates using the order/refund query interface.
**Q: How can I avoid duplicate processing of callback notifications?**
Please check:
* Before processing, first check based on `orderId`/`refundId `+ status whether this status has already been processed; if so, return success directly to maintain idempotency.
**Q: In a multi-chain payment scenario, if a user transfers partial amounts to ETH and TRX addresses separately, how is the order considered successful?**
Please check:
* It is recommended that the frontend only display and guide users to select one chain to complete payment. If supporting multiple cumulative payments is necessary:
* Confirm with the platform whether amount accumulation across multiple chains/transactions on an order basis is allowed;
* If allowed, establish business rules to consider the order successful once the cumulative amount reaches the expected total, and include transaction details in statements.
# Introduction
Source: https://docs.oristapay.com/en/digital-wallet/index
One-stop stablecoin fund management offering seamless liquidity and treasury solutions across digital currencies for real enterprises, multinational corporations, non-bank financial institutions, and stablecoin networks.
Reach over 200 countries and regions, support mainstream stablecoin payment systems, and expand your global business footprint. Widely accept major stablecoins, enable payments in popular stablecoins, support both self-funded and third-party collections. Customized payment solutions with diverse options tailored to your specific needs for business privacy and operational efficiency.
Accelerate cash flow while strictly maintaining compliance. Our automated platform enables fast settlements supported by real-time anti-money laundering monitoring and transaction behavior analysis, ensuring efficient and secure fund flows.
## Contact us
Need more support and communication? [Click here](mailto:itsupport@rd.group) to contact us by email.
# Quick Start
Source: https://docs.oristapay.com/en/digital-wallet/quickstart
## Preparation before integration testing
* RD needs to provide:
* clientId & clientSecret (for Merchant identity authentication)
* RD public key certificate
* Test environment IP
* APP for RD test environment
* SDK
* Customers need to provide:
* Test environment IP (IP used to call the API, network environment IP for running the test APP)
* Callback address
* Merchant public key certificate
## Quick Access Guide (SDK)
### **Business process diagram**
**Create a Sub-wallet**
```mermaid theme={null}
sequenceDiagram
participant Customer
participant Platform
rect rgb(242,247,250)
loop Submit form files
Customer->>+Platform: 【File Upload】(FileUpload)
Platform->>Platform: Validate file
Platform-->>-Customer: Return file key
end
end
rect rgb(235,245,255)
note over Customer,Platform: Company Profile Submission & Review
Customer->>+Platform: Submit Company Profile(CreateProfileApplication)
Platform->>Platform: Validate form integrity
Platform-->>-Customer: Return validation result (Success)
Platform->>Platform: Review company profile
Platform->>+Customer: Review Result Notification(callbackRequest)
Customer-->>-Platform: Confirm receipt
end
rect rgb(227,242,253)
note over Customer,Platform: Sub-Wallet Creation & Query
Customer->>+Platform: Query Company Profile(QueryCompanyProfile)
Platform-->>-Customer: Return company details
Customer->>+Platform: Create Sub-Wallet(CreateSubWallet)
Platform->>Platform: Process creation request
Platform-->>-Customer: Return submission success
Platform->>+Customer: Wallet Activation Result(callbackRequest)
Customer-->>-Platform: Confirm receipt
Customer->>+Platform: Query Wallet List(WalletList)
Platform-->>-Customer: Return wallet list
end
```
**Deposit whitelist process**
```mermaid theme={null}
sequenceDiagram
participant Client
participant Platform
participant Blockchain
rect rgb(242,247,250)
note over Client,Blockchain: Signature Verification Flow
Client->>+Platform: Get signature data (GetSignData)
Platform-->>-Client: Return data to be signed
Client->>+Platform: Add address to whitelist (AddAddressWhitelist)
Platform->>Platform: Verify signature
Platform-->>-Client: Return addition success
end
rect rgb(235,245,255)
note over Client,Blockchain: Small Transfer Flow
Client->>+Platform: Add address to whitelist (AddAddressWhitelist)
Platform->>Platform: Generate deposit info
Platform-->>-Client: Return pending status, deposit address and amount
Client->>+Blockchain: Transfer (specified amount)
Blockchain->>+Platform: Transfer result
Platform->>Platform: Review transfer and deposit
end
rect rgb(227,242,253)
Platform->>+Client: Whitelist added successfully (callbackRequest)
Client-->>-Platform: Confirm receipt
end
```
**Deposit process**
```mermaid theme={null}
sequenceDiagram
participant Customer
participant Platform
participant Blockchain
rect rgb(242,247,250)
note over Customer,Blockchain: Address Query & Order Declaration
Customer->>+Platform: Receive Address Query(ReceiveAddressQuery)
Platform-->>-Customer: Return receive address
Customer->>+Platform: Declare Receive Order(DeclareReceiveOrder)
Platform-->>-Customer: Return declaration result
end
rect rgb(235,245,255)
note over Customer,Blockchain: Transfer & Result Sync
Customer->>+Blockchain: Transfer(Amount)
Blockchain->>+Platform: Transfer Result
end
rect rgb(227,242,253)
note over Customer,Blockchain: Deposit Processing & Notification
Platform->>Platform: Check address whitelist
Platform->>Platform: Verify transaction compliance
Platform->>Platform: Execute fund deposit
Platform->>+Customer: Deposit Success Result Notification(CallbackRequest)
Customer-->>-Platform: Confirm receipt
end
```
**Request Payment process**
```mermaid theme={null}
sequenceDiagram
participant Customer
participant Platform
participant Blockchain
rect rgb(242,247,250)
note over Customer,Blockchain: Order Declaration & Review
Customer->>+Platform: Order Declaration(RequestPaymentOrderDeclare)
Platform->>Platform: Process declaration request
Platform-->>-Customer: Return submission success
Platform->>Platform: Review order
Platform->>+Customer: Result Notification(CallbackRequest)
Customer-->>-Platform: Confirm receipt
end
rect rgb(235,245,255)
note over Customer,Blockchain: Transfer & Receipt
Customer->>+Blockchain: Transfer(Specified amount to deposit address)
Blockchain-->>-Customer: Transfer receipt
Blockchain->>+Platform: Push transfer result
end
rect rgb(227,242,253)
note over Customer,Blockchain: Deposit Verification & Notification
Platform->>Platform: Check order material completeness
Platform->>Platform: Verify transaction compliance
Platform->>Platform: Execute fund deposit
Platform->>+Customer: Deposit Success Result Notification(CallbackRequest)
Customer-->>-Platform: Confirm receipt
end
```
**Sub-wallet Aggregation Process**
```mermaid theme={null}
sequenceDiagram
participant Customer
participant Platform
rect rgb(235,245,255)
note over Customer,Platform: Wallet Transfer Process
Customer->>+Platform: Wallet Transfer(WalletTransfer)
Platform-->>-Customer: Return Success
end
rect rgb(227,242,253)
Platform->>+Customer: Transfer Successful Result Notification(CallbackRequest)
Customer-->>-Platform: Confirm Receipt
end
```
**Payout process**
```mermaid theme={null}
sequenceDiagram
participant Customer
participant Platform
rect rgb(235,245,255)
note over Customer,Platform: Add Bank Account Process
Customer->>+Platform: Add Bank Account(AddBankAccount)
Platform->>Platform: Review Account
Platform-->>-Customer: Return Review Result
Platform->>+Customer: Addition Completed 【Result Notification】(CallbackRequest)
Customer-->>-Platform: Confirm Receipt
end
rect rgb(227,242,253)
note over Customer,Platform: Quote, Order & Exception Handling Process
Customer->>+Platform: Payout Quote(PayoutQuote)
Platform-->>-Customer: Return Quote
Customer->>+Platform: Payout Book(PayoutBook)
Platform-->>-Customer: Return Order Result
Platform->>Platform: Process Order
Platform->>+Customer: Processing Completed 【Result Notification】(CallbackRequest)
Customer-->>-Platform: Confirm Receipt
Customer->>+Platform: Re-settle(payoutReSettle)
Platform->>Platform: Process Re-settlement
Platform-->>-Customer: Return Processing Result
Platform->>+Customer: Re-settlement 【Result Notification】(CallbackRequest)
Customer-->>-Platform: Confirm Receipt
end
```
### **Java SDK Integration Guide**
**Importing Dependencies**
```xml theme={null}
4.0.0
group.rd.digitalasset
digitalasset-toolkit-example
0.1.0
jar
Digitalasset :: Toolkit :: Example
https://developer.rd.group
UTF-8
group.rd.digitalasset
digitalasset-toolkit
0.1.25
ch.qos.logback
logback-classic
1.4.12
```
**Configuring environment variables**
Please set RD\_MODE to UAT|PRO in the environment variable
**Configure the location of the business party private key and RD public key file**
Refer to the following sample code. The business party needs to pgpPathstore the following content in the specified directory:
1. The private key currently used by the business party:/clientFingerprint/private.key
2. The RD public key currently used by the business party:/serverFingerprint/public.key
**Integration Example**
```java theme={null}
package group.rd.digitalasset.example;
import group.rd.digitalasset.toolkit.Profile;
import group.rd.digitalasset.toolkit.RDToolkit;
import group.rd.digitalasset.toolkit.api.v1.*;
import org.junit.jupiter.api.Test;
import java.io.FileInputStream;
import java.io.IOException;
public class Demo {
private final static Logger log = LoggerFactory.getLogger(Demo.class);
public static void main(String[] args) {
String appId = "rdClient";
String clientId = "01JGB38S8Y5MZTSGDF9Q12123C";
String clientSecret = "XvuJ2ruKpzy8jiL2PRHvholxrvUYdH54";
String clientFingerprint = "468defed2a1c5e571c181fdb878990b54c24ccdb0da";
String serverFingerprint = "ee5ec5bf94af5f8sdsdad61355e1e397ce0536";
String privateKeyPwd = "test_password";
String path = this.getClass().getClassLoader().getResource("").getPath() + "pgp";
path = path.replaceFirst("/", "");
System.out.println(" path:" + path);
//Configure the global certificate root path
Profile profile = Profile.of(appId, clientFingerprint, serverFingerprint);
RDToolkit rdToolkit = RDToolkit.of(path, profile)
.addAuthority(clientId, clientSecret)
.addSecret(clientFingerprint, privateKeyPwd);
WalletListResp walletListResp = rdToolkit.walletList();
}
}
```
# API Doc
Source: https://docs.oristapay.com/en/digital-wallet/rdpay-api
# 2026/03/06
| Release Date | Description of Product | Version |
| :----------- | :------------------------------------------------------------------------------------------------------------------------------- | :------ |
| 2025/05/08 | First Draft | V0.1.0 |
| 2025/06/11 | Adding companyCode and walletType as request parameters to the WalletList interface | V0.1.1 |
| 2025/07/31 | Update PayoutModel parameters from symbol,aside to fromAmount,toAmount and merge AgentModel;Add BankId parameter to bank account | V0.1.2 |
| 2025/08/18 | The payee removes the paymentWay | V0.1.3 |
| 2025/09/26 | The system now adds support for SOL and PLOY chains | V0.1.4 |
| 2025/10/21 | Added PayoutModel parameters extOrderNo | V0.1.5 |
| 2026/03/06 | The payee supports third-party non identical names | V0.1.6 |
# API Index
| Category | # | API | REST Path |
| ------------------- | -- | ----------------------------------- | ----------------------------------------------- |
| WalletManagementAPI | 1 | Fixed Receiving Address Query | `POST /api/v1/wallet/receive-address/query` |
| WalletManagementAPI | 2 | Static Receiving Address Query | `POST /api/v1/wallet/static-address/query` |
| WalletManagementAPI | 3 | Supported Currencies Query | `POST /api/v1/wallet/supported/currencies` |
| WalletManagementAPI | 4 | Wallet Assets | `POST /api/v1/wallet/assets` |
| WalletPaymentAPI | 1 | Wallet Transfer | `POST /api/v1/payment/transfer` |
| WalletPaymentAPI | 2 | Get Signature | `POST /api/v1/payment/sign` |
| WalletPaymentAPI | 3 | Add Address Whitelist | `POST /api/v1/payment/address/whitelist/add` |
| WalletPaymentAPI | 4 | Check Address Whitelist | `POST /api/v1/payment/address/whitelist/check` |
| WalletPaymentAPI | 5 | Delete Address Whitelist | `POST /api/v1/payment/address/whitelist/delete` |
| WalletPaymentAPI | 6 | Declare Receive Order | `POST /api/v1/payment/order/declare` |
| WalletPaymentAPI | 7 | Wallet Order Detail | `POST /api/v1/payment/order/detail` |
| WalletPaymentAPI | 8 | Request Payment Order Declaration | `POST /api/v1/payment/order/declare` |
| WalletPaymentAPI | 9 | Request Payment Material Supplement | `POST /api/v1/payment/order/add/materials` |
| WalletPaymentAPI | 10 | Fee Query | `POST /api/v1/payment/fee/query` |
| WalletPaymentAPI | 11 | Withdraw | `POST /api/v1/payment/withdraw` |
| WalletPaymentAPI | 12 | Download Statement | `POST /api/v1/payment/reconciliation` |
| Off-ramp API | 1 | Payout Quote | `POST /api/v1/payout/quote` |
| Off-ramp API | 2 | Payout Order | `POST /api/v1/payout/book` |
| Off-ramp API | 3 | Payout Order Enquiry | `POST /api/v1/payout/enquiry` |
| Off-ramp API | 4 | Payout Re-Settle | `POST /api/v1/payout/reSettle` |
| Off-ramp API | 5 | Add Beneficiary Bank Account | `POST /api/v1/wallet/bank_account/add` |
| Off-ramp API | 6 | Update Beneficiary Bank Account | `POST /api/v1/wallet/bank_account/update` |
| Off-ramp API | 7 | Delete Beneficiary Bank Account | `POST /api/v1/wallet/bank_account/del` |
| Off-ramp API | 8 | Enquiry Beneficiary Bank Account | `POST /api/v1/wallet/bank_account/get` |
# WalletManagementAPI
## 1. Fixed Receiving Address Query (ReceiveAddressQuery)
**Interface Overview**
Query the payment address of a specified wallet under a specific blockchain and currency.
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------- | :------- | :------------- | :----------------------------------- |
| walletId | int64 | M | Wallet ID |
| network | string | M | Blockchain network: ETH/TRX/SOL/POLY |
| currency | string | M | Currency: USDT/USDC |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :---------------------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int64 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, providing detailed processing information or error Description |
| data | ReceiveAddressQueryData | Payment address query data |
**ReceiveAddressQueryData Field Description**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :-------------- |
| address | string | Payment address |
**Request Example**
```json theme={null}
{
"walletId": 123456789,
"network": "ETH",
"currency": "USDT"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data": {
"address": "0x123456789abcdef"
}
}
```
## 2. Static Receiving Address Query (StaticAddressQuery)
**Interface Overview**
Query the Request Payment static receiving address of a specified wallet.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :--------- | :----- | :--------- | :------------------------------------------------- |
| walletId | int64 | M | Wallet ID |
| network | string | O | Blockchain network: `ETH` / `TRX` / `SOL` / `POLY` |
| currency | string | O | Currency: `USDT` / `USDC` |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :------------------------ | :---------------------------- |
| code | int32 | Business response code |
| message | string | Business response message |
| data | Array\ | Static receiving address list |
**StaticAddressData Field Description**
| Field Name | Type | Description |
| :----------- | :----- | :---------------------------------------------------------------------------------------------------------------------------------- |
| walletId | int64 | Wallet ID |
| network | string | Blockchain network, such as `ETH` / `TRX` |
| currency | string | Currency, such as `USDT` / `USDC` |
| address | string | Static receiving address |
| qrCodeBase64 | string | QR code image of the address, Base64 encoded, including the `data:image/png;base64,` prefix. It can be directly used in ` ` |
**Request Example**
```json theme={null}
{
"walletId": 123456789,
"network": "ETH",
"currency": "USDT"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": [
{
"walletId": 123456789,
"network": "ETH",
"currency": "USDT",
"address": "0x9f8b2c1d4e5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c",
"qrCodeBase64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}
]
}
```
## 3. Supported Currencies Query (SupportedCurrenciesQuery)
**Interface Overview**
Query the currencies, available networks, single-transaction amount range, and currency precision supported by the wallet under a specified business type by `walletId + type`. The caller can use this API for pre-validation before creating deposit or withdrawal orders, to avoid submitting unsupported or out-of-limit currency combinations.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :--------- | :----- | :--------- | :---------------------------------------------------- |
| walletId | int64 | M | Wallet ID |
| type | string | M | Business type / limit type: `4` deposit, `3` withdraw |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :----------------------------------- | :------------------------------------------------ |
| code | int32 | Business response code |
| message | string | Business response message |
| data | Array\ | Supported currency list; returned when `code = 1` |
**SupportedCurrenciesQueryData Field Description**
| Field Name | Type | Description |
| :--------- | :------------- | :--------------------------------------------------------------------------------- |
| type | int32 | Business type / limit type, corresponding to the request `type` |
| currency | string | Currency, such as `USDT` / `USDC` / `USD` |
| minAmount | string | Minimum single-transaction amount, decimal number in string format |
| maxAmount | string | Maximum single-transaction amount, decimal number in string format |
| networks | Array\ | Supported blockchain network list for this currency, such as `ETH` / `TRX` / `SOL` |
| precision | int32 | Amount precision, number of decimal places |
**Request Example**
```json theme={null}
{
"walletId": 123456789,
"type": 4
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": [
{
"type": 4,
"currency": "USDT",
"minAmount": "10",
"maxAmount": "50000",
"networks": ["ETH", "TRX"],
"precision": 6
},
{
"type": 4,
"currency": "USDC",
"minAmount": "10",
"maxAmount": "50000",
"networks": ["ETH", "SOL"],
"precision": 6
}
]
}
```
## 4. Wallet Assets (WalletAssets)Query (walletAssets)
**Interface Overview**
Query wallet asset information.
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------- | :------- | :------------- | :-------------- |
| walletId | int64 | M | Wallet ID |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, providing detailed processing information or error Description |
| data | WalletDetailDto | Wallet details data |
**WalletDetailDto Field Description**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :---------------------------------------- |
| walletId | int64 | Wallet ID |
| companyName | string | Company Name |
| companyNameCn | string | Chinese company name |
| walletStatus | int32 | Wallet Status: 1-Available 2-Freeze |
| createTime | string | Wallet creation time |
| walletType | int32 | Wallet Type: 1- Main wallet 2-Sub-wallet |
| assets | AssetDto | Custodied Assets List |
| exchangeAssets | AssetDto | Trading Assets List |
**AssetDto Field Description**
| **Field Name** | **Type** | **Description** |
| :--------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------- |
| network | string | Blockchain network, which represents the network to which the asset belongs Trading assets do not have this field; e.g.ETH/TRX/SOL/POLY |
| currency | string | Asset currency: USDT/USDC |
| totalBalance | string | Total balance |
| availableBalance | string | Available balance |
| lockBalance | string | Locked balance |
**Request Example**
```json theme={null}
{
"walletId": 1001
}
```
**Response Example**
```json theme={null}
{
"code":1,
"message":"success",
"data":{
"walletId":123456789,
"companyName":"RD Tech",
"companyNameCn":"圆币科技",
"walletStatus":1,
"createTime":"2024-05-20T10:00:00Z",
"walletType":1,
"assets":[
{
"network":"ETH",
"currency":"USDT",
"totalBalance":"10.0",
"availableBalance":"10.0",
"lockBalance":"0"
}
],
"exchangeAssets":[
{
"currency":"USDT",
"totalBalance":"10.0",
"availableBalance":"10.0",
"lockBalance":"0"
}
]
}
}
```
# WalletPaymentAPI
## 1. Wallet Transfer(walletTransfer)
**Interface Overview**
Execute fund transfers between wallets within the platform.
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------- | :------- | :------------- | :----------------------------------------------- |
| walletId | int64 | M | ID of the wallet from which the transfer is made |
| targetWalletId | int64 | M | ID of the wallet to be transferred |
| currency | string | M | Transfer currency: USDT/USDC |
| network | string | M | Transfer currency network: ETH/TRX/SOL/POLY |
| amount | string | M | Transfer Amount |
| extOrderNo | string | M | External Order ID(Unique) |
| message | string | O | Transfer Notes |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :----------------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, indicating the Description or error information of the transfer operation |
| data | WalletTransferData | Data of transfer operations |
**WalletTransferData Field Description**
| Field Name | Type | Description |
| :--------- | :----- | :-------------- |
| orderNo | string | RD Order Number |
**Request Example**
```json theme={null}
{
"walletId": 1001,
"targetWalletId": 1002,
"currency": "USDT",
"network": "ETH",
"amount": "1.0",
"extOrderNo": "EXT123456789",
"message": "Transfer Notes"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data": {
"orderNo": "ORDER123456789"
}
}
```
## 2. Get Signature (getSignData)
**Interface Overview**
Get the signature.
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------- | :------- | :------------- | :----------------------------------- |
| network | string | M | Blockchain network: ETH/TRX/SOL/POLY |
| address | string | M | Address to be added to the Whitelist |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, indicating the result of the operation or error information |
| data | SignData | Signature response data |
**SignData Field Description**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :-------------------- |
| data | string | Signature Data |
| expireTime | int64 | Signature expiry time |
**Request Example**
```json theme={null}
{
"network": "ETH",
"address": "0x123456789abcdef"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data":
{
"data": "93fb699d-160e-43a0-b053-817ca4bbdcfd;1746755842000",
"expireTime": 1746755842000
}
}
```
## 3. Add Address Whitelist (addAddressWhitelist)
**Interface Overview**
Add the address to the whitelist.
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------- | :------- | :------------- | :-------------------------------------------------------------------------------------- |
| network | string | M | Blockchain network: ETH/TRX/SOL/POLY |
| address | string | M | Address to add |
| checkType | int32 | M | Check Type: 1-Signature check 2-Transaction check |
| signData | string | CM | Signature information, required when the check type is signature |
| signature | string | CM | Signature result, required when the check type is signature |
| currency | string | CM | Check type is required for transactions. Receipt currency: USDT/USDC |
| walletId | int64 | M | Receiving wallet ID |
| businessType | int32 | M | Business Type: 1-deposit 2-withdraw |
| addressSource | int32 | M | Address Source Type: 1-Personal wallet 2-Exchange/custodian platform |
| platformName | string | CM | The name of the exchange/custodian platform. Required when the address source type is 2 |
| remarks | string | O | Remark |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, indicating the result of the operation or error information |
| data | WhiteListApiDto | Whitelist Add Result |
**WhiteListApiDto Field Description**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :------------------------------------------------------------------- |
| id | int64 | Request ID |
| network | string | Blockchain network: ETH/TRX/SOL/POLY |
| address | string | Address to add |
| checkType | int32 | Check Type: 1-Signature check 2-Small transfer check |
| signData | string | Data to be signed |
| signature | string | sign |
| currency | string | Currency for small transfers: USDT/USDC |
| depositAddress | string | Small amount transfer payment address |
| amount | string | Amount required for small transfers |
| status | string | state: SUCCESS、FAIL、PENDING、PENDING\_DEPOSIT |
| expireTime | int64 | Small amount transfer deadline |
| businessType | int32 | Business Type: 1-deposit 2-withdraw |
| addressSource | int32 | Address Source Type: 1-Personal wallet 2-Exchange/custodian platform |
| platformName | string | Name of the exchange/custodian platform |
| remarks | string | Remark |
**Request Example**
```json theme={null}
[
{
"network": "ETH",
"address": "0x123456789abcdef",
"checkType": 1,
"businessType": 1,
"addressSource": 1,
"walletId":429883231600640,
"remarks":"this is a remark",
"signature":"0x1e2bc15251969197f9ceedd8dc327f1ab0c993a7cd0a12794414b62be653cda410b2cd48950ffb7ee3184dcd13ce0674eefde540ce2983a0c9e91c6c4893cea51b",
"signData":"4553493b-7734-435a-8c93-9ae92e89c99e;1746612121000"
},
{
"network": "ETH",
"address": "0x123456789abcdef",
"checkType": 2,
"businessType": 1,
"addressSource": 1,
"remarks":"this is a remark",
"currency":"USDT",
"walletId":429883231600640
}
]
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": {
"id": 708258726632620032,
"network": "ETH",
"address": "0x022a50AE43baC1FBECC160a01a7eb13c64553d7F6",
"checkType": 1,
"signData": "93fb699d-160e-43a0-b053-817ca4bbdcfd;1746755842000",
"signature": "93fb699d-160e-43a0-b053-817ca4bbdcfd;1746755842000",
"currency": "",
"depositAddress": "",
"amount": "",
"status": "PENDING",
"expireTime": 0,
"businessType": 1,
"addressSource": 1,
"platformName": "",
"remarks": "this is a withdraw remark"
}
}
```
## 4. CheckAddressWhitelist(checkAddressWhitelist)
**Interface Overview**
Check if the address is in the whitelist.
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------- | :------- | :------------- | :---------------------------------------- |
| address | string | M | Check if the address is in the whitelist. |
| network | string | M | Blockchain network: ETH/TRX/SOL/POLY |
| businessType | int32 | M | Business Type: 1-deposit 2-withdraw |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :---------------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, providing detailed error information or status Description |
| data | CheckWhiteListDto | Whitelist check results |
**CheckWhiteListDto Field Description**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :---------------------------------------------------------------- |
| status | string | Status: SUCCESS, FAIL, PENDING, PENDING\_DEPOSIT,NOT\_EXIST |
| businessType | int32 | Business Type: 1-deposit 2-withdraw |
| remarks | string | Remark |
**Request Example**
```json theme={null}
{
"network": "ETH",
"address": "0x123456789abcdef",
"businessType": 1
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data":
{
"businessType": 1,
"status ": "SUCCESS",
"remarks": "deposit whitelist"
}
}
```
## 5. DeleteAddressWhitelist(deleteAddressWhitelist)
**Interface Overview**
Delete the address whitelist.
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------- | :------- | :------------- | :----------------------------------- |
| network | string | M | Blockchain network: ETH/TRX/SOL/POLY |
| address | string | M | Whitelist of addresses to be deleted |
| businessType | int32 | M | Business Type: 1-deposit 2-withdraw |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, indicating the result of the operation or error information |
**Request Example**
```json theme={null}
{
"network": "ETH",
"address": "0x123456789abcdef",
"businessType": 1
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success"
}
```
## 6. Declare Receive Order(declareReceiveOrder)
**Interface Overview**
Declare a payment order.
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :--------------- | :------- | :------------- | :------------------------------------ |
| senderAddress | string | M | Payer Address |
| recipientAddress | string | M | Recipient Address |
| amount | string | M | Amount, indicating the deposit amount |
| network | string | M | Blockchain network: ETH/TRX/SOL/POLY |
| currency | string | M | Currency: USDT/USDC |
| extOrderNo | string | M | External Order ID (Globally Unique) |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, indicating the result of the operation or error information |
**Request Example**
```json theme={null}
{
"senderAddress": "0x123456789abcdef",
"recipientAddress": "0x987654321fedcba",
"amount": "1000.0",
"network": "ETH",
"currency": "USDT",
"extOrderNo": "EXT123456789"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success"
}
```
## 7. Order details (walletOrderDetail)
**Interface Overview**
Query wallet order details.
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------- | :------- | :------------- | :----------------------------------------------------------------------- |
| walletId | int64 | M | Wallet ID |
| orderNo | string | CM | Order number Either "orderNo" or "extOrderNo" must be provided |
| extOrderNo | string | CM | External order number, Either "orderNo" or "extOrderNo" must be provided |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, providing detailed error information or processing result Description |
| data | WalletOrderDetailData | Order details data |
**WalletOrderDetailData Field Description**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :----------------------------------- |
| orderNo | string | Order Number |
| extOrderNo | string | External order number |
| orderType | string | Order Type |
| orderStatus | string | See Appendix: Deposit Order Status |
| fromAddress | string | Initiator address |
| fromWallet | string | Source wallet |
| toAddress | string | Recipient Address |
| toWallet | string | Target wallet |
| amount | string | Amount |
| network | string | Blockchain network: ETH/TRX/SOL/POLY |
| currency | string | Currency: USDT/USDC |
| expireTime | int64 | Order expiration time |
| createTime | int64 | Order creation time |
**Request Example**
```json theme={null}
{
"orderNo": "ORDER123456789"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data": {
"orderNo": "447767487604736",
"extOrderNo": "1744341998597",
"orderType": "PayIn",
"orderStatus": "SUCCESSFUL",
"fromAddress": "0x213F2B229BE4f3FFF88fc874a986b19D79623339",
"toAddress": "0xc496E20b19F009543E49b8512CB990ceb0a230F0",
"toWallet": "429883231600640",
"amount": "17",
"network": "ETH",
"currency": 1744342001561,
"expireTime": 1744342629783,
"createTime": 1744343297296
}
}
```
## 8. Request Payment Order Declaration (payinOrderDeclare)
**Interface Overview**
Submit a Request Payment deposit order
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :-------------------- | :------- | :------------- | :------------------------------------------------------------------------------------------ |
| walletId | int64 | M | Deposit wallet ID |
| extOrderNo | string | M | External order ID(Unique) |
| senderAddress | string | M | Payer wallet address |
| network | string | M | Blockchain network: ETH/TRX/SOL/POLY |
| currency | string | M | Currency: USDT/USDC |
| amount | string | M | Declared amount Note: The declared amount must exactly match the final deposit amount |
| senderName | string | M | Payer Name |
| countryRegion | string | M | Please refer to the Country/Region ISO 3166 Code. e.g.HKG |
| contactAddress | string | M | Payer contact address |
| receiverName | string | M | Recipient Merchant Name |
| message | string | O | Remark |
| orderMaterials | Object | O | Collection of Material Declaration Objects for Order Return |
| productType | string | M | Product Type |
| productName | string | M | Product Name |
| productPrice | string | M | Product Price |
| productCount | string | M | Product Quantity |
| productUnit | string | M | Product Unit |
| logisticsTrackingName | string | O | Logistics Company Name |
| logisticsTrackingNo | string | O | Tracking number |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :---------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing |
| message | string | Response message, indicating the result of the operation or error information |
**Request Example**
```json theme={null}
{
"walletId": "429883231600640",
"extOrderNo": "1747626211614",
"senderAddress": "0x213F2B229BE4f3FFF88fc874a986b19D79623339",
"network": "ETH",
"currency": "USDC",
"senderName": "Reflective Method Invocation",
"countryRegion": "HKG",
"contactAddress": "contact address hong kong",
"receiverName": "Reflective Method Invocation",
"message": "request payment msg",
"materials": [{
"productType": "Electronics",
"productName": "Wireless Bluetooth Headphones",
"productPrice": "89.99",
"productCount": "150",
"productUnit": "pcs",
"logisticsTrackingName": "FedEx International Priority",
"logisticsTrackingNo": "FX123456789US"
}],
"amount": "150"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success"
}
```
## 9. Request Payment order material supplement (addRequestPaymentMaterials)
**Interface Overview**
Submit order and add product information and other materials
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :-------------------- | :------- | :------------- | :------------------------ |
| walletId | int64 | M | Deposit wallet ID |
| orderNo | string | M | Order ID |
| productType | string | M | Product Type |
| productName | string | M | Product Name |
| productPrice | string | M | Product Prices |
| productCount | string | M | Quantity of products |
| productUnit | string | M | Commodity Unit |
| logisticsTrackingName | string | O | Logistics Company Name |
| logisticsTrackingNo | string | O | Logistics tracking number |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :---------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing |
| message | string | Response message, indicating the result of the operation or error information |
**Request Example**
```json theme={null}
{
"walletId": "429883231600640",
"orderNo": "447767487604736",
"materials": [{
"productType": "Electronics",
"productName": "Wireless Bluetooth Headphones",
"productPrice": "89.99",
"productCount": "150",
"productUnit": "pcs",
"logisticsTrackingName": "FedEx International Priority",
"logisticsTrackingNo": "FX123456789US"
}]
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success"
}
```
## 10. Fee Query (feeQuery)
**Interface Overview**
Fee Inquiry Interface for querying Transaction Fees.
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------- | :------- | :------------- | :----------------------------------- |
| orderType | int32 | M | See Appendix: Order Type |
| walletId | int64 | M | Wallet ID |
| network | string | M | Blockchain network: ETH/TRX/SOL/POLY |
| currency | string | M | Currency: USDT/USDC |
| payAmount | string | M | Order amount |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :---------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, indicating the result of the operation or error information |
| data | Fee Details | |
**Fee details field Description**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :----------------------------------- |
| walletId | int64 | Wallet ID |
| network | string | Blockchain network: ETH/TRX/SOL/POLY |
| currency | string | Currency: USDT/USDC |
| payAmount | string | Order amount |
| feeAmount | string | Service Fee |
| receiveAmount | string | Amount Received |
**Request Example**
```json theme={null}
{
"walletId": "429883231600640",
"network": "ETH",
"currency": "USDC",
"payAmount": "666.66"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data": {
"walletId": "429883231600640",
"network": "ETH",
"currency": "USDC",
"payAmount": "666.66",
"feeAmount": "19.9998",
"receiveAmount": "646.6602"
}
}
```
## 11. Withdraw order(withdraw)
**Interface Overview**
Create a withdrawal order
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :--------------- | :------- | :------------- | :----------------------------------------------- |
| walletId | int64 | M | Wallet ID |
| extOrderNo | string | M | External order ID(Unique) |
| network | string | M | Blockchain network: ETH/TRX/SOL/POLY |
| currency | string | M | Currency: USDT/USDC |
| payAmount | string | M | The order amount supports up to 6 decimal places |
| recipientAddress | string | M | Recipient Blockchain Address |
| recipientName | string | M | Recipient Name |
| message | string | O | Remark |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, indicating the result of the operation or error information |
**Request Example**
```json theme={null}
{
"walletId": "429883231600640",
"extOrderNo": "ext-1745477734002",
"network": "ETH",
"currency": "USDC",
"recipientAddress": "0x213F2B229BE4f3FFF88fc874a111b19D79623339",
"message": "Message ttt",
"payAmount": "666.66"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success"
}
```
## 12. Download the statement (queryReconBill)
**Interface Overview**
At 9:00 am every day, the D-1 day statement can be downloaded (Note: the time zone corresponding to the time involved in the document is Hong Kong UTC+8 time zone)
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------- | :------- | :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| walletId | int64 | M | Wallet ID |
| billDate | string | M | Billing Date (YYYYMMDD) |
| modeType | int32 | M | Authorization mode: 1- Direct connection mode (download the current wallet statement) 2-Authorization mode (download current wallet and sub-wallet statements) |
| accountType | int32 | M | Account type, only supports Fiduciary Account: 1-Fiduciary Account |
| currencyType | int32 | M | Currency Type: 1: ETH-USDT (Custody Account Currency) 2: ETH-USDC (Custody Account Currency) 3: TRX-USDT (Custody Account Currency) 4: USDT (Trading Account Currency) 5: USDC (Trading Account Currency) 6: USD (Custody Account Currency) |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :------------- | :---------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing |
| message | string | Response message, indicating the result of the operation or error information |
| data | WalletBillData | Statement Information |
**WalletBillData Field Description**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :--------------------------------------------------- |
| fileName | string | File name |
| fileUrl | string | Download address of the zip package of the statement |
**Request Example**
```json theme={null}
{
"walletId ": 123456789,
"billDate": "20250330",
"modeType": 1,
"accountType": 1,
"currencyType": 1
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data": {
"fileName": "20231123_123456789_Statement_ETHUSDT.zip",
"fileUrl": "https://hk-pro-wallet-private-oss.oss-cn-hongkong.aliyuncs.com/thirdpartybilling/1737925914987610112.zip?Expires=1703216183&OSSAccessKeyId=LTAI5tKJmyxrRXQgpGwhhVnK&Signature=8MXwogxJ0NXBZ3FTS6O97%2B%2FpEiQ%3D"
}
}
```
# Off-ramp API
## 1. Quote(payoutQuote)
**Interface Overview**
Used to obtain the price of a specified currency pair
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------- | :------- | :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| walletId | int64 | M | Wallet ID |
| network | string | O | Blockchain Network: ETH/TRX/SOL/POLY |
| fromCurrency | string | M | From Currency: USDT,USDC |
| fromAmount | string | CM | From Amount, supports 2 decimal places At least one of fromAmount or toAmount must be provided |
| toCurrency | string | M | To Currency: USD |
| toAmount | string | CM | To Amount, supports 2 decimal places At least one of fromAmount or toAmount must be provided |
| paymentWay | string | M | Payment Method:RDT/CHATS |
| feeMode | int32 | CM | This field is required if paymentWay is CHATS. Fee Deduction Mode: 1 - Shared by both sender and receiver (SHAR) 2 - Borne entirely by the payer (OUR) |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, providing detailed processing information or error Description |
| data | PayoutQuoteData | Price and Transfer-Related Data |
**PayoutQuoteData Field Description**
| **Field Name** | **Type** | **Description** |
| :-------------- | :------- | :-------------------------------------------------------------------------------------------------------------------- |
| walletId | int64 | Wallet ID |
| network | string | Blockchain Network: ETH/TRX/SOL/POLY |
| fromCurrency | string | From Currency: USDT,USDC |
| fromAmount | string | From Amount |
| toCurrency | string | To Currency: USD |
| toAmount | string | To Amount(Subtract Service fee ) |
| paymentWay | string | Payment Method:RDT/CHATS |
| feeMode | int32 | Fee Deduction Mode: 1 - Shared by both sender and receiver (SHAR) 2 - Borne entirely by the payer (OUR) |
| quoteId | int64 | Inquiry ID |
| price | string | price |
| priceExpireTime | string | Price Expiration Time |
| feeAmount | string | Service fee |
| feeCurrency | string | Fee Currency |
**Request Example**
```json theme={null}
{
"walletId":1000232233,
"network":"ETH",
"fromCurrency":"USDT",
"fromAmount":"200.12",
"toCurrency":"USD",
"paymentWay":"CHATS",
"feeMode":1
}
```
**Response Example**
```json theme={null}
{
"code":1,
"message":"Success",
"data":{
"walletId":"429405186232384",
"network":"ETH",
"fromCurrency":"USDT",
"fromAmount":"200.12",
"toCurrency":"USD",
"toAmount":"192.83",
"paymentWay":"CHATS",
"feeMode":1,
"quoteId":"665131773713321985",
"price":"0.9986",
"priceExpireTime":"1736387772381",
"feeAmount":"7",
"feeCurrency":"USD"
}
}
```
## 2. Payout order (payoutBook)
**Interface Overview**
Place a payout order based on the `quoteId` returned by the quote API.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :------------------- | :----- | :--------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- |
| walletId | int64 | M | Wallet ID |
| quoteId | int64 | M | Quote ID |
| settlementAccountUID | int64 | M | Settlement account ID, obtained through the bank account enquiry API |
| purpose | string | M | Payment purpose. See Appendix: Purpose |
| extOrderNo | string | M | Unique order ID provided by the business entity. Only numbers, letters, `_`, `-`, and `*` are allowed. Must be unique under the same merchant account |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :------------- | :------------------ |
| code | int32 | Response code |
| message | string | Response message |
| data | PayoutBookData | Payout order result |
**PayoutBookData Field Description**
| Field Name | Type | Description |
| :------------------- | :----- | :------------------------------------------------------------------------------------------------------- |
| walletId | int64 | Wallet ID |
| quoteId | int64 | Quote ID |
| settlementAccountUID | int64 | Settlement account ID |
| purpose | string | Payment purpose. See Appendix: Purpose |
| orderNo | string | Order number |
| fromCurrency | string | From currency: USDT / USDC |
| fromAmount | string | From amount |
| toCurrency | string | To currency: USD |
| toAmount | string | To amount after deducting service fee |
| paymentWay | string | Payment method: RDT / CHATS |
| feeMode | int32 | Fee deduction mode: 1 - shared by both sender and receiver (SHAR); 2 - borne entirely by the payer (OUR) |
| feeAmount | string | Service fee |
| feeCurrency | string | Fee currency |
| orderStatus | string | See Appendix: Payout Order Status |
| createTime | int64 | Order creation time |
| extOrderNo | string | Unique order ID provided by the business entity |
**Request Example**
```json theme={null}
{
"walletId": 1000232233,
"quoteId": 665131773713321985,
"settlementAccountUID": 48775048489845,
"purpose": "PMT001",
"extOrderNo": "1234567898"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": {
"walletId": 429405186232384,
"quoteId": 665205920267108353,
"settlementAccountUID": 1236547995462114,
"purpose": "PMT001",
"orderNo": "431513431160832",
"fromCurrency": "USDT",
"fromAmount": "200.12",
"toCurrency": "USD",
"toAmount": "192.83",
"paymentWay": "CHATS",
"feeMode": 1,
"feeAmount": "7",
"feeCurrency": "USD",
"orderStatus": "SUBMITTED",
"createTime": 1736405450558,
"extOrderNo": "1234567898"
}
}
```
## 3. **Payout Order Enquiry(payoutEnquiry)**
**Interface Overview**
To query order information
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------- | :------- | :------------- | :-------------------------------------------------- |
| walletId | int64 | M | Wallet ID |
| orderNo | string | CM | At least one of orderNo or quoteId must be provided |
| quoteId | int64 | CM | At least one of orderNo or quoteId must be provided |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :--------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, providing detailed processing information or error Description |
| data | PayoutData | Order query data |
**PayoutData Field Description**
| **Field Name** | **Type** | **Description** |
| :------------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| walletId | int64 | Wallet ID |
| quoteId | int64 | Inquiry ID |
| orderNo | string | Order Number |
| fromCurrency | string | From Currency: USDT,USDC |
| fromAmount | string | From Amount |
| toCurrency | string | To Currency: USD |
| toAmount | string | To Amount(Subtract Service fee ) |
| tradeFromAmount | string | Transaction amount |
| tradeToAmount | string | Transaction amount |
| price | string | Order price |
| tradePrice | string | Transaction price |
| orderStatus | string | See Appendix:Payout order status |
| createTime | int64 | Order creation time |
| finishTime | int64 | Order completion time |
| errorMsg | string | Order failure reason |
| settlementAccountUID | int64 | Settlement Account ID(Unique) |
| purpose | string | See Appendix: Purpose |
| paymentWay | string | Payment Method:RDT/CHATS |
| feeMode | int32 | Fee Deduction Mode: 1-Shared by both sender and receiver (SHAR) 2-Borne entirely by the payer (OUR) This field is required if accountType of settlementAccountUID is 2. |
| feeAmount | string | Service fee |
| feeCurrency | string | Fee Currency |
| refundOrderNo | string | Refund order no when the order fail |
| refundAmount | string | Refund amount when the order fail |
| refundCurrency | string | Refund currency when the order fail |
| extOrderNo | string | Unique Order ID provided by Business Entities |
**Request Example**
```json theme={null}
{
"walletId": 1000232233,
"quoteId": 665131773713321985
}
```
**Response Example**
```json theme={null}
{
"code":1,
"message":"Success",
"data":{
"walletId":1000232233,
"quoteId":665131773713321985,
"orderNo":"442112731049984",
"fromCurrency":"USDT",
"fromAmount":"200.12",
"toCurrency":"USD",
"toAmount":"192.83",
"tradeFromAmount":"200.12",
"tradeToAmount":"192.83",
"price":"1.142",
"tradePrice":"1.142",
"orderStatus":"SUCCESSFUL",
"createTime":1741580889957,
"finishTime":1741580889957,
"settlementAccountUID":1236547995462114,
"purpose": "PMT001",
"paymentWay":"CHATS",
"feeMode":1,
"feeAmount":"7",
"feeCurrency":"USD",
"extOrderNo":"1234567898"
}
}
```
## 4. Re-settle order(payoutReSettle)
**Interface Overview**
Used to re-initiate settlement after a refund or settle fail.
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------------- | :------- | :------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| walletId | int64 | M | Wallet ID |
| orderNo | string | M | Payout Order no |
| refundOrderNo | string | M | Return Order no |
| settlementAccountUID | int64 | M | Settlement Account ID(Unique) |
| purpose | string | M | See Appendix: Purpose |
| remark | string | M | Remark |
| paymentWay | string | M | Payment Method:RDT/CHATS |
| feeMode | int32 | O | Fee Deduction Mode: 1-Shared by both sender and receiver (SHAR) 2-Borne entirely by the payer (OUR) This field is required if accountType of settlementAccountUID is 2. |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :----------------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, providing detailed processing information or error Description |
| data | PayoutReSettleData | Re-settle order data |
**PayoutReSettleData Field Description**
| **Field Name** | **Type** | **Description** |
| :------------------- | :------- | :------------------------------------------------------------------------------------------------------------ |
| walletId | int64 | Wallet ID |
| orderNo | string | Payout Order no |
| refundOrderNo | string | Return Order no |
| settlementAccountUID | int64 | Settlement Account ID(Unique) |
| purpose | string | See Appendix: Purpose |
| remark | string | Remark |
| paymentWay | string | Payment Method:RDT/CHATS |
| feeMode | int32 | Fee Deduction Mode: 1-Shared by both sender and receiver (SHAR) 2-Borne entirely by the payer (OUR) |
| amount | string | Re-settlement Amount |
| currency | int64 | Re-settlemen currency |
| feeAmount | string | Service fee |
| feeCurrency | string | Fee Currency |
**Request Example**
```json theme={null}
{
"walletId":1000232233,
"orderNo":"442112731049984",
"refundOrderNo":"232112731049984",
"settlementAccountUID":1236547995462114,
"purpose": "PMT001",
"remark":"remark",
"paymentWay":"CHATS",
"feeMode":1
}
```
**Example Response**
```json theme={null}
{
"code":1,
"message":"Success",
"data":{
"walletId":1000232233,
"orderNo":"442112731049984",
"refundOrderNo":"232112731049984",
"settlementAccountUID":1236547995462114,
"purpose": "PMT001",
"remark":"remark",
"paymentWay":"CHATS",
"feeMode":1,
"amount":"183",
"currency":"USD",
"feeAmount":"7",
"feeCurrency":"USD"
}
}
```
## 5. Add Beneficiary Bank Account(addBankAccount)
**Interface Overview**
Add a bank account for the beneficiary
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :-------------------- | :--------------- | :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| walletId | int64 | M | Wallet ID |
| alias | string | M | Alias of this bank account |
| accountOwnership | int32 | M | Ownership 1-own account 2-other account 3=Third party |
| currency | string | M | Fiat currency, eg: USD |
| accountType | int32 | M | Bank Account Type 1-RD Wallet 2-Bank Account |
| companyName | string | M | Company name accountOwnership=2,this name must be same with the name in the company profile |
| accountNumber | string | M | RD Wallet Id or Bank account number |
| bankId | string | M | HK Bank Id,example:003 |
| beneficiaryAddress1 | string | CM | Address (Line 1) of the receiving party(Chinese characters are not allowed) \*Mandatory when accountType=2 |
| beneficiaryAddress2 | string | CM | Address (Line 2) of the receiving party(Chinese characters are not allowed) \*Mandatory when accountType=2 |
| beneficiaryAddress3 | string | CM | Address (Line 3) of the receiving party Country / Region of address must be specified. Please refer to the Country/Region ISO 3166 Code. \*Mandatory when accountType=2 |
| beneficiarySwiftCode | string | CM | Unique code to identify the receiving bank (The recipient bank only supports banks located in Hong Kong. If the 5th and 6th characters of the Swift Code are not 'HK' or 'HB', it does not meet the requirements.) \*Mandatory when accountType=2 |
| intermediarySwiftCode | string | O | Intermediate BankSwiftCode (The recipient bank only supports banks located in Hong Kong. If the 5th and 6th characters of the Swift Code are not 'HK' or 'HB', it does not meet the requirements.) |
| companyCode | string | CM | Company profile code \*Mandatory when accountOwnership=2 |
| paymentFiles | Array\ | CM | Proof of payment \*Mandatory when accountOwnership=3 |
| remark | string | O | remark Optional when accountOwnership=3 |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, indicating the result of the operation or error information |
| data | BankAccountData | Bank account information |
**BankAccountData Field Description**
| **Field Name** | **Type** | **Description** |
| :-------------------- | :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| settlementAccountUID | int64 | Bank account unique id |
| walletId | int64 | Wallet ID |
| alias | string | Alias of bank account |
| accountOwnership | int32 | Ownership 1-own account 2-other account |
| currency | string | Fiat currency, eg: USD |
| accountType | int32 | Bank Account type 1-RD Wallet 2-Bank Account |
| companyName | string | Company name |
| accountNumber | string | RD Wallet Id or Bank account number |
| bankId | string | HK Bank Id,example:003 |
| beneficiaryAddress1 | string | Address (Line 1) of the receiving party(Chinese characters are not allowed) |
| beneficiaryAddress2 | string | Address (Line 2) of the receiving party(Chinese characters are not allowed) |
| beneficiaryAddress3 | string | Address (Line 3) of the receiving party Country / Region of address must be specified. Please refer to the Country/Region ISO 3166 Code |
| beneficiarySwiftCode | string | Unique code to identify the receiving bank (The recipient bank only supports banks located in Hong Kong. If the 5th and 6th characters of the Swift Code are not 'HK' or 'HB', it does not meet the requirements.) |
| intermediarySwiftCode | string | Intermediate BankSwiftCode (The recipient bank only supports banks located in Hong Kong. If the 5th and 6th characters of the Swift Code are not 'HK' or 'HB', it does not meet the requirements.) |
| companyCode | string | Company profile code |
| status | int32 | Status 0-Processing 1-Success 2-Fail |
| paymentFiles | Array\ | Proof of payment |
| remark | string | remark |
**FileInfo** **Field Description**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :--------------------------------------------------------------------------------------- |
| fileKey | string | After calling the upload interface, it will return |
| fileName | string | |
| fileUrl | string | After calling the upload interface, it will return and the URL will be updated regularly |
**Request Example**
```json theme={null}
{
"walletId": 4298832316123456,
"alias": "name alias",
"accountOwnership": 2,
"currency": "USD",
"accountType": 2,
"accountName": "narti adiddf",
"accountNumber": "8888888",
"bankId":"003",
"beneficiaryAddress1": "payee address1",
"beneficiaryAddress2": "payee address2",
"beneficiaryAddress3": "HK",
"beneficiarySwiftCode": "DHBKHKHHXXX",
"intermediarySwiftCode": "DHBKHKHHXXX",
"companyCode": "HK1239876654",
"paymentFiles": [
{
"fileKey": "file_key_123",
"fileName": "xxxx.pdf"
}
],
"remark": "remark"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data":{
"settlementAccountUID": 1236547995462114,
"walletId": 4298832316123456,
"alias": "name alias",
"accountOwnership": 2,
"currency": "USD",
"accountType": 2,
"companyName": "narti adiddf",
"accountNumber": "8888888",
"bankId":"003",
"beneficiaryAddress1": "payee address1",
"beneficiaryAddress2": "payee address2",
"beneficiaryAddress3": "HK",
"beneficiarySwiftCode": "DHBKHKHHXXX",
"intermediarySwiftCode": "DHBKHKHHXXX",
"companyCode": "HK1239876654",
"status": 0,
"paymentFiles": [
{
"fileKey": "file_key_123",
"fileName": "xxxx.pdf",
"fileUrl": "https://xxxxx"
}
],
"remark": "remark"
}
}
```
## 6. Update Beneficiary Bank Account(updateBankAccount)
**Interface Overview**
Update the bank account for the beneficiary
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :-------------------- | :--------------- | :------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| walletId | int64 | M | Wallet ID |
| settlementAccountUID | int64 | M | Bank account unique id |
| alias | string | O | Alias of this bank account |
| accountNumber | string | O | RD Wallet Id or Bank account number |
| bankId | string | O | HK Bank Id,example:003 |
| beneficiaryAddress1 | string | O | Address (Line 1) of the receiving party(Chinese characters are not allowed) |
| beneficiaryAddress2 | string | O | Address (Line 2) of the receiving party(Chinese characters are not allowed) |
| beneficiaryAddress3 | string | O | Address (Line 3) of the receiving party Country / Region of address must be specified. Please refer to the Country/Region ISO 3166 Code |
| beneficiarySwiftCode | string | O | Unique code to identify the receiving bank (The recipient bank only supports banks located in Hong Kong. If the 5th and 6th characters of the Swift Code are not 'HK' or 'HB', it does not meet the requirements.) |
| intermediarySwiftCode | string | O | Intermediate BankSwiftCode (The recipient bank only supports banks located in Hong Kong. If the 5th and 6th characters of the Swift Code are not 'HK' or 'HB', it does not meet the requirements.) |
| paymentFiles | Array\ | CM | Proof of payment \*Mandatory when accountOwnership=3 |
| remark | string | O | remark Optional when accountOwnership=3 |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, indicating the result of the operation or error information |
| data | BankAccountData | Bank account information |
**BankAccountData Field Description**
| **Field Name** | **Type** | **Description** |
| :-------------------- | :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| settlementAccountUID | int64 | Bank account unique id |
| walletId | int64 | Wallet ID |
| alias | string | Alias of bank account |
| accountOwnership | int32 | Ownership 1-own account 2-other account |
| currency | string | Fiat currency, eg: USD |
| accountType | int32 | Bank Account type 1-RD Wallet 2-Bank Account |
| companyName | string | Company name |
| accountNumber | string | RD Wallet Id or Bank account number |
| bankId | string | HK Bank Id,example:003 |
| beneficiaryAddress1 | string | Address (Line 1) of the receiving party(Chinese characters are not allowed) |
| beneficiaryAddress2 | string | Address (Line 2) of the receiving party(Chinese characters are not allowed) |
| beneficiaryAddress3 | string | Address (Line 3) of the receiving party Country / Region of address must be specified .Please refer to the Country/Region ISO 3166 Code |
| beneficiarySwiftCode | string | Unique code to identify the receiving bank (The recipient bank only supports banks located in Hong Kong. If the 5th and 6th characters of the Swift Code are not 'HK' or 'HB', it does not meet the requirements.) |
| intermediarySwiftCode | string | Intermediate BankSwiftCode (The recipient bank only supports banks located in Hong Kong. If the 5th and 6th characters of the Swift Code are not 'HK' or 'HB', it does not meet the requirements.) |
| companyCode | string | Company profile code |
| status | int32 | Status 0-Processing 1-Success 2-Fail |
| paymentFiles | Array\ | Proof of payment |
| remark | string | remark |
**Request Example**
```json theme={null}
{
"settlementAccountUID": 1236547995462114,
"walletId": 4298832316123456,
"alias": "name alias",
"accountNumber": "8888888",
"bankId":"003",
"beneficiaryAddress1": "payee address1",
"beneficiaryAddress2": "payee address2",
"beneficiaryAddress3": "HK",
"beneficiarySwiftCode": "DHBKHKHHXXX",
"intermediarySwiftCode": "DHBKHKHHXXX",
"paymentFiles": [
{
"fileKey": "file_key_123",
"fileName": "xxxx.pdf"
}
],
"remark": "remark"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data": {
"settlementAccountUID": 1236547995462114,
"walletId": 4298832316123456,
"alias": "name alias",
"accountOwnership": 2,
"currency": "USD",
"accountType": 2,
"companyName": "narti adiddf",
"accountNumber": "8888888",
"bankId": "003",
"beneficiaryAddress1": "payee address1",
"beneficiaryAddress2": "payee address2",
"beneficiaryAddress3": "HK",
"beneficiarySwiftCode": "DHBKHKHHXXX",
"intermediarySwiftCode": "DHBKHKHHXXX",
"companyCode": "HK1239876654",
"status": 0,
"paymentFiles": [
{
"fileKey": "file_key_123",
"fileName": "xxxx.pdf",
"fileUrl": "https://xxxxx"
}
],
"remark": "remark"
}
}
```
## 7. Delete Beneficiary Bank Account(delBankAccount)
**Interface Overview**
Delete the bank account for the beneficiary
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------------- | :------- | :------------- | :--------------------- |
| walletId | int64 | M | Wallet ID |
| settlementAccountUID | int64 | M | Bank account unique id |
| reason | string | M | The reason of deletion |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, indicating the result of the operation or error information |
**Request Example**
```json theme={null}
{
"settlementAccountUID": 1236547995462114,
"walletId": 4298832316123456,
"reason": "del reason"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success"
}
```
## 8. Enquiry Beneficiary Bank Account(getBankAccount)
**Interface Overview**
Enquiry the bank account of beneficiary
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------------- | :------- | :------------- | :--------------------- |
| walletId | int64 | M | Wallet ID |
| settlementAccountUID | int64 | O | Bank account unique id |
| companyCode | string | O | Company profile code |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :------------------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing, such as 1 for success, and other values for different error conditions |
| message | string | Response message, indicating the result of the operation or error information |
| data | BankAccountData list | Bank account information |
**BankAccountData Field Description**
| **Field Name** | **Type** | **Description** |
| :-------------------- | :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| settlementAccountUID | int64 | Bank account unique id |
| walletId | int64 | Wallet ID |
| alias | string | Alias of bank account |
| accountOwnership | int32 | Ownership 1-own account 2-other account 3=Third party |
| currency | string | Fiat currency, eg: USD |
| accountType | int32 | Bank Account type 1-RD Wallet 2-Bank Account |
| companyName | string | Company name |
| accountNumber | string | RD Wallet Id or Bank account number |
| bankId | string | HK Bank Id,example:003 |
| beneficiaryAddress1 | string | Address (Line 1) of the receiving party(Chinese characters are not allowed) |
| beneficiaryAddress2 | string | Address (Line 2) of the receiving party(Chinese characters are not allowed) |
| beneficiaryAddress3 | string | Address (Line 3) of the receiving party Country / Region of address must be specified Please refer to the Country/Region ISO 3166 Code |
| beneficiarySwiftCode | string | Unique code to identify the receiving bank (The recipient bank only supports banks located in Hong Kong. If the 5th and 6th characters of the Swift Code are not 'HK' or 'HB', it does not meet the requirements.) |
| intermediarySwiftCode | string | Intermediate BankSwiftCode (The recipient bank only supports banks located in Hong Kong. If the 5th and 6th characters of the Swift Code are not 'HK' or 'HB', it does not meet the requirements.) |
| companyCode | string | Company profile code |
| status | int32 | Status 0-Processing 1-Success 2-Fail |
| paymentFiles | Array\ | Proof of payment |
| remark | string | remark |
**Request Example**
```json theme={null}
{
"settlementAccountUID": 1236547995462114,
"walletId": 4298832316123456,
"companyCode": "HK1239876654"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data": [
{
"settlementAccountUID": 1236547995462114,
"walletId": 4298832316123456,
"alias": "name alias",
"accountOwnership": 2,
"currency": "USD",
"accountType": 2,
"companyName": "narti adiddf",
"accountNumber": "8888888",
"bankId": "003",
"beneficiaryAddress1": "payee address1",
"beneficiaryAddress2": "payee address2",
"beneficiaryAddress3": "HK",
"beneficiarySwiftCode": "DHBKHKHHXXX",
"intermediarySwiftCode": "DHBKHKHHXXX",
"companyCode": "HK1239876654",
"status": 0,
"paymentFiles": [
{
"fileKey": "file_key_123",
"fileName": "xxxx.pdf",
"fileUrl": "https://xxxxx"
}
],
"remark": "remark"
}
]
}
```
# Callback
## 1. Callback request body (CallbackRequest)
**Interface Overview**
The callback request body is used to receive the business data pushed back by the server.
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :---------------- | :---------- | :------------- | :----------------------------------------------------------------------------------------- |
| bizType | OpenBizType | M | Business type, specify the callback business type |
| data | bytes | M | Business binary data, the actual business content in the callback |
| clientFingerprint | string | M | Client certificate fingerprint, used to verify the client identity of the callback request |
| serverFingerprint | string | M | Server certificate fingerprint, used to verify the server identity of the callback request |
**OpenBizType Enumeration Description**
| **Enumeration Values** | **Description** |
| :-------------------------------- | :----------------------------------------- |
| \_BIZ\_TYPE\_UNKNOWN | Unknown business type |
| ORDER\_RESULT\_NOTIFICATION | Order result notification |
| WHITELIST\_RESULT\_NOTIFICATION | Whitelist result notification |
| EXCHANGE\_BIZ\_TYPE\_NOTIFICATION | Transaction business type notification |
| WALLET\_OPEN\_NOTIFICATION | Wallet account opening result notification |
**Request Example**
```json theme={null}
{
"bizType": "ORDER_RESULT_NOTIFICATION",
"data": "base64_encoded_data",
"clientFingerprint": "client_fingerprint_value",
"serverFingerprint": "server_fingerprint_value"
}
```
## 2. Callback data type
### 2.1 Order result notification
**Field Description**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :----------------------------------- |
| orderNo | string | Order Number |
| currency | string | Currency: USDT/USDC |
| network | string | Blockchain network: ETH/TRX/SOL/POLY |
| status | string | Order Status |
| amount | string | Amount |
| fromAddress | string | Initiator address |
| fromWallet | string | Source wallet |
| toAddress | string | Recipient Address |
| toWallet | string | Target wallet |
| txHash | string | Transaction Hash |
| orderType | string | Order Type |
| extOrderNo | string | External order number |
**Sample Data**
```json theme={null}
{
"orderNo": "ORDER123456789",
"currency": "USDT",
"network": "ETH",
"status": "SUCCESS",
"amount": "1.0",
"fromAddress": "0x123456789abcdef",
"toAddress": "0x987654321fedcba",
"fromWallet": "123456",
"toWallet": "1234567",
"txHash": "0x123456789abcdef123456789abcdef",
"orderType": "TRANSFER",
"extOrderNo": "EXT123456789"
}
```
### 2.2 Whitelist result notification
**Field Description**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :----------------------------------- |
| network | string | Blockchain network: ETH/TRX/SOL/POLY |
| address | string | address |
| businessType | int32 | Business Type: 1-deposit 2-withdraw |
| status | string | Status: true,false |
**Sample Data**
```json theme={null}
{
"network":"ETH",
"address": "0x123456789abcdef",
"businessType":1,
"status": "true"
}
```
### 2.3 Add Bank Account Result Notification
**Field Description**
| **Field Name** | **Type** | **Description** |
| :-------------------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| settlementAccountUID | int64 | Bank account unique id |
| walletId | int64 | Wallet ID |
| alias | string | Alias of bank account |
| accountOwnership | int32 | Ownership 1-own account 2-other account |
| currency | string | Fiat currency, eg: USD |
| accountType | int32 | Bank Account type 1-RD Wallet 2-Bank Account |
| accountName | string | Company name |
| accountNumber | string | RD Wallet Id or Bank account number |
| bankId | string | HK Bank Id,example:003 |
| beneficiaryAddress1 | string | Address (Line 1) of the receiving party(Chinese characters are not allowed) |
| beneficiaryAddress2 | string | Address (Line 2) of the receiving party(Chinese characters are not allowed) |
| beneficiaryAddress3 | string | Address (Line 3) of the receiving party Country / Region of address must be specified Please refer to the Country/Region ISO 3166 Code |
| beneficiarySwiftCode | string | Unique code to identify the receiving bank (The recipient bank only supports banks located in Hong Kong. If the 5th and 6th characters of the Swift Code are not 'HK' or 'HB', it does not meet the requirements.) |
| intermediarySwiftCode | string | Intermediate BankSwiftCode (The recipient bank only supports banks located in Hong Kong. If the 5th and 6th characters of the Swift Code are not 'HK' or 'HB', it does not meet the requirements.) |
| companyCode | string | Company profile code |
| status | int32 | Status 0-Processing 1-Success 2-Fail |
**Sample Data**
```json theme={null}
{
"settlementAccountUID":1236547995462114,
"walletId":4298832316123456,
"alias":"name alias",
"accountOwnership":2,
"currency":"USD",
"accountType":2,
"accountName":"narti adiddf",
"accountNumber":"8888888",
"bankId":"003",
"beneficiaryAddress1":"payee address1",
"beneficiaryAddress2":"payee address2",
"beneficiaryAddress3":"HK",
"beneficiarySwiftCode":"DHBKHKHHXXX",
"intermediarySwiftCode":"DHBKHKHHXXX",
"companyCode":"HK1239876654",
"status":0
}
```
### 2.4 Payout Result Notification
**Field Description**
| **Field Name** | **Type** | **Description** |
| :------------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| walletId | int64 | Wallet ID |
| quoteId | int64 | Inquiry ID |
| orderNo | string | Order Number |
| fromCurrency | string | From Currency: USDT,USDC |
| fromAmount | string | From Amount |
| toCurrency | string | To Currency: USD |
| toAmount | string | To Amount(Subtract Service fee ) |
| tradeFromAmount | string | Transaction amount |
| tradeToAmount | string | Transaction amount |
| price | string | Order price |
| tradePrice | string | Transaction price |
| orderStatus | string | See Appendix:Payout order status |
| createTime | int64 | Order creation time |
| finishTime | int64 | Order completion time |
| errorMsg | string | Order failure reason |
| settlementAccountUID | int64 | Settlement Account ID(Unique) |
| purpose | string | See Appendix: Purpose |
| paymentWay | string | Payment Method:RDT/CHATS |
| feeMode | int32 | Fee Deduction Mode: 1-Shared by both sender and receiver (SHAR) 2-Borne entirely by the payer (OUR) This field is required if accountType of settlementAccountUID is 2. |
| feeAmount | string | Service fee |
| feeCurrency | string | Fee Currency |
| refundOrderNo | string | Payout order status is SETTLING\_FAILED with value, used to re-settlement |
| extOrderNo | string | Unique Order ID provided by Business Entities |
**Sample Data**
```json theme={null}
{
"walletId":1000232233,
"quoteId":665131773713321985,
"orderNo":"442112731049984",
"fromCurrency":"USDT",
"fromAmount":"200.12",
"toCurrency":"USD",
"toAmount":"192.83",
"tradeFromAmount":"200.12",
"tradeToAmount":"192.83",
"price":"1.142",
"tradePrice":"1.142",
"orderStatus":"SUCCESSFUL",
"createTime":1741580889957,
"finishTime":1741580889957,
"settlementAccountUID":1236547995462114,
"purpose": "PMT001",
"paymentWay":"CHATS",
"feeMode":1,
"feeAmount":"7",
"feeCurrency":"USD",
"extOrderNo":"1234567898"
}
```
### 2.5 Payout Refund Result Notification
**Field Description**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :------------------ |
| walletId | int64 | Wallet ID |
| orderNo | string | Order Number |
| refundOrderNo | string | Refund Order Number |
| refundAmount | string | Refund Amount |
| refundCurrency | string | Refund Currency |
| refundReason | string | Refund Reason |
**Sample Data**
```json theme={null}
{
"walletId":123456789,
"orderNo":"442112731049984",
"refundOrderNo":"442112731049984D1",
"refundAmount":"664.26",
"refundCurrency":"USD",
"refundReason":"refund",
"refundTime":1741580889957
}
```
### 2.6 Payout Re-Settle Result Notification
**Field Description**
| **Field Name** | **Type** | **Description** |
| :------------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| walletId | int64 | Wallet ID |
| orderNo | string | Order Number |
| refundOrderNo | string | Refund Order Number |
| settlementAccountUID | int64 | Settlement Account ID(Unique) |
| purpose | string | See Appendix: Purpose |
| remark | string | remark |
| paymentWay | string | Payment Method:RDT/CHATS |
| feeMode | int32 | Fee Deduction Mode: 1-Shared by both sender and receiver (SHAR) 2-Borne entirely by the payer (OUR) This field is required if accountType of settlementAccountUID is 2. |
| amount | string | amount |
| currency | int64 | currency |
| feeAmount | string | Service fee |
| feeCurrency | string | Fee Currency |
**Sample Data**
```json theme={null}
{
"walletId":1000232233,
"orderNo":"442112731049984",
"refundOrderNo":"232112731049984",
"settlementAccountUID":1236547995462114,
"purpose": "PMT001",
"remark":"remark",
"paymentWay":"CHATS",
"feeMode":1,
"amount":"183",
"currency":"USD",
"feeAmount":"7",
"feeCurrency":"USD",
"createTime":1741580889957,
"finishTime":1741580889957,
"orderStatus":"SUCCESSFUL"
}
```
### **2.8 Enterprise Application Result Notification**
**Field Description**
| **Field Name** | **Type** | **Description** |
| :-------------------- | :------- | :------------------------------------------------------------------------- |
| applicationNo | string | RD application number |
| extApplicationNo | string | External application number |
| applicationCreateTime | int64 | Application creation time (milliseconds timestamp) |
| applicationStatus | string | Application status: IN\_PROGRESS, SUCCESS, FAIL |
| rejectReason | string | Rejection reason (if the application is rejected) |
| companyCode | string | Company code |
| businessType | int32 | Business type: 1 - Limited Company 2 - Partnership 3 - Sole Proprietorship |
| incorpPlace | string | Company registration place, e.g.: HKG |
| ciNumber | string | Company registration certificate number |
| brNumber | string | Business Registration Certificate number |
| incorpDate | string | Company registration date, format: yyyy-MM-dd |
| nameEn | string | Company English name |
| nameZh | string | Company local name (Chinese name) |
**Sample Data**
```json theme={null}
{
"applicationNo":"APP20250529001",
"extApplicationNo":"EXT12345678",
"applicationCreateTime":1685376000,
"applicationStatus":"SUCCESS",
"rejectReason":"",
"companyCode":"CMP123456",
"businessType":1,
"incorpPlace":"HKG",
"ciNumber":"autoHKL05290010",
"brNumber":"autoHKL05290010",
"incorpDate":"2025-05-29",
"nameEn":"RD Technology Limited",
"nameZh":"圆币科技有限公司"
}
```
# Appendix
## **Response Code**
| **Code** | **Description** |
| :------- | :--------------------------------------------------------------- |
| 1 | success |
| 6001 | failed General service failure |
| 6002 | parameter error |
| 6003 | order not exist (order does not exist) |
| 6004 | order duplicate (Duplicate order) |
| 6005 | no permissions |
| 6006 | assets not exists |
| 6101 | wallet account not exists |
| 6102 | wallet insufficient fund |
| 6103 | wallet status invalid (wallet account invalid) |
| 6104 | recipient wallet unavailable(Receiving wallet is not available) |
| 6105 | recipient wallet not exists(The receiving wallet does not exist) |
| 6109 | Daily payment limit exceeded |
| 6110 | Monthly collection limit exceeded |
| 6301 | provider unavailable (channel unavailable) |
| 6302 | symbol unavailable |
| 6303 | provider reject |
| 6304 | price expire time |
| 6305 | amount lt min amount (amount is less than the minimum limit) |
| 6306 | amount gt max amount (amount is greater than the maximum limit) |
| 6307 | outside of hours |
| 6401 | address already exists |
| 6406 | processing (the request is being processed) |
| 6801 | duplicate request |
| 6802 | profile error |
| 6803 | reach the max limit |
## Exchange order status
| **Code** | **Description** | **Remark** |
| :--------- | :--------------------- | :----------------------------------------------------------- |
| SUBMITTED | Submitted | Order Submitted |
| CONVERTING | Redemption | Order redemption |
| SETTLING | Settlement | The exchange is successful and the settlement is carried out |
| SUCCESSFUL | Successful transaction | Order processed successfully |
| FAILED | Transaction Failure | Order processing failed |
## Payout order status
| **Code** | **Description** | **Remark** |
| :--------------- | :--------------------- | :---------------------------------------------- |
| SUBMITTED | Submitted | Order Submitted |
| CONVERTING | Exchanging | Order exchanging |
| SETTLING | Settling | Exchange Successful, Proceeding with Settlement |
| SETTLING\_FAILED | Settlement Failed | Exchange Successful, Settlement Failed |
| SETTLING\_REFUND | Refund Processing | Refunded After Successful Settlement |
| SUCCESSFUL | Successful transaction | Order Processed Successfully |
| FAILED | Transaction Failure | Order Processed Failed |
## Deposit order status
| **Code** | **Description** | **Remark** |
| :---------------------- | :------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |
| SUBMITTED | Submitted | Order Submitted |
| VERIFYING | Order Verification | Upon order submission, a security verification is performed. Applies only to Request Payment. |
| AWAIT\_FOR\_RECEIVE | Awaiting Payment | The order was created successfully and is currently awaiting payment. This status applies specifically to the Request Payment flow. |
| PAYMENT\_VERIFYING | Payment Verification in Progress | Payment has been received by the platform. Initiating security verification. This step applies only to the Request Payment flow. |
| AWAIT\_FOR\_DECLARATION | Additional Documents Required | Trade documents pending submission. Applicable only to Request Payment transactions. |
| DECLARATION\_REVIEW | Document Review in Progress | Document Review in Progress |
| SUCCESS | Transaction Successful | Order Successful |
| FAILED | Transaction Failed | Order Failed |
| CLOSED | Transaction Closed | Order Closed Due to Expiration |
| RETURNING | Processing Refund | Processing Refund |
| RETURNED | Refunded | Refund Processed Successfully |
| IN\_PROGRESS | Payment Verification in Progress | Payment has been received by the platform. Initiating security verification. This step applies only to Deposit transactions. |
## Order Type
| **Code** | **Description** |
| :------- | :---------------- |
| 1 | Deposit |
| 2 | Wallet Transfer |
| 3 | Internal Transfer |
| 4 | Request Payment |
| 5 | Withdraw |
## **Field Description: amount**
This field is used to indicate the transaction amount. The type is string. The specific accuracy requirements are as follows:
* **Digital Currency** : Generally supports accuracy up to **6 decimal places** , which is used to meet the accuracy requirements of on-chain transactions;
* **Fiat Currency** : usually retains **up to 2 decimal places** , that is, accurate to "cents";
* **Japanese Yen (JPY)** : Since Japanese Yen is a currency without decimals, amount should be an integer and **no decimal part is allowed** .
Please strictly control the amount format according to the currency type to avoid precision errors or interface processing exceptions.
## Purpose
| **Code** | **Description** |
| :------- | :------------------------------------------------------------------------------------------------------ |
| PMT001 | Invoice payments |
| PMT002 | Payment for services |
| PMT003 | Payment for software |
| PMT004 | Payment for imported goods |
| PMT005 | Travel services |
| PMT006 | Transfer to own account |
| PMT007 | Repayment of loans |
| PMT009 | Payment of property rental |
| PMT010 | Information Service Charges |
| PMT011 | Advertising & Public relations-related expenses |
| PMT012 | Royalty fees, trademark fees, patent fees, and copyright fees |
| PMT013 | Fees for brokers, front end fee, commitment fee, guarantee fee and custodian fee |
| PMT014 | Fees for advisors, technical assistance, and academic knowledge, including remuneration for specialists |
| PMT015 | Representative office expenses |
| PMT016 | Tax Payment |
| PMT017 | Transportation fees for goods |
| PMT018 | Construction costs/expenses |
| PMT019 | Insurance Premium |
| PMT020 | General Goods Trades - Offline trade |
| PMT021 | Insurance Claims Payment |
| PMT024 | Medical Treatment |
| PMT025 | Donations |
| PMT026 | Mutual Fund Investment |
| PMT027 | Currency Exchange |
| PMT028 | Advance Payments for Goods |
| PMT029 | Merchant Settlement |
| PMT030 | Repatriation Fund Settlement |
## Country/Region Code
[Country/Region Code](/en/others-resources/country-code)
# Authentication & Signing
Source: https://docs.oristapay.com/en/isv/auth
# Authentication & Signing
Accessing OristaPay Open APIs requires **dual authentication**:
* **OAuth2 Access Token** — proves the caller's identity
* **HMAC Request Signature** — proves the request has not been tampered with
> Every request must pass both layers of verification. Failure of either results in `401 Unauthorized`.
## 1. Obtain Access Token
Standard OAuth2 `client_credentials` flow.
**Request**
```
POST /realms/digitalasset/protocol/openid-connect/token HTTP/1.1
Host: auth.uat.rdezlink.tech
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
&client_id={api_key}
&client_secret={api_secret}
```
**Response**
```json theme={null}
{
"access_token": "eyJhbGciOi...",
"token_type": "Bearer",
"expires_in": 300
}
```
**Usage Constraints**
* `access_token` can be reused within `expires_in` seconds. **Cache it** and refresh proactively 30 seconds before expiry.
* `access_token` must be issued by the OAuth client corresponding to `X-Api-Key`.
Using merchant A's `api_key` with merchant B's `access_token` will be rejected.
## 2. Request Signature Algorithm
**String to Sign**
```
string_to_sign = METHOD + PATH + TIMESTAMP + NONCE + SHA256_HEX(BODY)
```
**Signature Calculation**
```
signature = HEX( HMAC_SHA256( sign_secret, string_to_sign ) )
```
**Field Definitions**
| Element | Definition |
| ----------- | --------------------------------------------------------------------------------------------------- |
| `METHOD` | HTTP method, uppercase, e.g. `POST` |
| `PATH` | API path without domain and query, e.g. `/api/v1/wallet/list` |
| `TIMESTAMP` | 13-digit UTC millisecond timestamp string, must match `X-Timestamp` exactly |
| `NONCE` | Unique random string for this request, must match `X-Nonce` exactly. Recommended: 32 hex characters |
| `BODY` | Raw request body bytes; empty string when no body (`SHA256_HEX("")` = `e3b0c442...b855`) |
**Reference Implementations**
```python theme={null}
import hashlib
import hmac
def sign(method: str, path: str, ts: str, nonce: str,
body: str, sign_secret: str) -> str:
body_hash = hashlib.sha256(body.encode()).hexdigest()
to_sign = method + path + ts + nonce + body_hash
return hmac.new(sign_secret.encode(),
to_sign.encode(),
hashlib.sha256).hexdigest()
```
```java theme={null}
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.security.MessageDigest;
import java.util.HexFormat;
public static String sign(String method, String path, String ts,
String nonce, byte[] body, String signSecret)
throws Exception {
String bodyHash = HexFormat.of().formatHex(
MessageDigest.getInstance("SHA-256").digest(body));
String toSign = method + path + ts + nonce + bodyHash;
Mac mac = Mac.getInstance("HmacSHA256");
mac.init(new SecretKeySpec(signSecret.getBytes(), "HmacSHA256"));
return HexFormat.of().formatHex(mac.doFinal(toSign.getBytes()));
}
```
```javascript theme={null}
const crypto = require('crypto');
function sign(method, path, ts, nonce, body, signSecret) {
const bodyHash = crypto.createHash('sha256').update(body).digest('hex');
const toSign = method + path + ts + nonce + bodyHash;
return crypto.createHmac('sha256', signSecret)
.update(toSign).digest('hex');
}
```
## 3. Request Header Specification
All business requests must carry the following headers:
| Header | Required | Description |
| --------------- | -------- | -------------------------------------------------------------------------------------- |
| `Authorization` | ✓ | `Bearer {access_token}` |
| `X-Api-Key` | ✓ | Your `api_key` |
| `X-Timestamp` | ✓ | UTC millisecond timestamp, **±5 minutes** tolerance |
| `X-Nonce` | ✓ | Unique random string, **must not be reused within 5 minutes** under the same `api_key` |
| `X-Signature` | ✓ | Signature computed per §2 |
| `Content-Type` | ✓ | Always `application/json; charset=utf-8` |
# Request & Response Conventions
**Protocol Specification**
| Item | Specification |
| ------------ | ---------------------------------------------------------------------- |
| Transport | HTTPS (TLS 1.2+) |
| Method | `POST` |
| Charset | UTF-8 |
| Format | JSON |
| Field naming | `camelCase` |
| Timestamp | Milliseconds; string or number accepted in request, number in response |
## Response Envelope
All responses use a **single-layer** JSON `{ code, message, data? }`, returned by the downstream business service without additional gateway wrapping.
**Success (Business OK)**
Business code `code = 1`, business data in `data`:
```json theme={null}
{
"code": 1,
"message": "Success",
"data": { /* business data; array for list endpoints */ }
}
```
**Business / Downstream Error**
Downstream business errors still return HTTP `200`, with error details expressed by `code` / `message`:
```json theme={null}
{
"code": ,
"message": ""
}
```
When downstream gRPC is unreachable or times out, HTTP status remains `200`, `code` is a negative integer (negated gRPC StatusCode, e.g. `-14` for `UNAVAILABLE`), with connection error details in `message`.
**Gateway-Level Error**
Route not found, internal gateway errors, missing descriptors, etc. HTTP status uses the corresponding error code (e.g. `400` / `404` / `500` / `502`), with response body still using `{code, message}`:
```json theme={null}
{
"code": 404,
"message": "route not found"
}
```
* HTTP status reflects **transport layer** results: `2xx` means the request was successfully delivered and converted; non-`2xx` indicates a gateway-side error
* Business code `code` reflects **business layer** results: `1` means business success with result in `data`; other values are business error codes with reason in `message`
* **How to determine success**: HTTP `2xx` + business `code == 1`. Both conditions must be met
* **Authentication errors**: Any failure in `Authorization` / `X-Signature` / `X-Timestamp` / `X-Nonce` returns HTTP `401` with `{"code":401,"message":"Unauthorized"}`
# Error Handling
## HTTP Status Codes & Business Codes
All responses use the single-layer envelope `{code, message, data?}`. HTTP status reflects gateway/transport results; business code `code` reflects business processing results.
| HTTP Status | Meaning | Response Body | Action |
| ------------------- | ------------------------------------------ | ------------------------------------------------- | ------------------------------------------ |
| `200` + `code == 1` | Business success | `{code:1, message, data}` | Read business fields from `data` |
| `200` + `code != 1` | Downstream business error | `{code, message}` | Handle based on `message` |
| `200` + `code < 0` | gRPC error after delivery | `{code, message}` (`code` is negated gRPC status) | Check downstream, retry if needed |
| `400` | Invalid request body or parameters | `{code, message}` | Fix and retry |
| `401` | Authentication failed (OAuth or signature) | `{code:401, message}` | Follow the troubleshooting checklist below |
| `404` | Endpoint not found | `{code, message}` | Verify the path |
| `429` | Rate limit triggered | `{code, message, ...}` | Back off and retry |
| `5xx` | Gateway or downstream service error | `{code, message}` | Exponential backoff and retry |
## Authentication Failure Checklist
All authentication errors return:
```json theme={null}
{ "code": 401, "message": "Unauthorized" }
```
Troubleshoot in this order:
1. **Is the token valid?** — Has it expired? Was it issued by the current `api_key`?
2. **Does the signature match?** — Do `METHOD / PATH / BODY` match the actual request?
3. **Is the timestamp within the window?** — Is the local clock synchronized with NTP?
4. **Is the nonce unique?** — Must not be reused within 5 minutes under the same `api_key`.
# Rate Limiting
| Item | Value |
| ----------------- | ------------------------- |
| Dimension | Per `api_key` |
| Default quota | **600 requests / minute** |
| Exceeded response | HTTP `429` |
**Rate Limit Exceeded Response Example**
```json theme={null}
{
"code": 429,
"message": "rate limit exceeded",
"limit": 600,
"window_ms": 60000
}
```
> For higher quotas, contact your account manager. Adjustments take effect the following minute.
# Security Recommendations
| Topic | Best Practice |
| --------------------- | ----------------------------------------------------------------------------------------------------------- |
| Key management | Store `api_secret` and `sign_secret` server-side only. **Never expose them to frontend or mobile clients.** |
| Credential rotation | Rotate regularly; contact your account manager immediately if credentials are leaked |
| Transport security | Enforce HTTPS, reject any client not using TLS 1.2+ |
| Clock synchronization | Use NTP to maintain accuracy within ±1 minute to avoid false rejections |
| Log sanitization | Never log full `api_secret` / `sign_secret` / `access_token` in application logs |
# ISV Enablement Solution Overview
Source: https://docs.oristapay.com/en/isv/index
# 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
```mermaid theme={null}
sequenceDiagram
participant ISV as ISV (A)
participant RD as OristaPay
participant Merchant as Merchant (B)
ISV->>RD: 1. Submit merchant onboarding application (Onboarding API)
RD->>RD: Company search + compliance review
RD-->>ISV: Webhook: ready for IDV
ISV->>Merchant: 2. Forward IDV/signing link
Merchant->>RD: 3. Complete IDV + signing
RD-->>ISV: Webhook: approved + walletId
ISV->>RD: 4. Call transaction APIs on behalf of merchant
```
## API Documentation
| Document | Description |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| [**Authentication & Signing**](./auth) | OAuth2 token acquisition, HMAC signature algorithm, request headers, response envelope, error handling, rate limiting |
| [**ISV Onboarding API**](./onboarding-api) | Merchant onboarding application, IDV link, progress inquiry, company profile query, callback handling |
| [**ISV Transaction API**](./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 passing `walletId`. OristaPay automatically enforces authorization based on the ISV ↔ merchant relationship. See [Authentication & Signing](./auth) 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 |
# ISV Onboarding API
Source: https://docs.oristapay.com/en/isv/onboarding-api
# Overview
This API set is designed for **ISV (Independent Software Vendor)** customers: Party A initiates onboarding applications for its end customer (companies), and the OristaPay platform handles the full process including company search, compliance review, IDV, signing, and automatic wallet creation.
After completing onboarding, ISV customers receive `companyCode` and `walletId`, and can directly use the [ISV Transaction API](./transaction-api) to perform transfers, payment collection, Payout, and other transactions **on behalf of merchants**. **Transaction API fields remain unchanged** — Party A simply passes `walletId` as normal, and OristaPay automatically enforces authorization based on the ISV ↔ merchant relationship.
The authentication, signing, request headers, response envelope, file upload, and error code system of this API set are **fully consistent with the RDPAY API**. For details not repeated in this document, please refer to the [ISV Transaction API](./transaction-api).
## Business Flow
```mermaid theme={null}
sequenceDiagram
participant A as ISV (A)
participant Platform as OristaPay
participant B as Merchant (B)
rect rgb(242,247,250)
note over A,Platform: Submit Application
A->>+Platform: File Upload (FileUpload)
Platform-->>-A: fileKey
A->>+Platform: Submit Application (SubmitApplication)
Platform->>Platform: Validate profile
Platform-->>-A: Return applicationNo (sync)
end
rect rgb(235,245,255)
note over A,Platform: Background Async Review
Platform->>Platform: Company search
Platform->>+A: webhook ONBOARDING_APPLICATION_STATUS_NOTIFICATION (PENDING_USER)
A-->>-Platform: 200 OK
end
rect rgb(227,242,253)
note over A,B: IDV + Signing
A->>+Platform: Get IDV Link (GetIdvLink)
Platform-->>-A: linkUrl
A->>+B: Forward H5 link (email/SMS/QR)
B->>+Platform: Open H5 link, complete IDV → signing
Note over Platform,A: Success events do not push webhooks; Party A polls via QueryApplication
opt IDV failed (vendor failure / manual case failure)
Platform->>+A: webhook ONBOARDING_KEY_PEOPLE_IDV_FAILED
A-->>-Platform: 200 OK
end
end
rect rgb(220,237,200)
note over A,Platform: Final State
Platform->>Platform: All review nodes pass + auto-create wallet
Platform->>+A: webhook ONBOARDING_APPLICATION_STATUS_NOTIFICATION (APPROVED)
A-->>-Platform: 200 OK
A->>+Platform: Query Full Company Profile (QueryMainCompanyProfile)
Platform-->>-A: Company details + walletId
end
```
## Identifier Conventions
| Identifier | Generated By | Purpose |
| ------------------ | ----------------------------------- | ----------------------------------------------------------------------------------------------- |
| `extApplicationNo` | Party A | External application number, globally unique |
| `applicationNo` | OristaPay | OristaPay application number; primary key for queries and callback payloads |
| `companyCode` | OristaPay (generated on approval) | Company code; used for querying full profile and as company identity in subsequent transactions |
| `peopleId` | OristaPay (generated on submission) | keyPeople global ID; used for obtaining IDV/signing links |
| `walletId` | OristaPay (after wallet creation) | Wallet ID; used by subsequent transaction APIs |
# OnboardingAPI
## API Index
| # | Path | Purpose |
| - | --------------------------------------------- | ----------------------------------------------------------- |
| 1 | `POST /storage/media/dg-putObject?mediaType=` | 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 (**single link completes both IDV + signing**) |
| 5 | `POST /api/v1/onboarding/link/refresh` | Refresh link expiration |
| 6 | `POST /api/v1/onboarding/profile` | Query approved full company profile |
***
## 1. File Upload (fileUpload)
**Interface Overview**
Before submitting underlying customer information, you need to use this interface to upload files related to the company.
**Request Parameters**
| **Field Name** | **Type** | **M / O / CM** | **Description** |
| :------------- | :------- | :------------- | :----------------------------------- |
| mediaType | string | M | Enum: jpeg / jpg / png / pdf / gif |
| mediaFile | file | M | The uploaded file, not exceeding 20M |
**Response Parameters**
| **Field Name** | **Type** | **Description** |
| :------------- | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------- |
| code | int32 | Response code, indicating the result of request processing. For example, 1 indicates success, other values indicate different error situations. |
| message | string | Response message, providing detailed processing information or error explanation. |
| data | string | Returned when validation is successful, the returned data is the key of the file. |
**Response Example**
```json theme={null}
{
"code":1,
"message":"success",
"data":"123876789124.png"
}
```
## 2. Submit Application (SubmitApplication)
**Interface Overview**
Submit a company onboarding application for a downstream merchant (Party B). Use this endpoint for first-time submissions or resubmissions after a previous application was rejected (`REJECTED`).
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :--------------- | :---------- | :--------- | :------------------------------------------------------------------------------------ |
| extApplicationNo | string(128) | M | External application number generated by Party A, globally unique |
| profile | Object | M | Company profile form. See [Company Profile Form](#company-profile-form) for structure |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :-------------- | :------------------------------------------------------------------------------------- |
| code | int32 | Response code: `1` indicates success; other values indicate different error conditions |
| message | string | Response message |
| data | ApplicationData | Returned when application is accepted successfully |
| errors | Array\ | Returned when profile validation fails (`code = 6802`) |
**ApplicationData Field Description**
| Field Name | Type | Description |
| :-------------------- | :----- | :-------------------------------------------------------------------------------------- |
| applicationNo | string | OristaPay application number; a new number is generated on resubmission after rejection |
| applicationCreateTime | int64 | Application creation time, millisecond timestamp |
**Errors Field Description**
| Field Name | Type | Description |
| :--------- | :----- | :------------------------------------------------------------------------- |
| message | string | See [Profile Error Descriptions](#3-profile-error-descriptions-code--6802) |
**Request Example**
```json theme={null}
{
"extApplicationNo": "EXT20260512001",
"profile": {
"entityDetail": { "businessType": 1, "incorpPlace": "HKG" },
"businessDetail": { "list": [{ "subIndustryCode": "I300734" }] },
"shareholder": { "list": [{ "shareholderId": 1 }] },
"keyPeople": { "quorum": 2, "directorNum": 2, "people": [] },
"accountOpeningQuestionnaire": {
"accountOpeningPurposes": ["PAYMENT_FOR_HK_BUSINESS"],
"expectedMonthlyVolume": "FROM_2_5M_TO_5M_HKD",
"handleClientMoney": false
}
}
}
```
**Response Example (Success)**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": {
"applicationNo": "A202605258664",
"applicationCreateTime": 1747094400000
}
}
```
**Response Example (Profile Validation Failed)**
```json theme={null}
{
"code": 6802,
"message": "Profile validation failed.",
"errors": [
{ "message": "[Business details]Industry code cannot be empty!" },
{ "message": "[Entity details]Please upload a valid proof of Business Registration" }
]
}
```
**Key Constraints**
* **Idempotency key `(extApplicationNo)`**: Repeated submissions with the same `extApplicationNo` and same body → returns the original `applicationNo`; different body → `6801`
* **Merchant concurrency guard**: Only one **active** application is allowed per Party B `(CI number / BR number)` under the same Party A. A new application can only be submitted after the current one reaches a final state (`APPROVED` / `REJECTED`)
* **Resubmission after rejection**: Must use a **new** `extApplicationNo`; a new `applicationNo` is generated on submission
* **Company search failure = automatic rejection**: In the API path, whether it's a **company search classification failure** (CI/BR not found, etc.) or a **search comparison mismatch** (data inconsistency), the application is directly set to `REJECTED` and a `REJECTED` webhook is pushed. Party A must use a new `extApplicationNo` to resubmit
## 3. Query Application (QueryApplication)
**Interface Overview**
Query application progress by `applicationNo` or `extApplicationNo` (choose one).
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :--------------- | :----- | :--------- | :--------------------------- |
| applicationNo | string | CM | OristaPay application number |
| extApplicationNo | string | CM | Party A application number |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :------------------- | :----------------------- |
| code | int32 | Response code |
| message | string | Response message |
| data | QueryApplicationData | Returned when `code = 1` |
**QueryApplicationData Field Description**
| Field Name | Type | Description |
| :-------------------- | :----- | :----------------------------------------------------------------------- |
| applicationNo | string | OristaPay application number |
| extApplicationNo | string | Party A application number |
| applicationCreateTime | int64 | Application creation time, millisecond timestamp |
| applicationStatus | string | Review status: `UNDER_REVIEW` / `PENDING_USER` / `APPROVED` / `REJECTED` |
| companyCode | string | Company code (returned after approval) |
| walletId | int64 | Wallet ID (returned after wallet creation) |
| profile | Object | Company profile form. See [Company Profile Form](#company-profile-form) |
**`applicationStatus` values**:
* `UNDER_REVIEW`: Under acceptance or review (covers all non-final, non-pending-user stages including company search, manual review, etc.)
* `PENDING_USER`: Company search passed; waiting for keyPeople to complete IDV/signing. **Only now (and only now)** can `GetIdvLink` be called; calling earlier returns `6406`
* `APPROVED`: Approved, wallet created. Use `companyCode` / `walletId` for subsequent business
* `REJECTED`: Application rejected; cannot be recovered in the API scenario. Resubmit with a new `extApplicationNo`
The `applicationStatus` semantics are consistent between query and webhook. If Party A misses the `PENDING_USER` webhook due to a network issue, the same status can be obtained by actively calling the query API.
> Each `KeyPeopleInfo` in `profile.keyPeople.people[]` includes `peopleId` (for obtaining IDV/signing links), and two status fields `idvStatus` / `mandateStatus` (reflecting the person's real-time IDV/signing progress).
**Request Example**
```json theme={null}
{
"applicationNo": "A202605258664"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": {
"applicationNo": "A202605258664",
"extApplicationNo": "EXT20260512001",
"applicationCreateTime": 1747094400000,
"applicationStatus": "PENDING_USER",
"companyCode": "",
"walletId": 0,
"profile": {
"entityDetail": { "...": "..." },
"keyPeople": {
"people": [
{
"peopleId": 1000123456,
"lastNameEn": "Lo",
"firstNameEn": "Sang",
"idvStatus": "UNDER_REVIEW",
"mandateStatus": "NOT_STARTED",
"isDirector": true,
"isUbo": false
}
]
}
}
}
}
```
## 4. Get IDV Link (GetIdvLink)
**Interface Overview**
Generate a one-time H5 link for the specified `peopleId`. **A single link completes both IDV → signing**: Party B user opens the link, completes IDV first, and the page automatically proceeds to signing after IDV passes. For individuals with `isMandateUser = false`, only IDV is required; the flow ends when IDV completes.
Party A is responsible for delivering the link to Party B users (via email / SMS / QR code scan / redirect, at Party A's discretion).
**Precondition**: You must first receive the `ONBOARDING_APPLICATION_STATUS_NOTIFICATION` webhook with `applicationStatus = PENDING_USER` before calling this endpoint. Before this, the backend is in the company search phase; calling will return `6406` with a message to wait for the `PENDING_USER` webhook.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :------------ | :----- | :--------- | :------------------------------------------------------------------------------------- |
| applicationNo | string | M | OristaPay application number |
| peopleId | int64 | M | Obtained from `profile.keyPeople.people[].peopleId` in the `QueryApplication` response |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :------- | :----------------------- |
| code | int32 | Response code |
| message | string | Response message |
| data | LinkData | Returned when `code = 1` |
**LinkData Field Description**
| Field Name | Type | Description |
| :--------- | :----- | :----------------------------------------------------------------------- |
| linkUrl | string | One-time H5 link; users complete IDV followed by signing after accessing |
| expireTime | int64 | Link expiration time, millisecond timestamp; default **24 hours** |
**Request Example**
```json theme={null}
{
"applicationNo": "A202605258664",
"peopleId": 1000123456
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": {
"linkUrl": "https://customer.oristapay.com/h5/index?code=4e0af338-9605-4353-86db-f35c4fdb7959",
"expireTime": 1747180800000
}
}
```
**Key Constraints**
* IDV Links are **single-use**: they expire after Party B completes the full flow (IDV + signing); unused links also expire after the timeout
* Repeated calls for the same `peopleId`: **unexpired link exists** → returns the original link; **expired** → automatically invalidates the original link and generates a new one
* Returns `6001` if the person has already completed all tasks (IDV passed, and if `isMandateUser=true`, signing also completed)
## 5. Refresh Link (RefreshIdvLink)
**Interface Overview**
When the link has expired (`expireTime < now`) or is about to expire, Party A calls this endpoint to generate a new link; the original link is immediately invalidated.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :------------ | :----- | :--------- | :--------------------------- |
| applicationNo | string | M | OristaPay application number |
| peopleId | int64 | M | keyPeople global ID |
**Response Parameters**
`LinkData`: Fields are the same as §4.
**Request Example**
```json theme={null}
{
"applicationNo": "A202605258664",
"peopleId": 1000123456
}
```
**Response Example**
Same as §4.
**Key Constraints**
* Same precondition as §4: must first receive the `PENDING_USER` webhook; otherwise returns `6406`
* The original link is immediately invalidated after this call
* Returns `6001` if the person has already completed all tasks (IDV passed and signing completed)
* Returns `6001` if the application has been in final status (`APPROVED` / `REJECTED`)
## 6. Query Company Profile (QueryCompanyProfile)
**Interface Overview**
Query the full company profile after approval by `companyCode`.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :---------- | :----- | :--------- | :------------------------------------------------------------------------ |
| companyCode | string | M | Company code (obtained from `QueryApplication` or Webhook after approval) |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :------------- | :------------------------------------------------------------------------------------ |
| code | int32 | Response code |
| message | string | Response message |
| data | ProfileFormDto | Full company profile. See [Company Profile Form](#company-profile-form) for structure |
**Request Example**
```json theme={null}
{
"companyCode": "HKM12389h"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": {
"entityDetail": { "...": "..." },
"businessDetail": { "...": "..." },
"shareholder": { "...": "..." },
"keyPeople": { "...": "..." }
}
}
```
**Key Constraints**
* Only companies with approved status (`applicationStatus = APPROVED`) can be queried; unapproved companies return `6001` + message "Profile is not approved yet."
* `companyCode` must belong to the current Party A; otherwise returns `6005`
* The data reflects the latest OristaPay review result, which may differ from the submitted `profile` (reviewers may supplement or correct certain fields)
# Callback
The callback request body, signature verification, and response requirements are fully consistent with the [ISV Transaction API · Callback](./transaction-api#callback). This document only defines the new `OpenBizType` values and payload fields.
## 1. New OpenBizType Enums
| Enum Value | Trigger |
| :-------------------------------------------- | :---------------------------------------------------------------- |
| ONBOARDING\_APPLICATION\_STATUS\_NOTIFICATION | Application status change (PENDING\_USER / APPROVED / REJECTED) |
| ONBOARDING\_KEY\_PEOPLE\_IDV\_FAILED | A key person's IDV failed (vendor failure or manual case failure) |
## 2. Callback Data Types
### 2.1 Application Status Change (OnboardingApplicationStatusNotification)
**Trigger Timing (only key review nodes; individual node changes are not pushed)**
| applicationStatus | Trigger Timing | Party A Action |
| :---------------- | :---------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PENDING_USER` | Company search passed → keyPeople IDV/signing can begin | Only now (and only now) can `GetIdvLink` be called (calling earlier returns `6406`) |
| `APPROVED` | Application fully approved, wallet created | Retrieve `companyCode` / `walletId` for subsequent business |
| `REJECTED` | Application rejected in final state (includes company search failure, compliance failure, etc.) | Rejected applications **cannot be recovered** in the API scenario. Party A must submit a new application (do not reuse the original `extApplicationNo`, or the idempotency check will return the old record) |
* Newly submitted applications (first entering `UNDER_REVIEW` status) do not trigger a separate webhook. Party A knows the application is accepted through the synchronous `SubmitApplication` response
* Node-level changes (`NameScreening → RiskScreening`, etc.) are **no longer pushed**; only available through the `QueryApplication` API
* Duplicate pushes of the same `applicationStatus` should be treated idempotently (deduplicated by `X-Nonce`)
**Field Description**
| Field Name | Type | Description |
| :---------------- | :----- | :---------------------------------------------------------------------- |
| applicationNo | string | OristaPay application number |
| extApplicationNo | string | Party A application number |
| applicationStatus | string | `PENDING_USER` / `APPROVED` / `REJECTED` |
| companyCode | string | Company code (populated on `APPROVED`; empty string for other statuses) |
| walletId | int64 | Wallet ID (populated after wallet creation; `0` for other statuses) |
| eventTime | int64 | Event trigger time, millisecond timestamp |
**Example (Company Search Passed, IDV Can Begin)**
```json theme={null}
{
"applicationNo": "A202605258664",
"extApplicationNo": "EXT20260512001",
"applicationStatus": "PENDING_USER",
"companyCode": "",
"walletId": 0,
"eventTime": 1747094400000
}
```
**Example (Approved)**
```json theme={null}
{
"applicationNo": "A202605258664",
"extApplicationNo": "EXT20260512001",
"applicationStatus": "APPROVED",
"companyCode": "HKM12389h",
"walletId": 12345678901234,
"eventTime": 1747104400000
}
```
**Example (Rejected / Company Search Failed)**
```json theme={null}
{
"applicationNo": "A202605258664",
"extApplicationNo": "EXT20260512001",
"applicationStatus": "REJECTED",
"companyCode": "",
"walletId": 0,
"eventTime": 1747094500000
}
```
### 2.2 keyPeople IDV Failure (OnboardingKeyPeopleIdvFailedNotification)
Pushed when a key person's IDV fails. Upon receiving this, Party A can have Party B retry IDV: call `RefreshIdvLink` to get a new link for Party B.
**Trigger**
* IDV failure
**Field Description**
| Field Name | Type | Description |
| :--------------- | :----- | :---------------------------------------------------------- |
| applicationNo | string | OristaPay application number |
| extApplicationNo | string | Party A application number |
| peopleId | string | keyPeople global ID (as string, preserving int64 precision) |
| eventTime | int64 | Event trigger time, millisecond timestamp |
**Example**
```json theme={null}
{
"applicationNo": "A202605258664",
"extApplicationNo": "EXT20260512001",
"peopleId": "1000123456",
"eventTime": 1747100100000
}
```
# Company Profile Form
`profile` is the core payload for submitting an onboarding application (`SubmitApplication`), and also the core data returned by query APIs. The structure varies by **business type** (partnership / limited company / sole proprietorship) and **place of incorporation**.
## 1. Top-Level Structure
```text theme={null}
profile = {
entityDetail, // Basic entity info (required)
businessDetail, // Business info (required)
shareholder, // Shareholder info (required for limited companies only)
keyPeople, // Key people (required, includes IDV/signing subjects)
accountOpeningQuestionnaire // Account opening questionnaire (required)
}
```
## 2. Support Matrix
| Incorporation \ Business Type | Limited Company | Partnership | Sole Proprietorship |
| :------------------------------- | :-------------- | :---------- | :------------------ |
| Hong Kong (`HKG`) | ✓ | ✓ | ✓ |
| Other (non-HKG, and **non-CHN**) | ✓ | ✗ | ✗ |
## 3. Common Sub-structures
### 3.1 businessDetail.list\[] Element
| Field | Type | M / O / CM | Description |
| :---------------- | :---------------- | :--------- | :------------------------------------------------------------------------------------------------------------------------------------------- |
| subIndustryCode | string(10) | M | Sub-industry itemId, **must exist in the OristaPay foundation industry dictionary**. See [Industry Code](/cn/others-resources/industry-code) |
| yearsInBusiness | string | M | String form of the code. See [Years in Business](#) appendix |
| businessLocations | Array\(3) | M | Business location list, max 3. See [Country/Region Code](/cn/others-resources/country-code) |
| lastYearSales | string | M | String form of the code. See [Last Year Sales](#) appendix |
| industryDetails | string(256) | M | Industry supplementary description |
> Party A only needs to pass `subIndustryCode`. The primary `industryCode` is auto-populated by the server via dictionary lookup; any value passed by Party A will be overwritten.
### 3.2 KeyPeopleInfo Common Fields
All business types use `KeyPeopleInfo` for `keyPeople.people[]`. Common submission fields:
| Field | Type | M / O / CM | Description |
| :---------------------------- | :------------- | :--------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| lastNameEn | string(128) | CM | Either Chinese or English name required |
| firstNameEn | string(128) | CM | Either Chinese or English name required |
| nameZh | string(128) | CM | Either Chinese or English name required |
| areaCode | string(8) | O | Phone area code |
| mobileNumber | string(32) | O | Mobile number |
| email | string(128) | O | Email address |
| gender | int32 | M | `1` Male / `2` Female |
| birthdate | string | M | Date of birth, `YYYY-MM-DD` |
| region | string | M | Country/region of ID document. See [Country/Region Code](/cn/others-resources/country-code) |
| idType | int32 | M | `1` Mainland China ID / `2` Hong Kong ID / `3` Passport |
| idNumber | string | M | ID document number |
| isMandateUser | boolean | M | Whether this person is a signatory. **The count of `isMandateUser=true` in keyPeople must be ≥ `keyPeople.quorum`** (minimum quorum). Typically some or all directors |
| ownedSharesPercent | double(6,3) | CM | Shareholding percentage (0\~100, 3 decimal places). **Required only when `isUbo=true`** |
| isWalletAdmin | boolean | M | Whether this person is a wallet admin. **Exactly one person in keyPeople must have `isWalletAdmin=true`**; this person is automatically set as the company wallet super admin |
| overseaWorkCertificateFileKey | Array\ | CM | Overseas work certificate fileKey list. **Required only when `isWalletAdmin=true` and `region=CHN`** (Mainland China resident); max 5 |
**Two typical wallet admin configurations**:
1. **Combined role**: A director / UBO also checks `isWalletAdmin=true` (one person, two roles)
2. **Separate role**: Add a **wallet-admin-only** person to the `keyPeople` list (set `isDirector` / `isUbo` / `isPartner` / `isOwner` all to `false`, only `isWalletAdmin=true`). This person must go through IDV
> The "Mainland China ID Card" in `idType` is a **personal document** enum, distinct from "place of incorporation". When the incorporation place is HKG but a director/shareholder is a Mainland China resident, this `idType` is used normally.
### 3.3 Runtime Fields Written Back by OristaPay
Party A must **NOT populate** these fields on submission; they carry write-back results from OristaPay when read via `QueryApplication`.
| Field | Type | Description |
| :------------ | :----- | :----------------------------------------------------------------------------------------------------------------------- |
| peopleId | int64 | OristaPay-generated global person ID; must be passed when obtaining IDV/signing links |
| idvStatus | string | IDV progress: `NOT_STARTED` / `UNDER_REVIEW` vendor passed + manual review / `COMPLETED` manual passed / `FAILED` |
| mandateStatus | string | Signing status (meaningful only when `isMandateUser = true`): `NOT_STARTED` / `SIGNED`; empty string for non-signatories |
### 3.4 Account Opening Questionnaire
All business types must include this module in `profile`.
\| Field | Type | M / O / CM | Description | | | :-- |:--------------| :-- |:---------------------------------------------------------------------------------------------------------------------------| | accountOpeningPurposes | Array\ | M | Account opening purposes, select 1-2: `PAYMENT_FOR_HK_BUSINESS` / `STORE_DIGITAL_ASSETS_FOR_HK_BUSINESS` | | expectedCounterparties | string(256) | O | Expected business counterparties (free text) | | expectedMonthlyVolume | enum | M | Expected monthly volume (HKD), single choice: `BELOW_1M_HKD` / `FROM_1M_TO_2_5M_HKD` / `FROM_2_5M_TO_5M_HKD` / `FROM_5M_TO_10M_HKD` / `ABOVE_10M_HKD` | | handleClientMoney | string | M | Whether client money is handled (YES/NO) |
**Example**
```json theme={null}
"accountOpeningQuestionnaire": {
"accountOpeningPurposes": ["PAYMENT_FOR_HK_BUSINESS", "STORE_DIGITAL_ASSETS_FOR_HK_BUSINESS"],
"expectedCounterparties": "Major HK retail merchants",
"expectedMonthlyVolume": "FROM_2_5M_TO_5M_HKD",
"handleClientMoney": "NO"
}
```
## 4. Partnership Company (Hong Kong only)
**entityDetail**
| Field | Type | M / O / CM | Description |
| :--------------- | :------------- | :--------- | :----------------------------------------------------------------------------- |
| businessType | int32 | M | `2` Partnership |
| incorpPlace | string | M | Place of incorporation, only `HKG` supported |
| brNumber | string(32) | M | Business Registration certificate number |
| brFileKey | string(128) | M | Business Registration file fileKey |
| incorpDate | string | M | Date of incorporation, `YYYY-MM-DD` |
| website | string(512) | O | Website URL |
| regPlace | string | M | Registered place. See [Country/Region Code](/cn/others-resources/country-code) |
| regAddress | string(256) | M | Registered address, English / numbers / spaces only |
| operatingPlace | string | M | Operating place |
| operatingAddress | string(256) | M | Operating address |
| nameEn | string(128) | M | Company name in English |
| nameZh | string(128) | O | Company name in Chinese |
| paFileKey | Array\ | M | Partnership Agreement files, max 5 |
**keyPeople**: 2-6 partners. `KeyPeopleInfo` adds the following on top of common fields:
| Field | Type | M / O / CM | Description |
| :-------- | :--- | :--------- | :---------------------------------------------- |
| isPartner | bool | M | Whether this person is a partner, always `true` |
**Submission Example**
```json theme={null}
{
"entityDetail": {
"businessType": 2,
"incorpPlace": "HKG",
"brNumber": "br-number-partner",
"incorpDate": "2025-05-01",
"website": "www.example.com",
"regPlace": "HKG",
"regAddress": "Example partner register address",
"operatingPlace": "HKG",
"operatingAddress": "Example partner operating address",
"nameEn": "Example Partnership",
"nameZh": "示例合伙公司",
"brFileKey": "4e0af338-9605-4353-86db-f35c4fdb7959.jpg",
"paFileKey": ["06993a52-3069-41c9-a048-1601a3dfade4.jpg"]
},
"businessDetail": {
"list": [
{
"subIndustryCode": "I300734",
"yearsInBusiness": "1",
"businessLocations": ["HKG"],
"lastYearSales": "1",
"industryDetails": "Digital asset platform"
}
]
},
"keyPeople": {
"quorum": 2,
"directorNum": 0,
"people": [
{
"lastNameEn": "Lo",
"firstNameEn": "Sang",
"nameZh": "罗生",
"areaCode": "852",
"mobileNumber": "61234567",
"email": "lo@example.com",
"isPartner": true,
"isMandateUser": true,
"isWalletAdmin": true
},
{
"lastNameEn": "Yeung",
"firstNameEn": "Sang",
"nameZh": "杨生",
"areaCode": "852",
"mobileNumber": "61234568",
"email": "yeung@example.com",
"isPartner": true,
"isMandateUser": true,
"isWalletAdmin": false
}
]
},
"accountOpeningQuestionnaire": {
"accountOpeningPurposes": ["PAYMENT_FOR_HK_BUSINESS"],
"expectedMonthlyVolume": "FROM_2_5M_TO_5M_HKD",
"handleClientMoney": false
}
}
```
## 5. Limited Company (Hong Kong)
**entityDetail**
| Field | Type | M / O / CM | Description |
| :---------------------- | :------------- | :--------- | :-------------------------------------------------- |
| businessType | int32 | M | `1` Limited Company |
| incorpPlace | string | M | Place of incorporation, `HKG` |
| ciNumber | string(32) | M | Certificate of Incorporation number |
| ciFileKey | string(128) | M | Certificate of Incorporation file |
| brNumber | string(32) | M | Business Registration certificate number |
| brFileKey | string(128) | M | Business Registration file |
| incorpDate | string | M | Date of incorporation, `YYYY-MM-DD` |
| website | string(512) | O | Website URL |
| regPlace | string | M | Registered place of company |
| regAddress | string(256) | M | Registered address of company |
| operatingPlace | string | M | Operating place |
| operatingAddress | string(256) | M | Operating address |
| nameEn | string(128) | M | Company name in English |
| nameZh | string(128) | O | Company name in Chinese |
| isFinancialInstitute | int32 | M | `1` Regulated / `2` Non-regulated |
| financialRegulatorPlace | string | CM | Required if regulated |
| financialRegulator | string(256) | CM | Required if regulated |
| financialLicenseType | string(128) | CM | Required if regulated |
| regulatedProofKey | Array\ | CM | Regulatory proof documents, max 5 |
| isListed | int32 | M | `1` Listed / `2` Non-listed |
| listingPlace | string(3) | CM | Required if listed |
| listingExchange | string(256) | CM | Required if listed |
| stockCode | string(128) | CM | Required if listed |
| isGovOwned | int32 | M | `1` Government-owned / `2` Non-government-owned |
| ownedGovPlace | string(3) | CM | Required if government-owned |
| maFileKey | Array\ | M | Memorandum and Articles of Association files, max 5 |
**shareholder** (choose either `list` or `shareholderFileKey`)
| Field | Type | M / O / CM | Description |
| :----------------- | :--------------------- | :--------- | :-------------------------------------------------------------------------------- |
| list | Array\ | Either | Structured shareholder list |
| shareholderFileKey | Array\ | Either | Shareholding structure diagram fileKey list; passing this does not require `list` |
> Shareholder structure is required only for "Limited Company" when `isFinancialInstitute=2` / `isListed=2` / `isGovOwned=2` (i.e., none are exempted).
**ShareholderDto**
| Field | Type | M / O / CM | Description |
| :----------------- | :---------- | :--------- | :------------------------------------------------------------------------------------------------------------------------------------------- |
| shareholderId | int64 | M | Unique shareholder identifier, generated by the requester |
| sameId | int64 | O | Marks "same shareholder appearing multiple times in structure"; default `0` |
| parentId | int64 | O | Parent `shareholderId`; use `0` for the first layer |
| shareholderType | int32 | M | `1` Individual shareholder / `2` Corporate shareholder |
| businessType | int32 | CM | Corporate shareholder business type; required when `shareholderType=2` |
| incorpPlace | string | CM | Corporate shareholder place of incorporation. For partnership/sole proprietorship shareholders, only `HKG` supported; **`CHN` not accepted** |
| ownedSharesPercent | double(6,3) | M | Shareholding percentage of parent |
| companyNameEn | string(128) | CM | Corporate shareholder name in English (either Chinese or English name required) |
| companyNameZh | string(128) | CM | Corporate shareholder name in Chinese (either Chinese or English name required) |
| firstNameEn | string(128) | CM | Individual shareholder first name in English (either Chinese or English name required) |
| lastNameEn | string(128) | CM | Individual shareholder last name in English (either Chinese or English name required) |
| nameZh | string(128) | CM | Individual shareholder name in Chinese (either Chinese or English name required) |
**keyPeople**
| Field | Type | M / O / CM | Description |
| :---------- | :-------------------- | :--------- | :-------------------------------------------------------------------- |
| quorum | int32 | M | Minimum quorum, 1-99 |
| directorNum | int32 | M | Number of directors (must equal the count of `isDirector=true`), 1-99 |
| people | Array\ | M | List all UBOs and directors of the company |
`KeyPeopleInfo` adds the following on top of common fields:
| Field | Type | M / O / CM | Description |
| :--------- | :------ | :--------- | :-------------------------------------------------------- |
| isDirector | boolean | M | Whether this person is a director |
| isUbo | boolean | M | Whether this person is an Ultimate Beneficial Owner (UBO) |
## 6. Limited Company (Non-Hong Kong)
Most fields are identical to §5. Differences are listed below (unlisted fields match §5):
| Field | Type | M / O / CM | Description |
| :---------- | :------------- | :--------- | :----------------------------------------------------------------------------------------------------- |
| incorpPlace | string | M | Non-`HKG` country/region code; **`CHN` not accepted** |
| brNumber | string(32) | O | Business Registration certificate number (optional for non-HK regions) |
| brFileKey | string(128) | O | Business Registration file (optional for non-HK regions) |
| coiFileKey | Array\ | CM | Certificate of Incumbency. Required when `incorpPlace` is `BMU` / `WSM` / `SYC` / `CYM` / `VGB`, max 5 |
## 7. Sole Proprietorship Company (Hong Kong only)
**entityDetail**
| Field | Type | M / O / CM | Description |
| :------------------- | :---------- | :--------- | :--------------------------------------- |
| businessType | int32 | M | `3` Sole Proprietorship |
| incorpPlace | string | M | Only `HKG` supported |
| brNumber | string(32) | M | Business Registration certificate number |
| brFileKey | string(128) | M | Business Registration file |
| incorpDate | string | M | Date of incorporation, `YYYY-MM-DD` |
| website | string(512) | O | Website URL |
| regPlace | string | M | Registered place |
| regAddress | string(256) | M | Registered address |
| operatingPlace | string | M | Operating place |
| operatingAddress | string(256) | M | Operating address |
| nameEn | string(128) | M | Company name in English |
| nameZh | string(128) | O | Company name in Chinese |
| isFinancialInstitute | int32 | O | `1` Regulated / `2` Non-regulated |
**keyPeople**: Exactly one owner. `KeyPeopleInfo` adds the following on top of common fields:
| Field | Type | M / O / CM | Description |
| :------ | :------ | :--------- | :----------------------------------------------------------------- |
| isOwner | boolean | M | Whether this person is the sole proprietorship owner (exactly one) |
## 8. File Key Field Summary
Upload files via the file upload endpoint to obtain `fileKey`, then fill them into `profile`.
| Profile Field | File Description | Type |
| :--------------------------------------------------- | :-------------------------------------------------------- | :----------------- |
| entityDetail.brFileKey | Business Registration | string |
| entityDetail.ciFileKey | Certificate of Incorporation | string |
| entityDetail.maFileKey\[] | Memorandum & Articles of Association (M\&A) | Array\ ≤ 5 |
| entityDetail.paFileKey\[] | Partnership Agreement | Array\ ≤ 5 |
| entityDetail.kycFileKey\[] | KYC Proof | Array\ ≤ 5 |
| entityDetail.regulatedProofKey\[] | Regulated Financial Institution Proof | Array\ ≤ 5 |
| entityDetail.coiFileKey\[] | Certificate of Incumbency | Array\ ≤ 5 |
| keyPeople.people\[].idFileKey\[] | Personal ID photo | Array\ ≤ 5 |
| keyPeople.people\[].overseaWorkCertificateFileKey\[] | Overseas work certificate (required for CHN wallet admin) | Array\ ≤ 5 |
File types and limits: `jpeg / jpg / png / pdf / gif`, max 20 MB per file.
# Error Codes
## 1. Business Error Codes
| code | Meaning | Typical ISV Onboarding Trigger |
| :----- | :------------------------ | :----------------------------------------------------------------------------------------------------------------------------- |
| `1` | Success | — |
| `6001` | General business failure | Unclassified business error |
| `6002` | Parameter error | Missing required fields or type mismatch |
| `6003` | Order not found | `applicationNo` / `extApplicationNo` not found; `peopleId` not found |
| `6005` | No permission | Party A has not enabled ISV onboarding; or Party A queries another party's `applicationNo` |
| `6406` | Request being processed | Company search not yet passed; wait for `PENDING_USER` webhook before calling `GetIdvLink` / `RefreshIdvLink` |
| `6801` | Duplicate application | Same `extApplicationNo` with different body; or same Party B (CI/BR number) already has an active application |
| `6802` | Profile error | `profile` validation failed, with `errors[]` list (see [Profile Error Descriptions](#3-profile-error-descriptions-code--6802)) |
| `6803` | Application limit reached | Party A has exceeded the account opening quota for the current period (if applicable) |
## 2. Per-Endpoint Error Code Reference
### 2.1 SubmitApplication
| Scenario | Response |
| :--------------------------------------------------------- | :--------------------------------------------------------- |
| Submission successful | `code = 1` + `data.applicationNo` |
| Missing required fields / type error | `code = 6002` |
| Party A has not enabled ISV onboarding | `code = 6005` |
| Same `extApplicationNo`, same body | `code = 1` + returns original `applicationNo` (idempotent) |
| Same `extApplicationNo`, different body | `code = 6801` |
| Same Party B (CI/BR number) already has active application | `code = 6801` |
| `profile` validation failed | `code = 6802` + `errors[]` |
### 2.2 QueryApplication
| Scenario | Response |
| :------------------------------------------------------ | :------------------ |
| Query successful | `code = 1` + `data` |
| Neither `applicationNo` nor `extApplicationNo` provided | `code = 6002` |
| Application not found | `code = 6003` |
| Application does not belong to current Party A | `code = 6005` |
### 2.3 GetIdvLink
| Scenario | Response |
| :------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------- |
| Successful | `code = 1` + `data.linkUrl` + `expireTime` |
| `applicationNo` not found / not owned by current Party A | `code = 6003` / `6005` |
| `peopleId` not found / not belonging to this application | `code = 6003` |
| All tasks for this person already completed | `code = 6001` |
| Application already in final state (`APPROVED` / `REJECTED`) | `code = 6001` |
| **Company search not yet passed** (calling before `PENDING_USER` webhook) | `code = 6406` + `message`: "Company search not passed yet. Wait for PENDING\_USER webhook before requesting IDV link." |
### 2.4 RefreshIdvLink
| Scenario | Response |
| :-------------------------------------------------------------------- | :--------------------- |
| Successful | `code = 1` |
| `applicationNo` / `peopleId` not found / not owned by current Party A | `code = 6003` / `6005` |
| All tasks for this person already completed | `code = 6001` |
| Application already in final state | `code = 6001` |
| Company search not yet passed (calling before `PENDING_USER` webhook) | `code = 6406` |
### 2.5 QueryCompanyProfile
| Scenario | Response |
| :------------------------------------------------------------------ | :----------------------------------------------------- |
| Successful | `code = 1` + `data` |
| `companyCode` not found | `code = 6003` |
| Company corresponding to `companyCode` not owned by current Party A | `code = 6005` |
| Company not yet approved | `code = 6001` + message "Profile is not approved yet." |
## 3. Profile Error Descriptions (`code = 6802`)
The complete list is identical to [ISV Transaction API · Profile Error Descriptions](./transaction-api#profile-error-description), grouped by module:
* `[Business details]`
* `[Entity details]`
* `[Key people]`
* `[Shareholder]`
* `[Others]`
Additional rejection scenarios specific to this API set:
* `[Entity details]Place of incorporation not supported: CHN` — `incorpPlace` / `regPlace` / `operatingPlace` at entity level must not be CHN
* `[Entity details]Place of incorporation not supported: ` — Sanctioned country
* `[Entity details]Partnership / Sole proprietorship only support incorpPlace=HKG` — Partnership / sole proprietorship is supported in Hong Kong only
* `[Key people]Nationality not supported: ` — keyPeople nationality is a sanctioned country (CHN is exempted)
* `[Wallet Admin]Work certification is necessary` — Wallet admin with region=CHN did not provide `overseaWorkCertificateFileKey`
# ISV Transaction API
Source: https://docs.oristapay.com/en/isv/transaction-api
# ISV Transaction API
## Overview
This API set is designed for **ISV customers** to call on behalf of their end customers (merchants) after completing [Onboarding](./onboarding-api). It covers transfers, payment declarations, Payout, bank account management, and other daily transaction operations.
ISVs simply pass `walletId` when calling these APIs. OristaPay automatically enforces authorization based on the ISV ↔ merchant relationship. **Transaction API fields remain unchanged.**
## Authentication & Signing
All endpoints require signature headers. See [Authentication & Signing](./auth) for details.
## API Index
| # | API | REST Path |
| -- | ------------------------------------ | ------------------------------------------ |
| 1 | Static Receiving Address Query | `POST /api/v1/wallet/static-address/query` |
| 2 | Supported Currencies Query | `POST /api/v1/wallet/supported/currencies` |
| 3 | Request Payment Order Declaration | `POST /api/v1/payment/order/declare` |
| 4 | Request Payment Material Supplement | `POST /api/v1/payment/order/add/materials` |
| 5 | Order Details | `POST /api/v1/payment/order/detail` |
| 6 | Order List | `POST /api/v1/payment/order/list` |
| 7 | Download Statement | `POST /api/v1/payment/reconciliation` |
| 8 | Add Beneficiary Bank Account | `POST /api/v1/wallet/bank_account/add` |
| 9 | Update Beneficiary Bank Account | `POST /api/v1/wallet/bank_account/update` |
| 10 | Delete Beneficiary Bank Account | `POST /api/v1/wallet/bank_account/del` |
| 11 | Enquiry Beneficiary Bank Account | `POST /api/v1/wallet/bank_account/get` |
| 12 | Payout Quote | `POST /api/v1/payout/quote` |
| 13 | Payout Order | `POST /api/v1/payout/book` |
| 14 | Payout Order Enquiry | `POST /api/v1/payout/enquiry` |
| 15 | Payout Re-Settle | `POST /api/v1/payout/reSettle` |
| 16 | Order Result Notification | Webhook |
| 17 | Add Bank Account Result Notification | Webhook |
| 18 | Payout Result Notification | Webhook |
| 19 | Payout Refund Result Notification | Webhook |
| 20 | Payout Re-Settle Result Notification | Webhook |
# Wallet Payment API
### 1. Static Receiving Address Query
**Interface Overview**
Query the Request Payment static receiving address of a specified wallet.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :--------- | :------- | :--------- | :------------------------------------------------- |
| `walletId` | `int64` | M | Wallet ID |
| `network` | `string` | O | Blockchain network: `ETH` / `TRX` / `SOL` / `POLY` |
| `currency` | `string` | O | Currency: `USDT` / `USDC` |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :------------------------- | :------------------------ |
| `code` | `int32` | Business response code |
| `message` | `string` | Business response message |
| `data` | `Array` | Static address list |
`StaticAddressData` fields:
| Field Name | Type | Description |
| :------------- | :------- | :---------------------------------------------------------------------------------------------------------------------------------- |
| `walletId` | `int64` | Wallet ID |
| `network` | `string` | Blockchain network, such as `ETH` / `TRX` |
| `currency` | `string` | Currency, such as `USDT` / `USDC` |
| `address` | `string` | Static receiving address |
| `qrCodeBase64` | `string` | QR code image of the address, Base64 encoded, including the `data:image/png;base64,` prefix. It can be directly used in ` ` |
**Request Example**
```json theme={null}
{
"walletId": 123456789,
"network": "ETH",
"currency": "USDT"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": [
{
"walletId": 123456789,
"network": "ETH",
"currency": "USDT",
"address": "0x9f8b2c1d4e5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c",
"qrCodeBase64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}
]
}
```
### 2. Supported Currencies Query
**Interface Overview**
Query the currencies, available networks, single-transaction amount range, and currency precision supported by the wallet under a specified business type by `walletId + type`. The caller can use this API for pre-validation before creating deposit or withdrawal orders, to avoid submitting unsupported or out-of-limit currency combinations.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :--------- | :------- | :--------- | :---------------------------------------------------- |
| `walletId` | `int64` | M | Wallet ID |
| `type` | `string` | M | Business type / limit type: `4` deposit, `3` withdraw |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :------------------------------------ | :------------------------------------------------ |
| `code` | `int32` | Business response code |
| `message` | `string` | Business response message |
| `data` | `Array` | Supported currency list; returned when `code = 1` |
`SupportedCurrenciesQueryData` fields:
| Field Name | Type | Description |
| :---------- | :-------------- | :--------------------------------------------------------------------------------- |
| `type` | `int32` | Business type / limit type, corresponding to the request `type` |
| `currency` | `string` | Currency, such as `USDT` / `USDC` / `USD` |
| `minAmount` | `string` | Minimum single-transaction amount, decimal number in string format |
| `maxAmount` | `string` | Maximum single-transaction amount, decimal number in string format |
| `networks` | `Array` | Supported blockchain network list for this currency, such as `ETH` / `TRX` / `SOL` |
| `precision` | `int32` | Amount precision, number of decimal places |
**Request Example**
```json theme={null}
{
"walletId": 123456789,
"type": 1
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": [
{
"type": 4,
"currency": "USDT",
"minAmount": "10",
"maxAmount": "50000",
"networks": ["ETH", "TRX"],
"precision": 6
},
{
"type": 4,
"currency": "USDC",
"minAmount": "10",
"maxAmount": "50000",
"networks": ["ETH", "SOL"],
"precision": 6
}
]
}
```
### 3. Request Payment Order Declaration
**Interface Overview**
Submit a Request Payment deposit order.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :--------------- | :---------------- | :--------- | :------------------------------------------------------------------------------- |
| `walletId` | `int64` | M | Deposit wallet ID |
| `extOrderNo` | `string` | M | External order ID, globally unique |
| `senderAddress` | `string` | M | Payer wallet address |
| `network` | `string` | M | Blockchain network: `ETH` / `TRX` / `SOL` / `POLY` |
| `currency` | `string` | M | Currency: `USDT` / `USDC` |
| `amount` | `string` | M | Declared amount. The declared amount must exactly match the final deposit amount |
| `senderName` | `string` | M | Payer name |
| `countryRegion` | `string` | M | Country/region ISO 3166 code, for example `HKG` |
| `contactAddress` | `string` | M | Payer contact address |
| `receiverName` | `string` | M | Recipient merchant name |
| `message` | `string` | O | Remark |
| `materials` | `Array` | O | Collection of order material declaration objects |
`Material` fields:
| Field Name | Type | M / O / CM | Description |
| :---------------------- | :------- | :--------- | :--------------------- |
| `productType` | `string` | M | Product type |
| `productName` | `string` | M | Product name |
| `productPrice` | `string` | M | Product price |
| `productCount` | `string` | M | Product quantity |
| `productUnit` | `string` | M | Product unit |
| `logisticsTrackingName` | `string` | O | Logistics company name |
| `logisticsTrackingNo` | `string` | O | Tracking number |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :------- | :--------------- |
| `code` | `int32` | Response code |
| `message` | `string` | Response message |
**Request Example**
```json theme={null}
{
"walletId": "429883231600640",
"extOrderNo": "1747626211614",
"senderAddress": "0x213F2B229BE4f3FFF88fc874a986b19D79623339",
"network": "ETH",
"currency": "USDC",
"amount": "150",
"senderName": "Reflective Method Invocation",
"countryRegion": "HKG",
"contactAddress": "contact address hong kong",
"receiverName": "Reflective Method Invocation",
"message": "request payment msg",
"materials": [
{
"productType": "Electronics",
"productName": "Wireless Bluetooth Headphones",
"productPrice": "89.99",
"productCount": "150",
"productUnit": "pcs",
"logisticsTrackingName": "FedEx International Priority",
"logisticsTrackingNo": "FX123456789US"
}
]
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success"
}
```
### 4. Request Payment Material Supplement
**Interface Overview**
Supplement product and logistics materials for an existing declared order.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :---------- | :---------------- | :--------- | :----------------------------------- |
| `walletId` | `int64` | M | Deposit wallet ID |
| `orderNo` | `string` | M | Order number |
| `materials` | `Array` | O | Collection of order material objects |
`Material` fields are the same as those in `1. Request Payment Order Declaration`.
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :------- | :--------------- |
| `code` | `int32` | Response code |
| `message` | `string` | Response message |
**Request Example**
```json theme={null}
{
"walletId": "429883231600640",
"orderNo": "447767487604736",
"materials": [
{
"productType": "Electronics",
"productName": "Wireless Bluetooth Headphones",
"productPrice": "89.99",
"productCount": "150",
"productUnit": "pcs",
"logisticsTrackingName": "FedEx International Priority",
"logisticsTrackingNo": "FX123456789US"
}
]
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data": {
"orderNo": "ORDER123456789"
}
}
```
### 5. Order Details
**Interface Overview**
Query wallet order details by order number or external order number.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :----------- | :------- | :--------- | :----------------------------------------------------------------------- |
| `walletId` | `int64` | M | Wallet ID |
| `orderNo` | `string` | CM | Order number. Either `orderNo` or `extOrderNo` must be provided |
| `extOrderNo` | `string` | CM | External order number. Either `orderNo` or `extOrderNo` must be provided |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :---------------------- | :--------------- |
| `code` | `int32` | Response code |
| `message` | `string` | Response message |
| `data` | `WalletOrderDetailData` | Order details |
`WalletOrderDetailData` fields:
| Field Name | Type | Description |
| :------------ | :------- | :------------------------------------------------- |
| `orderNo` | `string` | Order number |
| `extOrderNo` | `string` | External order number |
| `orderType` | `int32` | Order type |
| `orderStatus` | `string` | See Appendix: Deposit Order Status |
| `fromAddress` | `string` | Initiator address |
| `fromWallet` | `string` | Source wallet |
| `toAddress` | `string` | Recipient address |
| `toWallet` | `string` | Target wallet |
| `amount` | `string` | Amount |
| `network` | `string` | Blockchain network: `ETH` / `TRX` / `SOL` / `POLY` |
| `currency` | `string` | Currency: `USDT` / `USDC` |
| `expireTime` | `int64` | Order expiration time |
| `createTime` | `int64` | Order creation time |
**Request Example**
```json theme={null}
{
"walletId": 1001,
"orderNo": "ORDER123456789"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data": {
"orderNo": "447767487604736",
"extOrderNo": "1744341998597",
"orderType": 4,
"orderStatus": "SUCCESS",
"fromAddress": "0x213F2B229BE4f3FFF88fc874a986b19D79623339",
"toAddress": "0xc496E20b19F009543E49b8512CB990ceb0a230F0",
"toWallet": "429883231600640",
"amount": "17",
"network": "ETH",
"currency": "USDT",
"expireTime": 1744342629783,
"createTime": 1744343297296
}
}
```
### 6. Order List
**Interface Overview**
Query wallet orders by `walletId` with pagination. Orders can be filtered by status, currency, and creation time range. The returned order data uses the unified wallet order structure and is suitable for order list pages, pre-reconciliation queries, or polling order progress by status.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :----------- | :------- | :--------- | :---------------------------------------------------------------------------------------------------------------------------------- |
| `walletId` | `int64` | M | Wallet ID. It must belong to the enterprise corresponding to the current API Key, or to an ISV sub-enterprise under that enterprise |
| `status` | `string` | O | Order status. If not provided, all statuses are queried |
| `currency` | `string` | O | Currency, such as `USDT` / `USDC` |
| `startTime` | `string` | O | Query start time, filtered by order creation time. Format: ISO8601 with timezone, for example `2026-01-01T00:00:00Z` |
| `endTime` | `string` | O | Query end time, filtered by order creation time. Format: ISO8601 with timezone, for example `2026-01-01T00:00:00Z` |
| `pageNumber` | `int32` | M | Page number, starting from `1` |
| `pageSize` | `int32` | M | Number of records per page. Default is `20`, maximum is `100`. Values greater than `100` are treated as `100` |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :----------------------------- | :--------------------------------------------------------------------------- |
| `code` | `int32` | Business response code. `1` means success; other values refer to error codes |
| `message` | `string` | Business response message |
| `data` | `Array` | Order list; returned when `code = 1` |
| `page` | `Page` | Pagination information |
`Page` fields:
| Field Name | Type | Description |
| :------------- | :------ | :------------------------- |
| `pageNumber` | `int32` | Current page number |
| `pageSize` | `int32` | Number of records per page |
| `totalPages` | `int32` | Total pages |
| `totalRecords` | `int32` | Total records |
`WalletOrderDetailData` fields:
| Field Name | Type | Description |
| :------------ | :------- | :--------------------------------- |
| `orderNo` | `string` | Order number |
| `extOrderNo` | `string` | External order number |
| `orderType` | `int32` | Order type |
| `orderStatus` | `string` | See Appendix: Deposit Order Status |
| `fromAddress` | `string` | Initiator address |
| `fromWallet` | `string` | Source wallet |
| `toAddress` | `string` | Recipient address |
| `toWallet` | `string` | Target wallet |
| `amount` | `string` | Amount |
| `network` | `string` | Blockchain network: `ETH` / `TRX` |
| `currency` | `string` | Currency: `USDT` / `USDC` |
| `expireTime` | `int64` | Order expiration time |
| `createTime` | `int64` | Order creation time |
**Request Example**
```json theme={null}
{
"walletId": 519309997363200,
"status": "SUCCESS,IN_PROGRESS",
"currency": "USDT",
"startTime": "2026-01-01T00:00:00Z",
"endTime": "2026-01-31T23:59:59Z",
"pageNumber": 1,
"pageSize": 20
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": [
{
"orderNo": "447767487604736",
"extOrderNo": "1744341998597",
"orderType": 4,
"orderStatus": "SUCCESS",
"fromAddress": "0x213F2B229BE4f3FFF88fc874a986b19D79623339",
"fromWallet": "123456",
"toAddress": "0xc496E20b19F009543E49b8512CB990ceb0a230F0",
"toWallet": "429883231600640",
"amount": "17",
"network": "ETH",
"currency": "USDT",
"expireTime": 1744342629783,
"createTime": 1744343297296
}
],
"page": {
"pageNumber": 1,
"pageSize": 20,
"totalPages": 1,
"totalRecords": 1
}
}
```
### 7. Download Statement
**Interface Overview**
Statements for D-1 can be downloaded from 9:00 AM every day. The time zone is Hong Kong UTC+8.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :------------- | :------- | :--------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `walletId` | `int64` | M | Wallet ID |
| `billDate` | `string` | M | Billing date in `yyyyMMdd` format |
| `modeType` | `int32` | M | Authorization mode: `1` = direct connection mode; `2` = authorization mode including sub-wallets |
| `accountType` | `int32` | M | Account type: `1` = custody account; `2` = trading account |
| `currencyType` | `int32` | M | Currency type: `1` ETH-USDT / `2` ETH-USDC / `3` TRX-USDT / `4` USDT / `5` USDC / `6` USD / `14` SOL-USDC / `15` SOL-USDT / `16` POLY-USDC / `17` POLY-USDT |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :--------------- | :-------------------- |
| `code` | `int32` | Response code |
| `message` | `string` | Response message |
| `data` | `WalletBillData` | Statement information |
`WalletBillData` fields:
| Field Name | Type | Description |
| :--------- | :------- | :---------------------------------------- |
| `fileName` | `string` | File name |
| `fileUrl` | `string` | Download URL of the statement zip package |
**Request Example**
```json theme={null}
{
"walletId": 123456789,
"billDate": "20250330",
"modeType": 1,
"accountType": 1,
"currencyType": 1
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data": {
"fileName": "20231123_123456789_Statement_ETHUSDT.zip",
"fileUrl": "https://hk-pro-wallet-private-oss.oss-cn-hongkong.aliyuncs.com/thirdpartybilling/1737925914987610112.zip"
}
}
```
# Bank Account API
| Path | Request | Response |
| ------------------------------------ | -------------------------- | ------------------------ |
| `/api/v1/wallet/bank_account/add` | `AddBankAccountRequest` | `BankAccountResponse` |
| `/api/v1/wallet/bank_account/update` | `UpdateBankAccountRequest` | `BankAccountResponse` |
| `/api/v1/wallet/bank_account/del` | `DelBankAccountRequest` | `DelBankAccountResponse` |
| `/api/v1/wallet/bank_account/get` | `GetBankAccountRequest` | `GetBankAccountResponse` |
> The following APIs share the `BankAccountData` and `FileInfo` definitions.
`BankAccountData` fields:
| Field Name | Type | Description |
| :---------------------- | :---------------- | :-------------------------------------------------------------- |
| `settlementAccountUID` | `int64` | Settlement account ID |
| `walletId` | `int64` | Wallet ID |
| `alias` | `string` | Alias |
| `accountOwnership` | `int32` | Relationship with wallet: `1` own / `2` other / `3` third party |
| `currency` | `string` | Currency: `USD` |
| `accountType` | `int32` | Account type: `1` RD Wallet / `2` Bank Account |
| `companyName` | `string` | Company name |
| `accountNumber` | `string` | RD Wallet ID or bank account number |
| `bankId` | `string` | Hong Kong bank ID, for example `003` |
| `beneficiaryAddress1` | `string` | Beneficiary address line 1. Chinese characters are not allowed |
| `beneficiaryAddress2` | `string` | Beneficiary address line 2. Chinese characters are not allowed |
| `beneficiaryAddress3` | `string` | Beneficiary address line 3: country/region ISO 3166 code |
| `beneficiarySwiftCode` | `string` | Beneficiary bank Swift Code |
| `intermediarySwiftCode` | `string` | Intermediary bank Swift Code |
| `companyCode` | `string` | Company profile code |
| `status` | `int32` | Status: `0` processing / `1` success / `2` failed |
| `paymentFiles` | `Array` | Proof of payment files |
| `remark` | `string` | Remark |
`FileInfo` fields:
| Field Name | Type | Description |
| :--------- | :------- | :--------------------------------------------------------------------- |
| `fileKey` | `string` | File ID returned by the upload API |
| `fileName` | `string` | File name |
| `fileUrl` | `string` | File URL returned by the upload API. The URL is refreshed periodically |
### 8. Add Beneficiary Bank Account
**Interface Overview**
Add a beneficiary bank account.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :---------------------- | :---------------- | :--------- | :-------------------------------------------------------------------------------- |
| `walletId` | `int64` | M | Wallet ID |
| `alias` | `string` | M | Alias of this bank account |
| `accountOwnership` | `int32` | M | Ownership: `1` own / `2` other / `3` third party |
| `currency` | `string` | M | Currency: `USD` |
| `accountType` | `int32` | M | Account type: `1` RD Wallet / `2` Bank Account |
| `companyName` | `string` | M | Company name. When `accountOwnership=2`, this name must match the company profile |
| `accountNumber` | `string` | M | RD Wallet ID or bank account number |
| `bankId` | `string` | M | Hong Kong bank ID, for example `003` |
| `beneficiaryAddress1` | `string` | CM | Required when `accountType=2` |
| `beneficiaryAddress2` | `string` | CM | Required when `accountType=2` |
| `beneficiaryAddress3` | `string` | CM | Required when `accountType=2`. Country/region ISO 3166 code |
| `beneficiarySwiftCode` | `string` | CM | Required when `accountType=2`; must be a Hong Kong bank Swift Code |
| `intermediarySwiftCode` | `string` | O | Intermediary bank Swift Code; must be a Hong Kong bank Swift Code |
| `companyCode` | `string` | CM | Required when `accountOwnership=2` |
| `paymentFiles` | `Array` | CM | Required when `accountOwnership=3` |
| `remark` | `string` | O | Optional when `accountOwnership=3` |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :---------------- | :----------------------- |
| `code` | `int32` | Response code |
| `message` | `string` | Response message |
| `data` | `BankAccountData` | Bank account information |
**Request Example**
```json theme={null}
{
"walletId": 4298832316123456,
"alias": "name alias",
"accountOwnership": 2,
"currency": "USD",
"accountType": 2,
"companyName": "narti adiddf",
"accountNumber": "8888888",
"bankId": "003",
"beneficiaryAddress1": "payee address1",
"beneficiaryAddress2": "payee address2",
"beneficiaryAddress3": "HK",
"beneficiarySwiftCode": "DHBKHKHHXXX",
"intermediarySwiftCode": "DHBKHKHHXXX",
"companyCode": "HK1239876654",
"paymentFiles": [
{
"fileKey": "file_key_123",
"fileName": "xxxx.pdf"
}
],
"remark": "remark"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data": {
"settlementAccountUID": 1236547995462114,
"walletId": 4298832316123456,
"alias": "name alias",
"accountOwnership": 2,
"currency": "USD",
"accountType": 2,
"companyName": "narti adiddf",
"accountNumber": "8888888",
"bankId": "003",
"beneficiaryAddress1": "payee address1",
"beneficiaryAddress2": "payee address2",
"beneficiaryAddress3": "HK",
"beneficiarySwiftCode": "DHBKHKHHXXX",
"intermediarySwiftCode": "DHBKHKHHXXX",
"companyCode": "HK1239876654",
"status": 0,
"paymentFiles": [
{
"fileKey": "file_key_123",
"fileName": "xxxx.pdf",
"fileUrl": "https://xxxxx"
}
],
"remark": "remark"
}
}
```
### 9. Update Beneficiary Bank Account
**Interface Overview**
Update non-key fields of a beneficiary bank account. `accountOwnership`, `currency`, `accountType`, `companyName`, and `companyCode` cannot be updated.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :---------------------- | :---------------- | :--------- | :---------------------------------- |
| `walletId` | `int64` | M | Wallet ID |
| `settlementAccountUID` | `int64` | M | Settlement account ID |
| `alias` | `string` | O | Alias |
| `accountNumber` | `string` | O | RD Wallet ID or bank account number |
| `bankId` | `string` | O | Hong Kong bank ID |
| `beneficiaryAddress1` | `string` | O | Beneficiary address line 1 |
| `beneficiaryAddress2` | `string` | O | Beneficiary address line 2 |
| `beneficiaryAddress3` | `string` | O | Beneficiary address line 3 |
| `beneficiarySwiftCode` | `string` | O | Beneficiary bank Swift Code |
| `intermediarySwiftCode` | `string` | O | Intermediary bank Swift Code |
| `paymentFiles` | `Array` | CM | Required when `accountOwnership=3` |
| `remark` | `string` | O | Optional when `accountOwnership=3` |
**Response Parameters**
Same as `9. Add Beneficiary Bank Account`. `data` is `BankAccountData`.
**Request Example**
```json theme={null}
{
"settlementAccountUID": 1236547995462114,
"walletId": 4298832316123456,
"alias": "name alias",
"accountNumber": "8888888",
"bankId": "003",
"beneficiaryAddress1": "payee address1",
"beneficiaryAddress2": "payee address2",
"beneficiaryAddress3": "HK",
"beneficiarySwiftCode": "DHBKHKHHXXX",
"intermediarySwiftCode": "DHBKHKHHXXX",
"paymentFiles": [
{
"fileKey": "file_key_123",
"fileName": "xxxx.pdf"
}
],
"remark": "remark"
}
```
**Response Example**
Same structure as the response example in `9. Add Beneficiary Bank Account`.
### 10. Delete Beneficiary Bank Account
**Interface Overview**
Delete a beneficiary bank account.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :--------------------- | :------- | :--------- | :-------------------- |
| `walletId` | `int64` | M | Wallet ID |
| `settlementAccountUID` | `int64` | M | Settlement account ID |
| `reason` | `string` | M | Reason for deletion |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :------- | :--------------- |
| `code` | `int32` | Response code |
| `message` | `string` | Response message |
**Request Example**
```json theme={null}
{
"settlementAccountUID": 1236547995462114,
"walletId": 4298832316123456,
"reason": "del reason"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success"
}
```
### 11. Enquiry Beneficiary Bank Account
**Interface Overview**
Query beneficiary bank accounts.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :--------------------- | :------- | :--------- | :------------------------------------ |
| `walletId` | `int64` | M | Wallet ID |
| `settlementAccountUID` | `int64` | O | Settlement account ID for exact query |
| `companyCode` | `string` | O | Company profile code |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :----------------------- | :---------------- |
| `code` | `int32` | Response code |
| `message` | `string` | Response message |
| `data` | `Array` | Bank account list |
**Request Example**
```json theme={null}
{
"settlementAccountUID": 1236547995462114,
"walletId": 4298832316123456,
"companyCode": "HK1239876654"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "success",
"data": [
{
"settlementAccountUID": 1236547995462114,
"walletId": 4298832316123456,
"alias": "name alias",
"accountOwnership": 2,
"currency": "USD",
"accountType": 2,
"companyName": "narti adiddf",
"accountNumber": "8888888",
"bankId": "003",
"beneficiaryAddress1": "payee address1",
"beneficiaryAddress2": "payee address2",
"beneficiaryAddress3": "HK",
"beneficiarySwiftCode": "DHBKHKHHXXX",
"intermediarySwiftCode": "DHBKHKHHXXX",
"companyCode": "HK1239876654",
"status": 0,
"paymentFiles": [
{
"fileKey": "file_key_123",
"fileName": "xxxx.pdf",
"fileUrl": "https://xxxxx"
}
],
"remark": "remark"
}
]
}
```
# Off-ramp API
### 12. Payout Quote
**Interface Overview**
Obtain the price and transfer-related information for a specified currency pair. At least one of `fromAmount` or `toAmount` must be provided.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :------------- | :------- | :--------- | :----------------------------------------------------------------------------------------------------------------------- |
| `walletId` | `int64` | M | Wallet ID |
| `network` | `string` | O | Blockchain Network: ETH/TRX/SOL/POLY |
| `fromCurrency` | `string` | M | From currency: `USDT` / `USDC` |
| `fromAmount` | `string` | CM | From amount, supports 2 decimal places |
| `toCurrency` | `string` | M | To currency: `USD` |
| `toAmount` | `string` | CM | To amount, supports 2 decimal places |
| `paymentWay` | `string` | M | Payment method: `RDT` / `CHATS` |
| `feeMode` | `int32` | CM | Required if `paymentWay=CHATS`. `1` = shared by both sender and receiver (SHAR); `2` = borne entirely by the payer (OUR) |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :---------------- | :--------------- |
| `code` | `int32` | Response code |
| `message` | `string` | Response message |
| `data` | `PayoutQuoteData` | Quote data |
`PayoutQuoteData` fields:
| Field Name | Type | Description |
| :---------------- | :------- | :------------------------------------ |
| `walletId` | `int64` | Wallet ID |
| `network` | `string` | Blockchain Network: ETH/TRX/SOL/POLY |
| `fromCurrency` | `string` | From currency |
| `fromAmount` | `string` | From amount |
| `toCurrency` | `string` | To currency |
| `toAmount` | `string` | To amount after deducting service fee |
| `paymentWay` | `string` | Payment method |
| `feeMode` | `int32` | Fee deduction mode |
| `quoteId` | `int64` | Quote ID |
| `price` | `string` | Price |
| `priceExpireTime` | `string` | Price expiration time in milliseconds |
| `feeAmount` | `string` | Service fee |
| `feeCurrency` | `string` | Fee currency |
**Request Example**
```json theme={null}
{
"walletId": 1000232233,
"network": "ETH",
"fromCurrency": "USDT",
"fromAmount": "200.12",
"toCurrency": "USD",
"paymentWay": "CHATS",
"feeMode": 1
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": {
"walletId": "429405186232384",
"network": "ETH",
"fromCurrency": "USDT",
"fromAmount": "200.12",
"toCurrency": "USD",
"toAmount": "192.83",
"paymentWay": "CHATS",
"feeMode": 1,
"quoteId": "665131773713321985",
"price": "0.9986",
"priceExpireTime": "1736387772381",
"feeAmount": "7",
"feeCurrency": "USD"
}
}
```
### 13. Payout Order
**Interface Overview**
Place a payout order based on a quote ID.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :--------------------- | :------- | :--------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |
| `walletId` | `int64` | M | Wallet ID |
| `quoteId` | `int64` | M | Quote ID |
| `settlementAccountUID` | `int64` | M | Settlement account ID, obtained through the bank account enquiry API |
| `purpose` | `string` | M | See Appendix: Purpose |
| `extOrderNo` | `string` | M | Unique order ID provided by the business entity. Only numbers, letters, `_`, `-`, and `*` are allowed. Must be unique under the same wallet account |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :--------------- | :---------------- |
| `code` | `int32` | Response code |
| `message` | `string` | Response message |
| `data` | `PayoutBookData` | Payout order data |
`PayoutBookData` fields:
| Field Name | Type | Description |
| :--------------------- | :------- | :---------------------------------------------- |
| `walletId` | `int64` | Wallet ID |
| `quoteId` | `int64` | Quote ID |
| `settlementAccountUID` | `int64` | Settlement account ID |
| `purpose` | `string` | Purpose |
| `orderNo` | `string` | Order number |
| `fromCurrency` | `string` | From currency |
| `fromAmount` | `string` | From amount |
| `toCurrency` | `string` | To currency |
| `toAmount` | `string` | To amount |
| `paymentWay` | `string` | Payment method |
| `feeMode` | `int32` | Fee deduction mode |
| `feeAmount` | `string` | Service fee |
| `feeCurrency` | `string` | Fee currency |
| `orderStatus` | `string` | See Appendix: Payout Order Status |
| `createTime` | `int64` | Order creation time |
| `extOrderNo` | `string` | Unique order ID provided by the business entity |
**Request Example**
```json theme={null}
{
"walletId": 1000232233,
"quoteId": 665131773713321985,
"settlementAccountUID": 48775048489845,
"purpose": "PMT001",
"extOrderNo": "1234567898"
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": {
"walletId": "429405186232384",
"quoteId": "665205920267108353",
"settlementAccountUID": 1236547995462114,
"purpose": "PMT001",
"orderNo": "431513431160832",
"fromCurrency": "USDT",
"fromAmount": "200.12",
"toCurrency": "USD",
"toAmount": "192.83",
"paymentWay": "CHATS",
"feeMode": 1,
"feeAmount": "7",
"feeCurrency": "USD",
"orderStatus": "SUBMITTED",
"createTime": "1736405450558",
"extOrderNo": "1234567898"
}
}
```
### 14. Payout Order Enquiry
**Interface Overview**
Query payout order information by order number or quote ID.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :--------- | :------- | :--------- | :------------------------------------------------------ |
| `walletId` | `int64` | M | Wallet ID |
| `orderNo` | `string` | CM | At least one of `orderNo` or `quoteId` must be provided |
| `quoteId` | `int64` | CM | At least one of `orderNo` or `quoteId` must be provided |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :----------- | :------------------- |
| `code` | `int32` | Response code |
| `message` | `string` | Response message |
| `data` | `PayoutData` | Payout order details |
`PayoutData` fields:
| Field Name | Type | Description |
| :--------------------- | :------- | :---------------------------------------------- |
| `walletId` | `int64` | Wallet ID |
| `quoteId` | `int64` | Quote ID |
| `orderNo` | `string` | Order number |
| `fromCurrency` | `string` | From currency |
| `fromAmount` | `string` | From amount |
| `toCurrency` | `string` | To currency |
| `toAmount` | `string` | To amount |
| `tradeFromAmount` | `string` | Actual traded from amount |
| `tradeToAmount` | `string` | Actual traded to amount |
| `price` | `string` | Order price |
| `tradePrice` | `string` | Trade price |
| `orderStatus` | `string` | See Appendix: Payout Order Status |
| `createTime` | `int64` | Order creation time |
| `finishTime` | `int64` | Order completion time |
| `errorMsg` | `string` | Failure reason |
| `settlementAccountUID` | `int64` | Settlement account ID |
| `purpose` | `string` | Purpose |
| `paymentWay` | `string` | Payment method |
| `feeMode` | `int32` | Fee deduction mode |
| `feeAmount` | `string` | Service fee |
| `feeCurrency` | `string` | Fee currency |
| `refundOrderNo` | `string` | Refund order number when the order fails |
| `refundAmount` | `string` | Refund amount when the order fails |
| `refundCurrency` | `string` | Refund currency when the order fails |
| `extOrderNo` | `string` | Unique order ID provided by the business entity |
**Request Example**
```json theme={null}
{
"walletId": 1000232233,
"quoteId": 665131773713321985
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": {
"walletId": 1000232233,
"quoteId": 665131773713321985,
"orderNo": "442112731049984",
"fromCurrency": "USDT",
"fromAmount": "200.12",
"toCurrency": "USD",
"toAmount": "192.83",
"tradeFromAmount": "200.12",
"tradeToAmount": "192.83",
"price": "1.142",
"tradePrice": "1.142",
"orderStatus": "SUCCESSFUL",
"createTime": 1741580889957,
"finishTime": 1741580889957,
"settlementAccountUID": 1236547995462114,
"purpose": "PMT001",
"paymentWay": "CHATS",
"feeMode": 1,
"feeAmount": "7",
"feeCurrency": "USD",
"extOrderNo": "1234567898"
}
}
```
### 15. Payout Re-Settle
**Interface Overview**
Re-initiate settlement after a refund or failed settlement.
**Request Parameters**
| Field Name | Type | M / O / CM | Description |
| :--------------------- | :------- | :--------- | :----------------------------------------------------------------------------- |
| `walletId` | `int64` | M | Wallet ID |
| `orderNo` | `string` | M | Original payout order number |
| `refundOrderNo` | `string` | M | Refund order number |
| `settlementAccountUID` | `int64` | M | Settlement account ID |
| `purpose` | `string` | M | See Appendix: Purpose |
| `remark` | `string` | M | Remark |
| `paymentWay` | `string` | M | Payment method: `RDT` / `CHATS` |
| `feeMode` | `int32` | CM | Required if `paymentWay=CHATS`; meaning is the same as in the Payout Quote API |
**Response Parameters**
| Field Name | Type | Description |
| :--------- | :------------------- | :----------------- |
| `code` | `int32` | Response code |
| `message` | `string` | Response message |
| `data` | `PayoutReSettleData` | Re-settlement data |
`PayoutReSettleData` fields:
| Field Name | Type | Description |
| :--------------------- | :------- | :--------------------------- |
| `walletId` | `int64` | Wallet ID |
| `orderNo` | `string` | Original payout order number |
| `refundOrderNo` | `string` | Refund order number |
| `settlementAccountUID` | `int64` | Settlement account ID |
| `purpose` | `string` | Purpose |
| `remark` | `string` | Remark |
| `paymentWay` | `string` | Payment method |
| `feeMode` | `int32` | Fee deduction mode |
| `amount` | `string` | Re-settlement amount |
| `currency` | `string` | Re-settlement currency |
| `feeAmount` | `string` | Service fee |
| `feeCurrency` | `string` | Fee currency |
**Request Example**
```json theme={null}
{
"walletId": 1000232233,
"orderNo": "442112731049984",
"refundOrderNo": "232112731049984",
"settlementAccountUID": 1236547995462114,
"purpose": "PMT001",
"remark": "remark",
"paymentWay": "CHATS",
"feeMode": 1
}
```
**Response Example**
```json theme={null}
{
"code": 1,
"message": "Success",
"data": {
"walletId": 1000232233,
"orderNo": "442112731049984",
"refundOrderNo": "232112731049984",
"settlementAccountUID": 1236547995462114,
"purpose": "PMT001",
"remark": "remark",
"paymentWay": "CHATS",
"feeMode": 1,
"amount": "183",
"currency": "USD",
"feeAmount": "7",
"feeCurrency": "USD"
}
}
```
# Callback
### Callback Request Specification
| Item | Value |
| :----------- | :------------------------------------------------------------------------------------------------------------------- |
| Method | `POST` |
| Content-Type | `application/json; charset=utf-8` |
| Request Body | JSON. The structure depends on the event type, such as order result notification or bank account result notification |
| Timeout | Default 8 seconds. Timeout is treated as failure and may trigger business-level retries |
**Request Headers**
| Header | Description |
| :------------- | :----------------------------------------------------------------------------- |
| `X-Api-Key` | Merchant `api_key`, identifying the merchant to which the callback belongs |
| `X-Timestamp` | UTC millisecond timestamp string when the callback is sent |
| `X-Nonce` | Unique random string for this callback, 32-character hex, used for idempotency |
| `X-Signature` | HMAC-SHA256 signature |
| `Content-Type` | Fixed as `application/json; charset=utf-8` |
### Signature Verification
The algorithm is the same as inbound API signing and uses the same `sign_secret`:
```text theme={null}
string_to_sign = "POST" + PATH + X-Timestamp + X-Nonce + SHA256_HEX(BODY)
signature = HEX(HMAC_SHA256(sign_secret, string_to_sign))
```
* `PATH`: the path part of the callback URL, excluding domain and query string.
* `BODY`: the raw HTTP request body bytes.
#### Verification Steps
1. Read request headers: `X-Timestamp`, `X-Nonce`, `X-Signature`, and `X-Api-Key`.
2. Validate the timestamp window: `abs(now_ms - X-Timestamp) <= 5 * 60 * 1000`; otherwise reject with `401`.
3. Read the raw request body before any parsing or deserialization.
4. Recalculate the signature using `sign_secret` and the raw body.
5. Compare the calculated signature and `X-Signature` using constant-time comparison.
6. Use `X-Nonce` as the idempotency key. If it has already been processed, return the previous result directly.
#### Common Pitfalls
* The signature must be calculated over the raw bytes. JSON re-serialization, key reordering, whitespace changes, or encoding changes will cause signature mismatch.
* `PATH` must match exactly. Do not add or remove a trailing slash, URL-decode it, or remove gateway prefixes.
* `X-Signature` is lowercase hex. The method is fixed as uppercase `POST`.
* Empty body must also be signed. `SHA256_HEX("")` is `e3b0c442...b855`.
#### Reference Implementations
**Python**
```python theme={null}
import hashlib
import hmac
def verify(path: str, ts: str, nonce: str, body_bytes: bytes,
x_signature: str, sign_secret: str) -> bool:
body_hash = hashlib.sha256(body_bytes).hexdigest()
expected = hmac.new(
sign_secret.encode(),
("POST" + path + ts + nonce + body_hash).encode(),
hashlib.sha256,
).hexdigest()
return hmac.compare_digest(expected, x_signature)
```
**Node.js**
```javascript theme={null}
const crypto = require('crypto');
function verify(path, ts, nonce, bodyBuf, xSignature, signSecret) {
const bodyHash = crypto.createHash('sha256').update(bodyBuf).digest('hex');
const expected = crypto
.createHmac('sha256', signSecret)
.update('POST' + path + ts + nonce + bodyHash)
.digest('hex');
const a = Buffer.from(expected, 'utf8');
const b = Buffer.from(xSignature, 'utf8');
return a.length === b.length && crypto.timingSafeEqual(a, b);
}
```
**Java**
```java theme={null}
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.security.MessageDigest;
import java.util.HexFormat;
public static boolean verify(String path, String ts, String nonce,
byte[] body, String xSignature, String signSecret) throws Exception {
String bodyHash = HexFormat.of().formatHex(
MessageDigest.getInstance("SHA-256").digest(body));
String toSign = "POST" + path + ts + nonce + bodyHash;
Mac mac = Mac.getInstance("HmacSHA256");
mac.init(new SecretKeySpec(signSecret.getBytes(), "HmacSHA256"));
String expected = HexFormat.of().formatHex(mac.doFinal(toSign.getBytes()));
return MessageDigest.isEqual(
expected.getBytes(), xSignature.getBytes());
}
```
**Go**
```go theme={null}
package main
import (
"crypto/hmac"
"crypto/sha256"
"encoding/hex"
)
func Verify(path, ts, nonce string, body []byte, xSig, signSecret string) bool {
sum := sha256.Sum256(body)
bodyHash := hex.EncodeToString(sum[:])
mac := hmac.New(sha256.New, []byte(signSecret))
mac.Write([]byte("POST" + path + ts + nonce + bodyHash))
expected := hex.EncodeToString(mac.Sum(nil))
return hmac.Equal([]byte(expected), []byte(xSig))
}
```
### Response Requirements
* The merchant system must respond within 8 seconds.
* HTTP `2xx` status code is treated as successful delivery.
* Non-`2xx`, timeout, or business error response is treated as failed delivery.
* Recommended response body:
Success:
```json theme={null}
{
"code": 1,
"message": "OK"
}
```
Failure:
```json theme={null}
{
"code": 6001,
"message": "failed"
}
```
### Idempotency and Replay Protection
* **Idempotency key**: use `X-Nonce` as the idempotency key and persist it. If the same key is received again, return the previous result directly.
* **Replay protection**: validate that `X-Timestamp` is within ±5 minutes of the server time.
* **Strict signature verification**: reject any request with invalid signature using `4xx` and do not enter business processing.
### Callback Data Types
### 16. Order Result Notification
| Field Name | Type | Description |
| :------------ | :------- | :------------------------------------------------- |
| `orderNo` | `string` | Order number |
| `currency` | `string` | Currency: `USDT` / `USDC` |
| `network` | `string` | Blockchain network: `ETH` / `TRX` / `SOL` / `POLY` |
| `status` | `string` | Order status. See Appendix: Deposit Order Status |
| `amount` | `string` | Amount |
| `fromAddress` | `string` | Initiator address |
| `fromWallet` | `string` | Source wallet |
| `toAddress` | `string` | Recipient address |
| `toWallet` | `string` | Target wallet |
| `txHash` | `string` | Transaction hash |
| `orderType` | `int32` | Order type |
| `extOrderNo` | `string` | External order number |
**Sample Data**
```json theme={null}
{
"orderNo": "ORDER123456789",
"currency": "USDT",
"network": "ETH",
"status": "SUCCESS",
"amount": "1.0",
"fromAddress": "0x123456789abcdef",
"toAddress": "0x987654321fedcba",
"fromWallet": "123456",
"toWallet": "1234567",
"txHash": "0x123456789abcdef123456789abcdef",
"orderType": 1,
"extOrderNo": "EXT123456789"
}
```
### 17. Add Bank Account Result Notification
| Field Name | Type | Description |
| :---------------------- | :------- | :------------------------------------------------------- |
| `settlementAccountUID` | `int64` | Settlement account ID |
| `walletId` | `int64` | Wallet ID |
| `alias` | `string` | Alias |
| `accountOwnership` | `int32` | Ownership: `1` own / `2` other / `3` third party |
| `currency` | `string` | Currency: `USD` |
| `accountType` | `int32` | Account type: `1` RD Wallet / `2` Bank Account |
| `accountName` | `string` | Account name |
| `accountNumber` | `string` | RD Wallet ID or bank account number |
| `bankId` | `string` | Hong Kong bank ID, for example `003` |
| `beneficiaryAddress1` | `string` | Beneficiary address line 1 |
| `beneficiaryAddress2` | `string` | Beneficiary address line 2 |
| `beneficiaryAddress3` | `string` | Beneficiary address line 3: country/region ISO 3166 code |
| `beneficiarySwiftCode` | `string` | Beneficiary bank Swift Code |
| `intermediarySwiftCode` | `string` | Intermediary bank Swift Code |
| `companyCode` | `string` | Company profile code |
| `status` | `int32` | Status: `0` processing / `1` success / `2` failed |
**Sample Data**
```json theme={null}
{
"settlementAccountUID": 1236547995462114,
"walletId": 4298832316123456,
"alias": "name alias",
"accountOwnership": 2,
"currency": "USD",
"accountType": 2,
"accountName": "narti adiddf",
"accountNumber": "8888888",
"bankId": "003",
"beneficiaryAddress1": "payee address1",
"beneficiaryAddress2": "payee address2",
"beneficiaryAddress3": "HK",
"beneficiarySwiftCode": "DHBKHKHHXXX",
"intermediarySwiftCode": "DHBKHKHHXXX",
"companyCode": "HK1239876654",
"status": 0
}
```
### 18. Payout Result Notification
| Field Name | Type | Description |
| :--------------------- | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `walletId` | `int64` | Wallet ID |
| `quoteId` | `int64` | Quote ID |
| `orderNo` | `string` | Order number |
| `fromCurrency` | `string` | From currency: `USDT` / `USDC` |
| `fromAmount` | `string` | From amount |
| `toCurrency` | `string` | To currency: `USD` |
| `toAmount` | `string` | To amount after deducting service fee |
| `tradeFromAmount` | `string` | Actual traded from amount |
| `tradeToAmount` | `string` | Actual traded to amount |
| `price` | `string` | Order price |
| `tradePrice` | `string` | Trade price |
| `orderStatus` | `string` | See Appendix: Payout Order Status |
| `createTime` | `int64` | Order creation time |
| `finishTime` | `int64` | Order completion time |
| `errorMsg` | `string` | Failure reason |
| `settlementAccountUID` | `int64` | Settlement account ID |
| `purpose` | `string` | See Appendix: Purpose |
| `paymentWay` | `string` | Payment method: `RDT` / `CHATS` |
| `feeMode` | `int32` | Fee deduction mode. Default value: `1`. `1` = shared by both sender and receiver (SHAR); `2` = borne entirely by the payer (OUR) |
| `feeAmount` | `string` | Service fee |
| `feeCurrency` | `string` | Fee currency |
| `refundOrderNo` | `string` | Available when the payout order status is `SETTLING_FAILED`; used to re-initiate settlement |
| `extOrderNo` | `string` | Unique order ID provided by the business entity. Only numbers, letters, `_`, `-`, and `*` are allowed. Must be unique under the same merchant account |
**Sample Data**
```json theme={null}
{
"walletId": 1000232233,
"quoteId": 665131773713321985,
"orderNo": "442112731049984",
"fromCurrency": "USDT",
"fromAmount": "200.12",
"toCurrency": "USD",
"toAmount": "192.83",
"tradeFromAmount": "200.12",
"tradeToAmount": "192.83",
"price": "1.142",
"tradePrice": "1.142",
"orderStatus": "SUCCESSFUL",
"createTime": 1741580889957,
"finishTime": 1741580889957,
"settlementAccountUID": 1236547995462114,
"purpose": "PMT001",
"paymentWay": "CHATS",
"feeMode": 1,
"feeAmount": "7",
"feeCurrency": "USD",
"extOrderNo": "1234567898"
}
```
### 19. Payout Refund Result Notification
| Field Name | Type | Description |
| :--------------- | :------- | :----------------------------------- |
| `walletId` | `int64` | Wallet ID |
| `orderNo` | `string` | Payout order number |
| `refundOrderNo` | `string` | Refund order number |
| `refundAmount` | `string` | Actual refund amount |
| `refundCurrency` | `string` | Refund currency |
| `refundReason` | `string` | Refund reason, returned if available |
| `refundTime` | `int64` | Refund time |
**Sample Data**
```json theme={null}
{
"walletId": 123456789,
"orderNo": "442112731049984",
"refundOrderNo": "442112731049984D1",
"refundAmount": "664.26",
"refundCurrency": "USD",
"refundReason": "refund",
"refundTime": 1741580889957
}
```
### 20. Payout Re-Settle Result Notification
| Field Name | Type | Description |
| :--------------------- | :------- | :------------------------------------------------------------------------------------------------------------------------------- |
| `walletId` | `int64` | Wallet ID |
| `orderNo` | `string` | Payout order number |
| `refundOrderNo` | `string` | Refund order number |
| `settlementAccountUID` | `int64` | Settlement account ID |
| `purpose` | `string` | See Appendix: Purpose |
| `remark` | `string` | Remark |
| `paymentWay` | `string` | Payment method: `RDT` / `CHATS` |
| `feeMode` | `int32` | Fee deduction mode. Default value: `1`. `1` = shared by both sender and receiver (SHAR); `2` = borne entirely by the payer (OUR) |
| `amount` | `string` | Settlement amount |
| `currency` | `string` | Settlement currency |
| `feeAmount` | `string` | Service fee |
| `feeCurrency` | `string` | Fee currency |
| `createTime` | `int64` | Order creation time |
| `finishTime` | `int64` | Order completion time |
| `orderStatus` | `string` | Re-settlement order status. See Appendix: Payout Order Status |
**Sample Data**
```json theme={null}
{
"walletId": 1000232233,
"orderNo": "442112731049984",
"refundOrderNo": "232112731049984",
"settlementAccountUID": 1236547995462114,
"purpose": "PMT001",
"remark": "remark",
"paymentWay": "CHATS",
"feeMode": 1,
"amount": "183",
"currency": "USD",
"feeAmount": "7",
"feeCurrency": "USD",
"createTime": 1741580889957,
"finishTime": 1741580889957,
"orderStatus": "SUCCESSFUL"
}
```
# Appendix
### Response Code
| Code | Description |
| :----- | :--------------------------------- |
| `1` | success |
| `6001` | failed, general business failure |
| `6002` | parameter error |
| `6003` | order not exist |
| `6004` | order duplicate |
| `6005` | no permissions |
| `6006` | assets not exists |
| `6101` | wallet account not exists |
| `6102` | wallet insufficient fund |
| `6103` | wallet status invalid |
| `6104` | recipient wallet unavailable |
| `6105` | recipient wallet not exists |
| `6109` | Daily payment limit exceeded |
| `6110` | Monthly collection limit exceeded |
| `6301` | provider unavailable |
| `6302` | symbol unavailable |
| `6303` | provider reject |
| `6304` | price expire time |
| `6305` | amount less than minimum amount |
| `6306` | amount greater than maximum amount |
| `6307` | outside of business hours |
| `6401` | address already exists |
| `6406` | processing |
| `6801` | duplicate request |
| `6802` | profile error |
| `6803` | reach the max limit |
### Payout Order Status
| Code | Description | Remark |
| :---------------- | :--------------------- | :---------------------------------------------- |
| `SUBMITTED` | Submitted | Order submitted |
| `CONVERTING` | Exchanging | Order exchanging |
| `SETTLING` | Settling | Exchange successful, proceeding with settlement |
| `SETTLING_FAILED` | Settlement failed | Exchange successful, settlement failed |
| `SETTLING_REFUND` | Refund processing | Refunded after successful settlement |
| `SUCCESSFUL` | Successful transaction | Order processed successfully |
| `FAILED` | Transaction failed | Order processing failed |
### Deposit Order Status
| Code | Description | Remark |
| :---------------------- | :------------------------------- | :------------------------------------------------------------------------------------------------------------ |
| `SUBMITTED` | Submitted | Order submitted |
| `VERIFYING` | Order verification | Security verification after order submission. Applies only to Request Payment |
| `AWAIT_FOR_RECEIVE` | Awaiting payment | Order created successfully and awaiting payment. Applies only to Request Payment |
| `PAYMENT_VERIFYING` | Payment verification in progress | Payment has been received by the platform and is under security verification. Applies only to Request Payment |
| `AWAIT_FOR_DECLARATION` | Additional documents required | Trade documents pending submission. Applies only to Request Payment |
| `DECLARATION_REVIEW` | Document review in progress | Document review in progress |
| `SUCCESS` | Transaction successful | Order successful |
| `FAILED` | Transaction failed | Order failed |
| `CLOSED` | Transaction closed | Order closed due to expiration |
| `RETURNING` | Refund processing | Refund processing |
| `RETURNED` | Refunded | Refund processed successfully |
| `IN_PROGRESS` | Payment verification in progress | Payment has been received by the platform and is under security verification. Applies only to Deposit |
### Order Type
| Code | Description |
| :--- | :-------------- |
| `1` | Deposit |
| `2` | Wallet Transfer |
| `4` | Request Payment |
| `5` | Withdraw |
### Field Description: amount
This field indicates the transaction amount. Its type is `string`. Precision requirements vary by currency type:
* **Digital Currency**: generally supports up to 6 decimal places to meet on-chain transaction precision requirements.
* **Fiat Currency**: generally supports up to 2 decimal places, accurate to cents.
* **Japanese Yen (JPY)**: JPY has no decimal places. The amount must be an integer and must not contain a decimal part.
Please strictly control the amount format according to the currency type to avoid precision errors or processing exceptions.
### Purpose
| Code | Description |
| :------- | :------------------------------------------------------------------------------------------------------ |
| `PMT001` | Invoice payments |
| `PMT002` | Payment for services |
| `PMT003` | Payment for software |
| `PMT004` | Payment for imported goods |
| `PMT005` | Travel services |
| `PMT006` | Transfer to own account |
| `PMT007` | Repayment of loans |
| `PMT009` | Payment of property rental |
| `PMT010` | Information Service Charges |
| `PMT011` | Advertising & Public relations-related expenses |
| `PMT012` | Royalty fees, trademark fees, patent fees, and copyright fees |
| `PMT013` | Fees for brokers, front-end fee, commitment fee, guarantee fee, and custodian fee |
| `PMT014` | Fees for advisors, technical assistance, and academic knowledge, including remuneration for specialists |
| `PMT015` | Representative office expenses |
| `PMT016` | Tax Payment |
| `PMT017` | Transportation fees for goods |
| `PMT018` | Construction costs / expenses |
| `PMT019` | Insurance Premium |
| `PMT020` | General Goods Trades - Offline trade |
| `PMT021` | Insurance Claims Payment |
| `PMT024` | Medical Treatment |
| `PMT025` | Donations |
| `PMT026` | Mutual Fund Investment |
| `PMT027` | Currency Exchange |
| `PMT028` | Advance Payments for Goods |
| `PMT029` | Merchant Settlement |
| `PMT030` | Repatriation Fund Settlement |
### Country/Region Code
[Country/Region Code](/en/others-resources/country-code)
### Industry Code
[Industry Code](/en/others-resources/industry-code)
### Profile Error Description
The following messages are returned by profile validation and grouped by module.
**\[Business details]**
* `Industry cannot be empty!`
* `Added industries exceeded limit: 3`
* `Industry code cannot be empty!`
* `Industry code does not exist!`
* `Sales turnover of last year cannot be empty!`
* `Incorrect sales turnover of last year input!`
* `Year(s) in business cannot be empty!`
* `Incorrect year(s) in business input!`
* `Location(s) of business cannot be empty!`
* `Location(s) of business exceeded limit: 3`
* `Industry details cannot be empty!`
* `Industry details exceeded maximum length`
**\[Entity details]**
* `We only support partnership business in Hong Kong`
* `We only support sole proprietorship business in Hong Kong`
* `Please enter the ciNumber.`
* `Please enter the brNumber.`
* `Operating place cannot be empty!`
* `Operating address cannot be empty!`
* `Operating address exceeded maximum length`
* `Company registered place cannot be empty!`
* `Company registered place not supported:[area name]`
* `The operating place is not supported:[area name]`
* `Company registered address cannot be empty!`
* `Company registered address maximum length`
* `Company registered address in English only`
* `Website exceeded maximum length`
* `Incorrect business type!`
* `Business registration certificate number exceeded max length`
* `Business registration certificate number cannot be empty`
* `Certificate of incorporation number exceeded maximum length`
* `Certificate of incorporation number cannot be empty`
* `Name of business in English cannot be empty!`
* `Name of business in Chinese cannot be empty!`
* `Name of business in Chinese exceeded maximum length`
* `Name of business in English exceeded maximum length`
* `Not allowed option`
* `Please upload a valid proof of Certificate of Incorporation`
* `Please upload a valid proof of Memorandum and Articles of Association`
* `Please upload a valid proof of Business Registration`
* `Please upload a valid proof of Partnership Agreement`
* `Please upload a valid proof of Certificate of Incumbency`
* `Please upload a valid proof of KYC Files`
* `Duplicated document`
* `Please enter a valid business type.`
* `Company incorporation date cannot be empty`
* `Company incorporation date cannot be empty be greater than current date:[corresponding value]`
* `Place of financial regulator cannot be empty!`
* `Incorrect place of financial regulator input!`
* `Name of regulator cannot be empty!`
* `Name of regulator exceeded maximum length`
* `Type of license cannot be empty!`
* `Type of license exceeded maximum length`
* `Incorrect place of incorporation!`
* `Sorry, the country/region is not supported yet! ... :{placeOfIncorporation}`
* `Please upload a valid proof of License/Certificate of Financial Institution`
* `Place of listing cannot be empty!`
* `Incorrect place of listing input!`
* `Name of exchange cannot be empty!`
* `Name of exchange exceeded maximum length`
* `Stock code cannot be empty!`
* `Stock code exceeded maximum length`
* `Place of government owner cannot be empty!`
* `Incorrect place of government owner input!`
**\[Key people]**
* `Email exceeded maximum length`
* `Incorrect email address format`
* `AreaCode exceeded maximum length`
* `MobileNumber exceeded maximum length`
* `Incorrect country/region of key people`
* `Incorrect country/region and idType of key people`
* `Incorrect idType`
* `The user's idv information is incomplete`
* `Last name in English exceeded maximum length`
* `Last name in English and first name in English cannot have only one value`
* `First name in English exceeded maximum length`
* `Name in Chinese exceeded maximum length`
* `idNumber exceeded maximum length`
* `Incorrect gender`
* `Please upload a valid proof of key people`
* `Please set a valid quorum`
* `Id Number[{idNumber}] was duplicate!`
* `Signer must be equal or greater than quorum`
* `Direct number has to be between 1 to 99`
* `Partner number has to be between 2 to 6`
* `Please add at least one owner`
* `Please add at most one owner`
* `Only limited company can create director`
* `Only partnership can create partner`
* `Please select at least one role for user:`
* `IsOwner is only supported by sole proprietorship`
**\[Shareholder]**
* `Shareholder structure cannot be empty`
* `Incorrect Level in sharesholder structure, only Zero to Ten Level`
* `Last name in English exceeded maximum length`
* `First name in English exceeded maximum length`
* `Name in Chinese exceeded maximum length`
* `Shareholder (company) name in English exceeded maximum length`
* `Shareholder (company) name in Chinese exceeded maximum length`
* `Shareholder (company) RegulatorName exceeded maximum length`
* `Shareholder (company) ExchangeName exceeded maximum length`
* `Shareholder (company) Stock code exceeded maximum length`
* `Incorrect ownedSharesPercent`
* `Shareholder type cannot be empty`
* `Please input correct shareholder type:{type}`
* `Shareholder (personal) name in English and Chinese cannot be empty at the same time!`
* `Shareholder (company) name cannot be empty`
* `Shareholder (company) business type cannot be empty`
* `Please input correct business type for the shareholder (company):{businessType}`
* `We only support sole proprietorship business in Hong Kong`
* `We only support partnership business in Hong Kong`
* `Shareholder (company) place of incorporate cannot be empty`
* `Incorrect shareholder (company) place of incorporate`
* `We only support company registered place for partnership and sole proprietorship in Hong Kong only`
* `Last name in English and first name in English cannot have only one value`
* `ParentId cannot be empty`
* `Listed/government owner/financial regulator not support partnership business`
* `Place of financial regulator cannot be empty!`
* `Place of financial regulator not supported!`
* `Name of regulator cannot be empty!`
* `Name of regulator exceeded maximum length`
* `Type of license cannot be empty!`
* `Type of license exceeded maximum length`
* `Listed/government owner not support sole proprietorship business`
* `Place of listing cannot be empty!`
* `Place of listing not supported!`
* `Name of exchange cannot be empty!`
* `Name of exchange exceeded maximum length`
* `Stock code cannot be empty!`
* `Stock code exceeded maximum length`
* `Place of government owner cannot be empty!`
* `Incorrect place of government owner input!`
* `Corresponding shareholder type for sameId[{id}] is different`
* `Corresponding shareholder name for sameId[{id}] is different`
* `Incorrect parentId in sharesholder structure`
* `Abnormal shareholder structure`
* `Shareholder structure cannot exceed 10 layers`
* `Shareholder structure is not necessary`
**\[Others]**
* `Customer type error.`
# Country Code
Source: https://docs.oristapay.com/en/others-resources/country-code
| **Code(ISO 3166-1 alpha-3)** | **EN: Country/Region** | **S.C.: 中文名称** | **T.C.: 繁体中文名称** |
| :--------------------------- | :------------------------------- | :------------- | :--------------- |
| MAC | Macau SAR | 澳门特别行政区 | 澳門特別行政區 |
| HKG | Hong Kong SAR | 香港特别行政区 | 香港特別行政區 |
| CHN | China | 中华人民共和国 | 中華人民共和國 |
| AFG | Afghanistan | 阿富汗 | 阿富汗 |
| ALB | Albania | 阿尔巴尼亚 | 阿爾巴尼亞 |
| DZA | Algeria | 阿尔及利亚 | 阿爾及利亞 |
| AND | Andorra | 安道尔 | 安道爾 |
| AGO | Angola | 安哥拉 | 安哥拉 |
| AIA | Anguilla | 安圭拉 | 安圭拉 |
| ATG | Antigua & Barbuda | 安提瓜和巴布达 | 安提瓜和巴布達 |
| ARG | Argentina | 阿根廷 | 阿根廷 |
| ARM | Armenia | 亚美尼亚 | 亞美尼亞 |
| ABW | Aruba | 阿鲁巴 | 阿魯巴 |
| AUS | Australia | 澳大利亚 | 澳洲 |
| AUT | Austria | 奥地利 | 奧地利 |
| AZE | Azerbaijan | 阿塞拜疆 | 阿塞拜疆 |
| BHS | Bahamas | 巴哈马 | 巴哈馬 |
| BHR | Bahrain | 巴林 | 巴林 |
| BGD | Bangladesh | 孟加拉 | 孟加拉 |
| BRB | Barbados | 巴巴多斯 | 巴巴多斯 |
| BLR | Belarus | 白俄罗斯 | 白俄羅斯 |
| BEL | Belgium | 比利时 | 比利時 |
| BLZ | Belize | 伯利兹 | 伯利茲 |
| BEN | Benin | 贝宁 | 貝寧 |
| BMU | Bermuda | 百慕大 | 百慕達 |
| BTN | Bhutan | 不丹 | 不丹 |
| BOL | Bolivia | 玻利维亚 | 玻利維亞 |
| BIH | Bosnia and Herzegovina | 波斯尼亚和黑塞哥维那 | 波斯尼亞和黑塞哥維那 |
| BWA | Botswana | 博茨瓦纳 | 博茨瓦納 |
| BRA | Brazil | 巴西 | 巴西 |
| BRN | Brunei | 文莱 | 汶萊 |
| BGR | Bulgaria | 保加利亚 | 保加利亞 |
| BFA | Burkina Faso | 布基纳法索 | 布基纳法索 |
| BDI | Burundi | 布隆迪 | 布隆迪 |
| CPV | Cabo Verde | 佛得角 | 佛得角 |
| KHM | Cambodia | 柬埔寨 | 柬埔寨 |
| CMR | Cameroon | 喀麦隆 | 喀麥隆 |
| CAN | Canada | 加拿大 | 加拿大 |
| CYM | Cayman Islands | 开曼群岛 | 開曼群島 |
| CAF | Central African Republic | 中非 | 中非 |
| TCD | Chad | 乍得 | 乍得 |
| CHL | Chile | 智利 | 智利 |
| COL | Colombia | 哥伦比亚 | 哥倫比亞 |
| COM | Comoros | 科摩罗 | 科摩羅 |
| COD | Democratic Republic of the Congo | 刚果民主共和国 | 剛果民主共和國 |
| COG | Republic of the Congo | 刚果共和国 | 剛果共和國 |
| COK | Cook Islands | 库克群岛 | 庫克群島 |
| CRI | Costa Rica | 哥斯达黎加 | 哥斯達黎加 |
| CIV | Côte d'Ivoire | 科特迪瓦 | 科特迪瓦 |
| HRV | Croatia | 克罗地亚 | 克羅地亞 |
| CUB | Cuba | 古巴 | 古巴 |
| CUW | Curaçao | 库拉索 | 庫拉索 |
| CYP | Cyprus | 塞浦路斯 | 塞浦路斯 |
| CZE | Czech Republic | 捷克 | 捷克 |
| DNK | Denmark | 丹麦 | 丹麥 |
| DJI | Djibouti | 吉布提 | 吉布提 |
| DMA | Dominica | 多米尼克 | 多米尼克 |
| DOM | Dominican Republic | 多米尼加 | 多米尼加 |
| ECU | Ecuador | 厄瓜多尔 | 厄瓜多爾 |
| EGY | Egypt | 埃及 | 埃及 |
| SLV | El Salvador | 萨尔瓦多 | 薩爾瓦多 |
| GNQ | Equatorial Guinea | 赤道几内亚 | 赤道幾內亞 |
| EST | Estonia | 爱沙尼亚 | 愛沙尼亞 |
| SWZ | Eswatini | 斯威士兰 | 斯威士蘭 |
| ETH | Ethiopia | 埃塞俄比亚 | 埃塞俄比亞 |
| FJI | Fiji | 斐济 | 斐濟 |
| FIN | Finland | 芬兰 | 芬蘭 |
| FRA | France | 法国 | 法國 |
| GAB | Gabon | 加蓬 | 加蓬 |
| GMB | Gambia | 冈比亚 | 岡比亞 |
| GEO | Georgia | 格鲁吉亚 | 格魯吉亞 |
| DEU | Germany | 德国 | 德國 |
| GHA | Ghana | 加纳 | 加納 |
| GIB | Gibraltar | 直布罗陀 | 直布羅陀 |
| GRC | Greece | 希腊 | 希臘 |
| GRD | Grenada | 格林纳达 | 格林納達 |
| GTM | Guatemala | 危地马拉 | 危地馬拉 |
| GGY | Guernsey | 根西 | 根西 |
| GIN | Guinea | 几内亚 | 幾內亞 |
| GNB | Guinea-Bissau | 几内亚比绍 | 幾內亞比紹 |
| GUY | Guyana | 圭亚那 | 圭亞那 |
| HTI | Haiti | 海地 | 海地 |
| VAT | Holy See | 圣座 | 聖座 |
| HND | Honduras | 洪都拉斯 | 洪都拉斯 |
| HUN | Hungary | 匈牙利 | 匈牙利 |
| ISL | Iceland | 冰岛 | 冰島 |
| IND | India | 印度 | 印度 |
| IDN | Indonesia | 印度尼西亚 | 印尼 |
| IRN | Iran | 伊朗 | 伊朗 |
| IRQ | Iraq | 伊拉克 | 伊拉克 |
| IRL | Ireland | 爱尔兰 | 愛爾蘭 |
| IMN | Isle of Man | 马恩岛 | 馬恩島 |
| ISR | Israel | 以色列 | 以色列 |
| ITA | Italy | 义大利 | 意大利 |
| JAM | Jamaica | 牙买加 | 牙買加 |
| JPN | Japan | 日本 | 日本 |
| JEY | Jersey | 泽西 | 澤西 |
| JOR | Jordan | 约旦 | 約旦 |
| KAZ | Kazakhstan | 哈萨克斯坦 | 哈薩克斯坦 |
| KEN | Kenya | 肯尼亚 | 肯尼亞 |
| PRK | Korea, North | 北韩 | 北韓 |
| KOR | Korea, South | 南韩 | 南韓 |
| KWT | Kuwait | 科威特 | 科威特 |
| KGZ | Kyrgyzstan | 吉尔吉斯斯坦 | 吉爾吉斯斯坦 |
| LAO | Laos | 老挝 | 老撾 |
| LVA | Latvia | 拉脱维亚 | 拉脫維亞 |
| LBN | Lebanon | 黎巴嫩 | 黎巴嫩 |
| LSO | Lesotho | 莱索托 | 萊索托 |
| LBR | Liberia | 利比里亚 | 利比里亚 |
| LBY | Libya | 利比亚 | 利比亚 |
| LIE | Liechtenstein | 列支敦斯登 | 列支敦士登 |
| LTU | Lithuania | 立陶宛 | 立陶宛 |
| LUX | Luxembourg | 卢森堡 | 盧森堡 |
| MKD | North Macedonia | 北马其顿 | 北馬其頓 |
| MDG | Madagascar | 马达加斯加 | 馬達加斯加 |
| MWI | Malawi | 马拉维 | 馬拉維 |
| MYS | Malaysia | 马来西亚 | 馬來西亞 |
| MDV | Maldives | 马尔地夫 | 馬爾代夫 |
| MLI | Mali | 马里 | 馬里 |
| MLT | Malta | 马耳他 | 馬耳他 |
| MHL | Marshall Islands | 马绍尔群岛 | 馬紹爾群島 |
| MRT | Mauritania | 毛里塔尼亚 | 毛里塔尼亞 |
| MUS | Mauritius | 毛里求斯 | 毛里求斯 |
| MEX | Mexico | 墨西哥 | 墨西哥 |
| MDA | Moldova | 摩尔多瓦 | 摩爾多瓦 |
| MCO | Monaco | 摩纳哥 | 摩納哥 |
| MNG | Mongolia | 蒙古 | 蒙古 |
| MNE | Montenegro | 黑山 | 黑山 |
| MSR | Montserrat | 蒙特塞拉特 | 蒙特塞拉特 |
| MAR | Morocco | 摩洛哥 | 摩洛哥 |
| MOZ | Mozambique | 莫桑比克 | 莫桑比克 |
| MMR | Myanmar | 缅甸 | 緬甸 |
| NAM | Namibia | 纳米比亚 | 納米比亞 |
| NRU | Nauru | 瑙鲁 | 瑙魯 |
| NPL | Nepal | 尼泊尔 | 尼泊爾 |
| NLD | Netherlands | 荷兰 | 荷蘭 |
| NZL | New Zealand | 新西兰 | 新西蘭 |
| NIC | Nicaragua | 尼加拉瓜 | 尼加拉瓜 |
| NER | Niger | 尼日尔 | 尼日爾 |
| NGA | Nigeria | 尼日利亚 | 尼日利亞 |
| NIU | Niue | 纽埃 | 紐埃 |
| NOR | Norway | 挪威 | 挪威 |
| OMN | Oman | 阿曼 | 阿曼 |
| PAK | Pakistan | 巴基斯坦 | 巴基斯坦 |
| PLW | Palau | 帕劳 | 帕勞 |
| PSE | Palestine | 巴勒斯坦 | 巴勒斯坦 |
| PAN | Panama | 巴拿马 | 巴拿馬 |
| PNG | Papua New Guinea | 巴布亚新几内亚 | 巴布亞新幾內亞 |
| PRY | Paraguay | 巴拉圭 | 巴拉圭 |
| PER | Peru | 秘鲁 | 秘魯 |
| PHL | Philippines | 菲律宾 | 菲律賓 |
| POL | Poland | 波兰 | 波蘭 |
| PRT | Portugal | 葡萄牙 | 葡萄牙 |
| QAT | Qatar | 卡塔尔 | 卡塔爾 |
| ROU | Romania | 罗马尼亚 | 羅馬尼亞 |
| RUS | Russian Federation | 俄罗斯 | 俄羅斯 |
| RWA | Rwanda | 卢旺达 | 盧旺達 |
| KNA | Saint Kitts & Nevis | 圣基茨和尼维斯 | 聖基茨和尼維斯 |
| LCA | Saint Lucia | 圣卢西亚 | 聖盧西亞 |
| VCT | Saint Vincent & Grenadines | 圣文森特和格林纳丁斯 | 聖文森特和格林納丁斯 |
| WSM | Samoa | 萨摩亚 | 薩摩亞 |
| SMR | San Marino | 圣马力诺 | 聖馬力諾 |
| STP | Sao Tome and Principe | 圣多美和普林西比 | 聖多美和普林西比 |
| SAU | Saudi Arabia | 沙特阿拉伯 | 沙特阿拉伯 |
| SEN | Senegal | 塞内加尔 | 塞內加爾 |
| SRB | Serbia | 塞尔维亚 | 塞爾維亞 |
| SYC | Seychelles | 塞舌尔 | 塞舌尔 |
| SLE | Sierra Leone | 塞拉利昂 | 塞拉利昂 |
| SGP | Singapore | 新加坡 | 新加坡 |
| SVK | Slovakia | 斯洛伐克 | 斯洛伐克 |
| SVN | Slovenia | 斯洛文尼亚 | 斯洛文尼亞 |
| SLB | Solomon Islands | 所罗门群岛 | 所羅門群島 |
| SOM | Somalia | 索马里 | 索马里 |
| ZAF | South Africa | 南非 | 南非 |
| ESP | Spain | 西班牙 | 西班牙 |
| LKA | Sri Lanka | 斯里兰卡 | 斯里兰卡 |
| SDN | Sudan | 苏丹 | 蘇丹 |
| SUR | Suriname | 苏里南 | 蘇里南 |
| SJM | Svalbard and Jan Mayen | 斯瓦尔巴群岛和扬马延岛 | 斯瓦尔巴群島和揚馬延島 |
| SWE | Sweden | 瑞典 | 瑞典 |
| CHE | Switzerland | 瑞士 | 瑞士 |
| SYR | Syria | 叙利亚 | 敘利亞 |
| TWN | Taiwan | 台湾 | 台灣 |
| TJK | Tajikistan | 塔吉克斯坦 | 塔吉克斯坦 |
| TZA | Tanzania | 坦桑尼亚 | 坦桑尼亞 |
| THA | Thailand | 泰国 | 泰國 |
| TLS | Timor-Leste | 东帝汶 | 東帝汶 |
| TGO | Togo | 多哥 | 多哥 |
| TON | Tonga | 汤加 | 湯加 |
| TTO | Trinidad and Tobago | 特立尼达和多巴哥 | 特立尼達和多巴哥 |
| TUN | Tunisia | 突尼斯 | 突尼斯 |
| TUR | Turkey | 土耳其 | 土耳其 |
| TKM | Turkmenistan | 土库曼斯坦 | 土庫曼斯坦 |
| TCA | Turks and Caicos Islands | 特克斯和凯科斯群岛 | 特克斯和凱科斯群島 |
| UGA | Uganda | 乌干达 | 烏干達 |
| UKR | Ukraine | 乌克兰 | 烏克蘭 |
| ARE | United Arab Emirates | 阿联酋 | 阿聯酋 |
| GBR | United Kingdom | 英国 | 英國 |
| USA | United States | 美国 | 美國 |
| URY | Uruguay | 乌拉圭 | 烏拉圭 |
| URY | Uruguay | 乌拉圭 | 烏拉圭 |
| UZB | Uzbekistan | 乌兹别克斯坦 | 烏茲別克斯坦 |
| VUT | Vanuatu | 瓦努阿图 | 瓦努阿圖 |
| VEN | Venezuela | 委内瑞拉 | 委內瑞拉 |
| VNM | Vietnam | 越南 | 越南 |
| VGB | Virgin Islands, British | 英属维尔京群岛 | 英屬維爾京群島 |
| YEM | Yemen | 也门 | 也门 |
| ZMB | Zambia | 赞比亚 | 赞比亚 |
| ZWE | Zimbabwe | 津巴布韦 | 津巴布韦 |
| FSM | Micronesia | 密克罗尼西亚 | 密克罗尼西亚 |
| SSD | South Sudan | 南苏丹 | 南苏丹 |
| WSM | Samoa | 萨摩亚 | 萨摩亚 |
| ERI | Eritrea | 厄立特里亚 | 厄立特里亚 |
| FRO | Faroe Islands | 法罗群岛 | 法罗群岛 |
| GUF | French Guiana | 法属圭亚那 | 法屬圭亚那 |
| PYF | French Polynesia | 法属波利尼西亚 | 法屬波利尼西亞 |
| GRL | Greenland | 格陵兰 | 格陵兰 |
| GLP | Guadeloupe | 瓜德罗普 | 瓜德罗普 |
| GUM | Guam | 关岛 | 關島 |
| KIR | Kiribati | 基里巴斯 | 基里巴斯 |
| MTQ | Martinique | 马提尼克 | 馬提尼克 |
| MYT | Mayotte | 马约特 | 馬約特 |
| NCL | New Caledonia | 新喀里多尼亚 | 新喀里多尼亞 |
| PRI | Puerto Rico | 波多黎各 | 波多黎各 |
| REU | Réunion Island | 留尼汪 | 留尼汪 |
| SPM | Saint Pierre and Miquelon | 圣皮埃尔岛及密克隆岛 | 聖皮埃爾島及密克隆島 |
| VIR | Virgin Islands, U.S. | 美属维尔京群岛 | 美屬維爾京群島 |
# Industry Code
Source: https://docs.oristapay.com/en/others-resources/industry-code
| **Code** | **Hong Kong Standard Industry Classification(2.0)** | **EN** | **S.C.** | **T.C.** |
| :------- | :-------------------------------------------------- | :--------------------------------------------------------------------------------------------------- | :----------------------------- | :------------------------------- |
| I300881 | 854400 | Academic tutoring services | 学科补习服务 | 學科補習服務 |
| I300796 | 692100 | Accounting and auditing services | 会计及核数服务 | 會計及核數服務 |
| I300916 | 920000 | Activities of amusement parks and theme parks | 游乐园及主题乐园活动 | 遊樂園及主題樂園活動 |
| I300935 | 941100 | Activities of business and employers membership organisations | 企业及雇主会员制组织活动 | 企業及雇主會員制組織活動 |
| I300847 | 822000 | Activities of call centres | 电话服务中心活动 | 電話服務中心活動 |
| I300833 | 781000 | Activities of employment placement agencies | 职业介绍代理活动 | 職業介紹代理活動 |
| I300967 | 990000 | Activities of extraterritorial organisations and bodies | 享有治外法权的组织及团体活动 | 享有治外法權的組織及團體活動 |
| I300965 | 970000 | Activities of households as employers of domestic personnel | 受聘于住户的家居活动 | 受聘于住戶的家居活動 |
| I300784 | 662200 | Activities of insurance agents and brokers | 保险代理及经纪活动 | 保險代理及經紀活動 |
| I300940 | 949000 | Activities of other membership organisations n.e.c. | 其他会员制组织活动 | 其他會員制組織活動 |
| I300939 | 944000 | Activities of political organisations | 政治组织活动 | 政治組織活動 |
| I300936 | 941200 | Activities of professional membership organisations | 专业会员制组织活动 | 專業會員制組織活動 |
| I300938 | 943000 | Activities of religious organisations | 宗教组织活动 | 宗教組織活動 |
| I300927 | 931200 | Activities of sports clubs | 体育俱乐部活动 | 體育俱樂部活動 |
| I300937 | 942000 | Activities of trade unions | 工会活动 | 工會活動 |
| I300776 | 661100 | Administration of marketplaces for securities and commodity contracts | 证券及期货市场管理 | 證券及期貨市場管理 |
| I300816 | 741100 | Advertising companies and agencies | 广告公司及代理 | 廣告公司及代理 |
| I300817 | 741900 | Advertising services n.e.c. | 其他广告服务 | 其他廣告服務 |
| I300852 | 829400 | Agents for artists, athletes, models and other public figures | 艺人、运动员、模特儿及其他公众人物代理 | 藝人、運動員、模特兒及其他公眾人物代理 |
| I300706 | 522901 | Air cargo forwarding services | 航空货运代理服务 | 航空貨運代理服務 |
| I300693 | 510900 | Air transport services n.e.c. | 其他航空运输服务 | 其他航空運輸服務 |
| I300273 | 432201 | Air-conditioning and ventilation system, installation and maintenance | 空气调节及通风系统安装及保养 | 空氣調節及通風系統安裝及保養 |
| I300208 | 303000 | Aircraft assembly and manufacture of related | 飞行器装嵌及相关机械的制造 | 飛行器裝嵌及相關機械的製造 |
| I300895 | 869200 | Allied health personnel practice activities | 医疗辅助人员执业活动 | 醫療輔助人員執業活動 |
| I300164 | 243202 | Aluminium casting | 铸铝 | 鑄鋁 |
| I300933 | 939500 | Amusement game centres | 游戏机中心 | 遊戲機中心 |
| I300269 | 432104 | Anti-burglar system, installation and maintenance | 防盗系统安装及保养 | 防盜系統安裝及保養 |
| I300011 | 32000 | Aquaculture | 水产养殖 | 水產養殖 |
| I300802 | 711100 | Architectural design services | 建筑设计服务 | 建築設計服務 |
| I300861 | 854102 | Athletic instruction | 田径技巧训练 | 田徑技巧訓練 |
| I300882 | 854901 | Automobile driving instruction | 汽车驾驶训练 | 汽車駕駛訓練 |
| I300860 | 854101 | Ball games instruction | 球类技巧训练 | 球類技巧訓練 |
| I300285 | 439903 | Bamboo scaffolding | 盖搭竹棚架 | 蓋搭竹棚架 |
| I300795 | 691200 | Barrister services | 大律师法律服务 | 大律師法律服務 |
| I300734 | 563100 | Bars and lounges | 酒吧及酒廊 | 酒吧及酒廊 |
| I300957 | 960300 | Bathhouse services | 浴室服务 | 浴室服務 |
| I300726 | 561110 | Beijing, Sichuan, Shanghai cuisine restaurants | 京、川、沪式酒楼菜馆 | 京、川、滬式酒樓菜館 |
| I300929 | 939100 | Betting activities | 博彩活动 | 博彩活動 |
| I300737 | 563900 | Beverage serving places n.e.c. | 其他饮品供应场所 | 其他飲品供應場所 |
| I300917 | 931101 | Billiard centres | 桌球中心 | 桌球中心 |
| I300058 | 131306 | Bleaching and dyeing of garment | 成衣漂染 | 成衣漂染 |
| I300057 | 131305 | Bleaching and dyeing of knitted fabrics | 针织布料漂染 | 針織布料漂染 |
| I300056 | 131304 | Bleaching and dyeing of woven fabrics | 梭织布料漂染 | 梭織布料漂染 |
| I300055 | 131303 | Bleaching and dyeing of yarn | 纱线漂染 | 紗線漂染 |
| I300204 | 290000 | Body assembly of motor vehicles | 汽车的装嵌 | 汽車的裝嵌 |
| I300958 | 960401 | Body massage services | 身体按摩服务 | 身體按摩服務 |
| I300119 | 181201 | Book binding | 书籍钉装 | 書籍釘裝 |
| I300797 | 692200 | Book-keeping and general accounting services | 簿记及一般会计服务 | 簿記及一般會計服務 |
| I300915 | 910300 | Botanical and zoological gardens, nature reserves activities | 动植物园及自然生态保护活动 | 動植物園及自然生態保護活動 |
| I300918 | 931102 | Bowling centres | 保龄球中心 | 保齡球中心 |
| I300291 | 439911 | Brick laying, tile setting and plastering | 砖瓦铺砌及批荡 | 磚瓦鋪砌及批蕩 |
| I300486 | 460100 | Brokers and agents for wholesale (incl. auctioneers) | 批发经纪及代理(包括拍卖人) | 批發經紀及代理(包括拍賣人) |
| I300171 | 259201 | Buffing, polishing and electroplating | 磨光、打磨及电镀 | 磨光、打磨及電鍍 |
| I300206 | 301200 | Building of pleasure and sporting boats | 娱乐及运动用小艇的制造 | 娛樂及運動用小艇的製造 |
| I300205 | 301100 | Building of ships and floating structures | 船舶及浮动结构体的制造 | 船舶及浮動結構體的製造 |
| I300805 | 711400 | Building services engineering services | 屋宇设备工程服务 | 屋宇設備工程服務 |
| I300798 | 701100 | Business head offices of local enterprises | 本地企业管理总办事处 | 本地企業管理總辦事處 |
| I300801 | 702200 | Business management and consultancy services | 商业管理及顾问服务 | 商業管理及顧問服務 |
| I300067 | 139204 | Button holing, seaming and pleating | 打钮门、钑骨及压褶 | 打鈕門、鈒骨及壓褶 |
| I300876 | 854206 | Calligraphy instruction | 书法教学 | 書法教學 |
| I300696 | 522101 | Car park operation | 停车场服务 | 停車場服務 |
| I300962 | 960700 | Care and training services for pets and animals | 宠物及动物的照顾及驯训服务 | 寵物及動物的照顧及馴訓服務 |
| I300710 | 522905 | Cargo inspection, sampling and weighing services | 验货、抽样检验及称量服务 | 驗貨、抽樣檢驗及稱量服務 |
| I300287 | 439905 | Carpentry | 木工 | 木工 |
| I300296 | 439916 | Carpet fitting, upholstery and wallpapering | 铺地毯、安装窗帘及裱墙纸 | 鋪地毯、安裝窗簾及裱牆紙 |
| I300162 | 243100 | Casting of iron and steel | 钢铁的铸造 | 鋼鐵的鑄造 |
| I300165 | 243299 | Casting of non-ferrous metals n.e.c. | 其他有色金属的铸造 | 其他有色金屬的鑄造 |
| I300907 | 884000 | Child day-care centres | 儿童日托中心 | 兒童日托中心 |
| I300896 | 869300 | Chinese medicine practitioners | 执业中医 | 執業中醫 |
| I300727 | 561111 | Chinese restaurants serving other Chinese cuisines | 其他中菜的中式酒楼菜馆 | 其他中菜的中式酒樓菜館 |
| I300806 | 711500 | Civil and geotechnical engineering services | 土木及土力工程服务 | 土木及土力工程服務 |
| I300891 | 862100 | Clinics | 诊所 | 診所 |
| I300735 | 563200 | Coffee shops | 咖啡店 | 咖啡店 |
| I300694 | 521100 | Cold storage | 冷藏库 | 冷藏庫 |
| I300246 | 381200 | Collection of hazardous waste | 有害废弃物的收集 | 有害廢棄物的收集 |
| I300245 | 381100 | Collection of non-hazardous waste | 无害废弃物的收集 | 無害廢棄物的收集 |
| I300282 | 439199 | Combination of interior fitting, decoration and exterior renovation and repairs for buildings | 楼房内部及外部装设、装饰、翻新及修葺的综合工程 | 樓房內部及外部裝設、裝飾、翻新及修葺的綜合工程 |
| I300809 | 711900 | Combined and other architectural, surveying and engineering services related to construction | 综合及其他与建造相关的建筑、测量及工程服务 | 綜合及其他與建造相關的建築、測量及工程服務 |
| I300272 | 432199 | Combined and other installation and maintenance of electrical and mechanical equipment | 综合及其他电器及机械设备安装及保养 | 綜合及其他電器及機械設備安裝及保養 |
| I300257 | 419900 | Combined and other miscellaneous new building construction works | 综合及其他杂项楼房新建造工程 | 綜合及其他雜項樓房新建造工程 |
| I300265 | 431299 | Combined and other site preparation works | 地盘的综合及其他预备工程 | 地盤的綜合及其他預備工程 |
| I300277 | 432299 | Combined and other ventilation, gas and water fitting, installation and maintenance | 综合及其他通风、燃气及水务设备安装及保养 | 綜合及其他通風、燃氣及水務設備安裝及保養 |
| I300845 | 821100 | Combined office administrative service activities | 综合办公室行政服务活动 | 綜合辦公室行政服務活動 |
| I300637 | 477199 | Combined retail sale of clothing, footwear and leather articles | 衣服、鞋类及皮革制品综合零售店 | 衣服、鞋類及皮革製品綜合零售店 |
| I300779 | 661203 | Commodity futures and gold bullion brokers and dealers | 商品期货及金银贸易经纪及交易商 | 商品期貨及金銀貿易經紀及交易商 |
| I300883 | 854902 | Computer application training | 计算机应用训练 | 電腦應用訓練 |
| I300283 | 439901 | Concrete work | 混凝土工程 | 混凝土工程 |
| I300258 | 421000 | Construction of civil engineering projects | 土木工程专案的修建 | 土木工程專案的修建 |
| I300703 | 522204 | Container back-up activities | 货柜后勤活动 | 貨櫃後勤活動 |
| I300700 | 522201 | Container terminal and marine cargo terminal operators | 货柜码头及货运码头营运者 | 貨櫃碼頭及貨運碼頭營運者 |
| I300581 | 471102 | Convenience stores | 便利店 | 便利店 |
| I300848 | 823000 | Convention and trade show organising services | 会议及商展筹组服务 | 會議及商展籌組服務 |
| I300886 | 854905 | Cookery instruction | 烹饪训练 | 烹飪訓練 |
| I300163 | 243201 | Copper foundries | 铸铜 | 鑄銅 |
| I300295 | 439915 | Crane operation | 吊机操作 | 吊機操作 |
| I300911 | 902000 | Creative artists, musicians and writers | 艺术创作人、音乐人及作家 | 藝術創作人、音樂人及作家 |
| I300068 | 139205 | Curtain or drapery cutting and sewing | 窗帘或帐幔的剪裁及车缝 | 窗簾或帳幔的剪裁及車縫 |
| I300216 | 321101 | Cutting and setting of precious stones | 宝石切割及镶嵌 | 寶石切割及鑲嵌 |
| I300155 | 239500 | Cutting, shaping and finishing of marble and stone | 云石及石材的切割、成形和修饰 | 雲石及石材的切割、成形和修飾 |
| I300873 | 854203 | Dance instruction | 舞蹈训练 | 舞蹈訓練 |
| I300757 | 631100 | Data processing, hosting and related activities | 资料处理、寄存及相关活动 | 資料處理、寄存及相關活動 |
| I300849 | 829100 | Debt collecting and credit reporting services | 代收帐款及信贷报告服务 | 代收帳款及信貸報告服務 |
| I300260 | 431100 | Demolition | 建筑物清拆 | 建築物清拆 |
| I300893 | 862300 | Dental practitioner activities | 牙医执业活动 | 牙醫執業活動 |
| I300584 | 471901 | Department stores | 百货公司 | 百貨公司 |
| I300764 | 641203 | Deposit-taking companies | 接受存款公司 | 接受存款公司 |
| I300753 | 620101 | Development of computer games | 计算机游戏开发 | 電腦遊戲開發 |
| I300754 | 620199 | Development of other softwares and programming activities | 其他软件开发及程序编写活动 | 其他軟體發展及程式編寫活動 |
| I300932 | 939400 | Discotheques | 的士高 | 的士高 |
| I300871 | 854201 | Drama instruction | 戏剧训练 | 戲劇訓練 |
| I300888 | 855000 | Educational support services | 教育辅助服务 | 教育輔助服務 |
| I300240 | 351000 | Electric power generation, transmission and distribution | 发电、输电及配电 | 發電、輸電及配電 |
| I300267 | 432102 | Electrical fitting with water plumbing | 电器装设兼水管铺设 | 電器裝設兼水管鋪設 |
| I300266 | 432101 | Electrical wiring and fitting | 电线铺设及电器装设 | 電線鋪設及電器裝設 |
| I300811 | 719000 | Engineering, technical and consultancy services not related to construction and real estate activiti | 其他与建造及地产活动无关的工程、技术及顾问服务 | 其他與建造及地產活動無關的工程、技術及顧問服務 |
| I300807 | 711600 | Environmental engineering services and related consultancy services | 环境工程服务及相关顾问服务 | 環境工程服務及相關顧問服務 |
| I300252 | 411000 | Erection of architectural superstructures | 建筑物上盖建造 | 建築物上蓋建造 |
| I300255 | 419200 | Erection of minor architectural superstructures | 小型建筑物兴建 | 小型建築物興建 |
| I300256 | 419300 | Erection of temporary structures | 临时建筑物兴建 | 臨時建築物興建 |
| I300733 | 562000 | Event catering and other food service activities | 聚会餐饮及其他膳食服务活动 | 聚會餐飲及其他膳食服務活動 |
| I300264 | 431204 | Excavation work | 挖泥工程 | 挖泥工程 |
| I300343 | 451425 | Export trading of Chinese drugs and herbs | 中成药及中草药出口贸易 | 中成藥及中草藥出口貿易 |
| I300362 | 451448 | Export trading of Chinese religious articles | 中式宗教物品出口贸易 | 中式宗教物品出口貿易 |
| I300375 | 451621 | Export trading of agricultural machinery, equipment and supplies | 农业机械、设备及其配备出口贸易 | 農業機械、設備及其配備出口貿易 |
| I300308 | 451299 | Export trading of agricultural products and live animals n.e.c. | 其他农产品及活动物出口贸易 | 其他農產品及活動物出口貿易 |
| I300327 | 451323 | Export trading of alcoholic drinks | 酒类饮品出口贸易 | 酒類飲品出口貿易 |
| I300339 | 451421 | Export trading of antiques and works of art and craft | 古玩及工艺品出口贸易 | 古玩及工藝品出口貿易 |
| I300340 | 451422 | Export trading of bamboo and cane products (excl. furniture and fixtures) | 竹制品及藤制品出口贸易(家具及固定装置除外) | 竹製品及藤製品出口貿易(傢俱及固定裝置除外) |
| I300373 | 451612 | Export trading of blank audio and video tapes, diskettes, CDs and DVDs | 空白录音带、录影带、磁盘、光盘及数码视盘出口贸易 | 空白錄音帶、錄影帶、磁片、光碟及數碼視訊光碟出口貿易 |
| I300341 | 451423 | Export trading of books, periodicals and newspapers | 书报及期刊出口贸易 | 書報及期刊出口貿易 |
| I300309 | 451301 | Export trading of canned foods | 罐头食品出口贸易 | 罐頭食品出口貿易 |
| I300380 | 451635 | Export trading of cases and other parts for watches and clocks | 钟表壳及其他钟表零件出口贸易 | 鐘錶殼及其他鐘錶零件出口貿易 |
| I300388 | 451741 | Export trading of chemicals and allied products | 化学原料及有关产品出口贸易 | 化學原料及有關產品出口貿易 |
| I300342 | 451424 | Export trading of china, earthenware and glassware | 陶瓷及玻璃制品出口贸易 | 陶瓷及玻璃製品出口貿易 |
| I300359 | 451445 | Export trading of computer games | 计算机游戏出口贸易 | 電腦遊戲出口貿易 |
| I300371 | 451602 | Export trading of computer software | 计算机软件包出口贸易 | 電腦套裝軟體出口貿易 |
| I300370 | 451601 | Export trading of computers and computer peripheral equipment | 计算机及计算机接口设备出口贸易 | 電腦及電腦周邊設備出口貿易 |
| I300310 | 451302 | Export trading of confectioneries and biscuits | 糖果及饼干出口贸易 | 糖果及餅乾出口貿易 |
| I300386 | 451721 | Export trading of construction materials, hardware and plumbing equipment and supplies | 建材、五金、水管设备及其配备出口贸易 | 建材、五金、水管設備及其配備出口貿易 |
| I300344 | 451426 | Export trading of cooking and kitchen utensils, other than electrical | 非电动的煮食及厨房用具出口贸易 | 非電動的煮食及廚房用具出口貿易 |
| I300347 | 451431 | Export trading of cosmetics and perfumes | 化妆品及香水出口贸易 | 化妝品及香水出口貿易 |
| I300302 | 451202 | Export trading of cotton, textile fibre and yarn | 棉花、纺织纤维及纱线出口贸易 | 棉花、紡織纖維及紗線出口貿易 |
| I300311 | 451303 | Export trading of dairy products | 乳类制品出口贸易 | 乳類製品出口貿易 |
| I300346 | 451428 | Export trading of drugs and pharmaceuticals (excl. Chinese drugs and herbs) | 药物出口贸易(中成药及中草药除外) | 藥物出口貿易(中成藥及中草藥除外) |
| I300312 | 451304 | Export trading of edible oils | 食油出口贸易 | 食油出口貿易 |
| I300314 | 451306 | Export trading of eggs | 蛋类出口贸易 | 蛋類出口貿易 |
| I300364 | 451452 | Export trading of electrical goods (excl. machinery, office and telecommunications equipment and app | 电器出口贸易(机械、办公室及电讯设备及器材除外) | 電器出口貿易(機械、辦公室及電訊設備及器材除外) |
| I300374 | 451613 | Export trading of electronic parts | 电子零件出口贸易 | 電子零件出口貿易 |
| I300334 | 451405 | Export trading of embroidery and drawn works | 刺绣及抽纱制品出口贸易 | 刺繡及抽紗製品出口貿易 |
| I300331 | 451402 | Export trading of fabrics | 布料出口贸易 | 布料出口貿易 |
| I300315 | 451307 | Export trading of feeds for animals and pets | 动物及宠物饲料出口贸易 | 動物及寵物飼料出口貿易 |
| I300382 | 451701 | Export trading of firewood, charcoal, coke and similar fuels | 柴炭煤类燃料出口贸易 | 柴炭煤類燃料出口貿易 |
| I300316 | 451308 | Export trading of fish and other sea products, dried or preserved | 经干制或腌制的鱼类及其他海产食品出口贸易 | 經幹制或醃制的魚類及其他海產食品出口貿易 |
| I300317 | 451311 | Export trading of fish and other sea products, fresh or frozen | 新鲜或急冻的鱼类及其他海产食品出口贸易 | 新鮮或急凍的魚類及其他海產食品出口貿易 |
| I300330 | 451401 | Export trading of footwear and shoe accessories | 鞋及鞋类配件出口贸易 | 鞋及鞋類配件出口貿易 |
| I300306 | 451206 | Export trading of fresh flowers and plants | 鲜花及植物出口贸易 | 鮮花及植物出口貿易 |
| I300318 | 451312 | Export trading of fruits and vegetables, fresh | 新鲜蔬果出口贸易 | 新鮮蔬果出口貿易 |
| I300387 | 451731 | Export trading of furniture and fixtures | 家具及固定装置出口贸易 | 傢俱及固定裝置出口貿易 |
| I300328 | 451324 | Export trading of groceries of general provisions | 一般粮油食品出口贸易 | 一般糧油食品出口貿易 |
| I300350 | 451434 | Export trading of hardware and metalware | 五金器具及金属配件出口贸易 | 五金器具及金屬配件出口貿易 |
| I300365 | 451499 | Export trading of household goods n.e.c. | 其他家庭用品出口贸易 | 其他家庭用品出口貿易 |
| I300335 | 451406 | Export trading of household linen, drapery, carpets, rugs and allied products | 日用寝具织品、帐幔、地毡、围毡及同类制品出口贸易 | 日用寢具織品、帳幔、地氈、圍氈及同類製品出口貿易 |
| I300349 | 451433 | Export trading of imitation jewellery and related articles | 人造珠宝及相关物品出口贸易 | 人造珠寶及相關物品出口貿易 |
| I300348 | 451432 | Export trading of jewellery and precious metal accessories | 珠宝首饰及贵金属装饰物出口贸易 | 珠寶首飾及貴金屬裝飾物出口貿易 |
| I300303 | 451203 | Export trading of leather (incl. imitation leather and other plastic sheetings) | 皮革出口贸易(包括人造皮及其他塑料皮) | 皮革出口貿易(包括人造皮及其他塑膠皮) |
| I300301 | 451201 | Export trading of livestock and poultry | 禽畜出口贸易 | 禽畜出口貿易 |
| I300338 | 451411 | Export trading of luggage cases, handbags and similar articles of leather or leather substitutes | 皮革或类似材料制的行李箱、手袋及同类物品出口贸易 | 皮革或類似材料制的行李箱、手袋及同類物品出口貿易 |
| I300381 | 451699 | Export trading of machinery and equipment n.e.c. (except furniture) | 其他机械及设备出口贸易(家具除外) | 其他機械及設備出口貿易(傢俱除外) |
| I300319 | 451313 | Export trading of meat, fresh or frozen (incl. poultry and meat of wild animals) | 新鲜或急冻肉类出口贸易(包括家禽肉类及野味) | 新鮮或急凍肉類出口貿易(包括家禽肉類及野味) |
| I300324 | 451318 | Export trading of meat, roasted, dried or preserved | 经烤制、干制或腌制的肉类出口贸易 | 經烤制、幹制或醃制的肉類出口貿易 |
| I300378 | 451633 | Export trading of medical, health and hospital equipment and supplies | 医疗、卫生及医院设备与用品出口贸易 | 醫療、衛生及醫院設備與用品出口貿易 |
| I300385 | 451711 | Export trading of metals and metal ores | 金属及金属矿出口贸易 | 金屬及金屬礦出口貿易 |
| I300366 | 451501 | Export trading of motor vehicles | 汽车出口贸易 | 汽車出口貿易 |
| I300367 | 451502 | Export trading of motorcycles | 电单车出口贸易 | 電單車出口貿易 |
| I300356 | 451442 | Export trading of musical instruments | 乐器出口贸易 | 樂器出口貿易 |
| I300320 | 451314 | Export trading of noodles and rice sticks | 粉面出口贸易 | 粉面出口貿易 |
| I300313 | 451305 | Export trading of nuts, seeds and dried beans | 食用硬壳果、果仁及干豆出口贸易 | 食用硬殼果、果仁及幹豆出口貿易 |
| I300379 | 451634 | Export trading of office appliances and equipment (excl. computers, furniture and fixtures) | 办公室器材及设备出口贸易(计算机、家具及固定装置除外) | 辦公室器材及設備出口貿易(電腦、傢俱及固定裝置除外) |
| I300383 | 451702 | Export trading of oil fuels and lubricants | 燃油及润滑油出口贸易 | 燃油及潤滑油出口貿易 |
| I300392 | 451799 | Export trading of other specialised products n.e.c. | 其他专卖产品出口贸易 | 其他專賣產品出口貿易 |
| I300369 | 451599 | Export trading of other transport equipment (except motor vehicles and motorcycles) | 其他运输设备出口贸易(汽车及电单车除外) | 其他運輸設備出口貿易(汽車及電單車除外) |
| I300389 | 451742 | Export trading of paints and varnishes | 油漆及清漆出口贸易 | 油漆及清漆出口貿易 |
| I300390 | 451743 | Export trading of paper for industrial use and printing | 工业及印刷用纸出口贸易 | 工業及印刷用紙出口貿易 |
| I300361 | 451447 | Export trading of paper products | 纸制品出口贸易 | 紙製品出口貿易 |
| I300368 | 451503 | Export trading of parts and accessories of motor vehicles and motorcycles | 汽车及电单车配件及零件出口贸易 | 汽車及電單車配件及零件出口貿易 |
| I300307 | 451207 | Export trading of pet animals (incl. aquarium fish) | 宠物动物(包括观赏鱼类)出口贸易 | 寵物動物(包括觀賞魚類)出口貿易 |
| I300384 | 451703 | Export trading of petroleum products (kerosene and L.P. gas) | 石油产品(火水及石油气)出口贸易 | 石油產品(火水及石油氣)出口貿易 |
| I300352 | 451436 | Export trading of photographic equipment and supplies | 摄影器材及用品出口贸易 | 攝影器材及用品出口貿易 |
| I300363 | 451451 | Export trading of plastic products (incl. decorative ornaments and flowers) | 塑料制品出口贸易(包括塑料饰物及塑料花) | 塑膠製品出口貿易(包括塑膠飾物及塑膠花) |
| I300325 | 451321 | Export trading of preserved provisions and spices | 经腌制的食品及香料出口贸易 | 經醃制的食品及香料出口貿易 |
| I300353 | 451437 | Export trading of recorded audio and video tapes, CDs, DVDs and similar media | 已录制资料的录音带、录影带、光盘、数码视盘及类似媒体出口贸易 | 已錄制資料的錄音帶、錄影帶、光碟、數碼視訊光碟及類似媒體出口貿易 |
| I300321 | 451315 | Export trading of rice | 食米出口贸易 | 食米出口貿易 |
| I300336 | 451407 | Export trading of rope, cord and netting appliances | 绳索及网类用具出口贸易 | 繩索及網類用具出口貿易 |
| I300304 | 451204 | Export trading of rubber | 橡胶出口贸易 | 橡膠出口貿易 |
| I300354 | 451438 | Export trading of sacks and bags (excl. handbags and travelling bags) | 袋类制品出口贸易(手袋及旅行袋除外) | 袋類製品出口貿易(手袋及旅行袋除外) |
| I300376 | 451631 | Export trading of scientific and professional instruments (excl. medical and dental instruments) | 科学及专业仪器出口贸易(医疗及牙科仪器除外) | 科學及專業儀器出口貿易(醫療及牙科儀器除外) |
| I300377 | 451632 | Export trading of sewing machines and parts (incl. stands) | 衣车及其零件出口贸易(包括衣车架) | 衣車及其零件出口貿易(包括衣車架) |
| I300329 | 451399 | Export trading of specialised food n.e.c. | 其他专门食品出口贸易 | 其他專門食品出口貿易 |
| I300351 | 451435 | Export trading of spectacles and optical supplies | 眼镜及光学用品出口贸易 | 眼鏡及光學用品出口貿易 |
| I300357 | 451443 | Export trading of sports goods | 体育用品出口贸易 | 體育用品出口貿易 |
| I300355 | 451441 | Export trading of stationery | 文具出口贸易 | 文具出口貿易 |
| I300322 | 451316 | Export trading of sugar and flour | 糖及面粉出口贸易 | 糖及麵粉出口貿易 |
| I300332 | 451403 | Export trading of tailoring accessories and trimming materials | 缝纫用辅件及饰料出口贸易 | 縫紉用輔件及飾料出口貿易 |
| I300323 | 451317 | Export trading of tea, coffee and cocoa | 茶叶、咖啡及可可出口贸易 | 茶葉、咖啡及可哥出口貿易 |
| I300372 | 451611 | Export trading of telecommunications equipment | 电讯设备出口贸易 | 電訊設備出口貿易 |
| I300326 | 451322 | Export trading of tobacco, cigarettes and cigars | 烟草、香烟及雪茄烟出口贸易 | 煙草、香煙及雪茄煙出口貿易 |
| I300345 | 451427 | Export trading of toilet preparations and cleaning materials | 卫浴用剂及清洁剂料出口贸易 | 衛浴用劑及清潔劑料出口貿易 |
| I300358 | 451444 | Export trading of toys | 玩具出口贸易 | 玩具出口貿易 |
| I300337 | 451408 | Export trading of umbrellas | 雨伞出口贸易 | 雨傘出口貿易 |
| I300391 | 451744 | Export trading of waste and scrap | 废物及废料出口贸易 | 廢物及廢料出口貿易 |
| I300360 | 451446 | Export trading of watches and clocks | 钟表出口贸易 | 鐘錶出口貿易 |
| I300333 | 451404 | Export trading of wearing apparel | 服装出口贸易 | 服裝出口貿易 |
| I300305 | 451205 | Export trading of wood and rattan | 木材及藤料出口贸易 | 木材及藤料出口貿易 |
| I300300 | 451100 | Export trading on a fee or contract basis | 按收费或以合约形式的出口贸易 | 按收費或以合約形式的出口貿易 |
| I300281 | 439102 | Exterior renovation and repairs for buildings | 楼房外部翻新及修葺 | 樓房外部翻新及修葺 |
| I300013 | 60000 | Extraction of crude petroleum and natural gas | 原油及天然气的开采 | 原油及天然氣的開採 |
| I300821 | 751300 | Fashion design services (incl. accessories) | 时装设计服务(包括配饰) | 時裝設計服務(包括配飾) |
| I300729 | 561200 | Fast food cafes | 快餐店 | 速食店 |
| I300297 | 439917 | Fencing, railing and related metal structure installation | 栏栅、路轨及有关金属结构安装 | 欄柵、路軌及有關金屬結構安裝 |
| I300768 | 649100 | Financial leasing | 融资租赁 | 融資租賃 |
| I300268 | 432103 | Fire alarm and fire fighting equipment, installation and maintenance | 火警及灭火设备安装及保养 | 火警及滅火設備安裝及保養 |
| I300010 | 31000 | Fishing | 捕鱼 | 捕魚 |
| I300292 | 439912 | Floor laying (excl. setting floor tiles) | 地板铺砌(地面瓷砖铺砌除外) | 地板鋪砌(地面瓷磚鋪砌除外) |
| I300959 | 960402 | Foot reflexology | 足底按摩 | 足底按摩 |
| I300924 | 931108 | Football and athletics pitches | 足球及田径场 | 足球及田徑場 |
| I300009 | 20000 | Forestry activities | 林业活动 | 林業活動 |
| I300170 | 259100 | Forging, pressing, stamping and roll-forming of metal; powder metallurgy | 金属的锻造、压制、压印和轧制;粉末冶金 | 金屬的鍛造、壓制、壓印和軋製;粉末冶金 |
| I300262 | 431202 | Foundation works | 地基工程 | 地基工程 |
| I300723 | 561107 | French cuisine restaurants | 法式餐馆 | 法式餐館 |
| I300786 | 663000 | Fund management | 基金管理 | 基金管理 |
| I300963 | 960800 | Funeral and related activities | 敛葬及相关活动 | 殮葬及相關活動 |
| I300059 | 131307 | Garment washing (excl. laundering) | 成衣洗水(不包括衣服洗熨) | 成衣洗水(不包括衣服洗熨) |
| I300276 | 432204 | Gas fitting, installation and maintenance | 燃气供应系统装设、安装及保养 | 燃氣供應系統裝設、安裝及保養 |
| I300814 | 729000 | General and miscellaneous research and development services | 综合及杂项研究及发展服务 | 綜合及雜項研究及發展服務 |
| I300695 | 521200 | General cargo warehouses | 通用货仓 | 通用貨倉 |
| I300842 | 812100 | General cleaning of buildings | 一般楼房清洁服务 | 一般樓房清潔服務 |
| I300878 | 854208 | General fine arts and performing arts schools (except academic) | 综合美术及表演艺术学校(学术除外) | 綜合美術及表演藝術學校(學術除外) |
| I300869 | 854112 | General sports skills training | 综合运动技巧训练 | 綜合運動技巧訓練 |
| I300925 | 931111 | General-purposes sports centres | 综合运动场馆 | 綜合運動場館 |
| I300960 | 960500 | Geomancy, fortune telling and spiritualist services | 堪舆、运程卜算及灵异服务 | 堪輿、運程蔔算及靈異服務 |
| I300217 | 321102 | Goldsmithing and silversmithing | 打金及打银 | 打金及打銀 |
| I300922 | 931106 | Golf centres | 高尔夫球场 | 高爾夫球場 |
| I300966 | 980000 | Goods- and services-producing activities of private households for own use | 用以自给的私人家庭商品及劳务生产活动 | 用以自給的私人家庭商品及勞務生產活動 |
| I300854 | 841000 | Government administration; economic and social policy | 政府行政;经济及社会政策 | 政府行政;經濟及社會政策 |
| I300582 | 471103 | Grocery stores of Chinese provisions | 一般粮油食品零售店 | 一般糧油食品零售店 |
| I300583 | 471104 | Grocery stores of general provisions | 士多及办馆 | 士多及辦館 |
| I300001 | 120002 | Growing of fruits, drug and beverage crops and other perennial crops | 水果、药用与饮料作物及其他多年生农作物的种植 | 水果、藥用與飲料作物及其他多年生農作物的種植 |
| I300000 | 11000 | Growing of vegetables, melons, flowers and other non-perennial crops | 瓜菜、花卉及其他非多年生农作物的种植 | 瓜菜、花卉及其他非多年生農作物的種植 |
| I300725 | 561109 | Guangdong cuisine restaurants | 粤式酒楼菜馆 | 粵式酒樓菜館 |
| I300717 | 550900 | Guesthouses, boarding houses and other short term accommodation activities | 宾馆、旅舍及其他短期住宿活动 | 賓館、旅舍及其他短期住宿活動 |
| I300921 | 931105 | Gymnasium and fitness centres | 体操及健身中心 | 體操及健身中心 |
| I300953 | 960201 | Hairdressing treatment | 理发服务 | 理發服務 |
| I300799 | 701200 | Head/Regional offices of enterprises operating aboard | 在境外营运的企业地区总办事处 | 在境外營運的企業地區總辦事處 |
| I300736 | 563300 | Herb tea shops | 凉茶铺 | 涼茶鋪 |
| I300718 | 561101 | Hong Kong style tea cafes | 港式茶餐厅 | 港式茶餐廳 |
| I300690 | 510100 | Hong Kong-based airline and helicopter companies | 以香港作基地的航空公司及直升机公司 | 以香港作基地的航空公司及直升機公司 |
| I300889 | 861100 | Hospitals | 医院 | 醫院 |
| I300716 | 550100 | Hotels | 酒店 | 酒店 |
| I300008 | 17000 | Hunting, trapping and related service activities | 狩猎、捕捉及相关服务活动 | 狩獵、捕捉及相關服務活動 |
| I300033 | 107901 | Ice manufacture (excl. dry ice) | 生雪的制造(干冰除外) | 生雪的製造(乾冰除外) |
| I300437 | 452425 | Import for wholesale of Chinese drugs and herbs | 中成药及中草药进口批发 | 中成藥及中草藥進口批發 |
| I300456 | 452448 | Import for wholesale of Chinese religious articles | 中式宗教物品进口批发 | 中式宗教物品進口批發 |
| I300469 | 452621 | Import for wholesale of agricultural machinery, equipment and supplies | 农业机械、设备及其配备进口批发 | 農業機械、設備及其配備進口批發 |
| I300402 | 452299 | Import for wholesale of agricultural products and live animals n.e.c. | 其他农产品及活动物进口批发 | 其他農產品及活動物進口批發 |
| I300421 | 452323 | Import for wholesale of alcoholic drinks | 酒类饮品进口批发 | 酒類飲品進口批發 |
| I300433 | 452421 | Import for wholesale of antiques and works of art and craft | 古玩及工艺品进口批发 | 古玩及工藝品進口批發 |
| I300434 | 452422 | Import for wholesale of bamboo and cane products (excl. furniture and fixtures) | 竹制品及藤制品进口批发(家具及固定装置除外) | 竹製品及藤製品進口批發(傢俱及固定裝置除外) |
| I300467 | 452612 | Import for wholesale of blank audio and video tapes, diskettes, CDs and DVDs | 空白录音带、录影带、磁盘、光盘及数码视盘进口批发 | 空白錄音帶、錄影帶、磁片、光碟及數碼視訊光碟進口批發 |
| I300435 | 452423 | Import for wholesale of books, periodicals and newspapers | 书报及期刊进口批发 | 書報及期刊進口批發 |
| I300403 | 452301 | Import for wholesale of canned foods | 罐头食品进口批发 | 罐頭食品進口批發 |
| I300474 | 452635 | Import for wholesale of cases and other parts for watches and clocks | 钟表壳及其他钟表零件进口批发 | 鐘錶殼及其他鐘錶零件進口批發 |
| I300480 | 452741 | Import for wholesale of chemicals and allied products | 化学原料及有关产品进口批发 | 化學原料及有關產品進口批發 |
| I300436 | 452424 | Import for wholesale of china, earthenware and glassware | 陶瓷及玻璃制品进口批发 | 陶瓷及玻璃製品進口批發 |
| I300453 | 452445 | Import for wholesale of computer games | 计算机游戏进口批发 | 電腦遊戲進口批發 |
| I300465 | 452602 | Import for wholesale of computer software | 计算机软件包进口批发 | 電腦套裝軟體進口批發 |
| I300464 | 452601 | Import for wholesale of computers and computer peripheral equipment | 计算机及计算机接口设备进口批发 | 電腦及電腦周邊設備進口批發 |
| I300404 | 452302 | Import for wholesale of confectioneries and biscuits | 糖果及饼干进口批发 | 糖果及餅乾進口批發 |
| I300438 | 452426 | Import for wholesale of cooking and kitchen utensils, other than electrical | 非电动的煮食及厨房用具进口批发 | 非電動的煮食及廚房用具進口批發 |
| I300441 | 452431 | Import for wholesale of cosmetics and perfumes | 化妆品及香水进口批发 | 化妝品及香水進口批發 |
| I300396 | 452202 | Import for wholesale of cotton, textile fibre and yarn | 棉花、纺织纤维及纱线进口批发 | 棉花、紡織纖維及紗線進口批發 |
| I300405 | 452303 | Import for wholesale of dairy products | 乳类制品进口批发 | 乳類製品進口批發 |
| I300440 | 452428 | Import for wholesale of drugs and pharmaceuticals (excl. Chinese drugs and herbs) | 药物进口批发(中成药及中草药除外) | 藥物進口批發(中成藥及中草藥除外) |
| I300406 | 452304 | Import for wholesale of edible oils | 食油进口批发 | 食油進口批發 |
| I300408 | 452306 | Import for wholesale of eggs | 蛋类进口批发 | 蛋類進口批發 |
| I300458 | 452452 | Import for wholesale of electrical goods (excl. machinery, office and telecommunications equipment a | 电器进口批发(机械、办公室及电讯设备及器材除外) | 電器進口批發(機械、辦公室及電訊設備及器材除外) |
| I300468 | 452613 | Import for wholesale of electronic parts | 电子零件进口批发 | 電子零件進口批發 |
| I300428 | 452405 | Import for wholesale of embroidery and drawn works | 刺绣及抽纱制品进口批发 | 刺繡及抽紗製品進口批發 |
| I300425 | 452402 | Import for wholesale of fabrics | 布料进口批发 | 布料進口批發 |
| I300409 | 452307 | Import for wholesale of feeds for animals and pets | 动物及宠物饲料进口批发 | 動物及寵物飼料進口批發 |
| I300475 | 452701 | Import for wholesale of firewood, charcoal, coke and similar fuels | 柴炭煤类燃料进口批发 | 柴炭煤類燃料進口批發 |
| I300410 | 452308 | Import for wholesale of fish and other sea products, dried or preserved | 经干制或腌制的鱼类及其他海产食品进口批发 | 經幹制或醃制的魚類及其他海產食品進口批發 |
| I300411 | 452311 | Import for wholesale of fish and other sea products, fresh or frozen | 新鲜或急冻的鱼类及其他海产食品进口批发 | 新鮮或急凍的魚類及其他海產食品進口批發 |
| I300424 | 452401 | Import for wholesale of footwear and shoe accessories | 鞋及鞋类配件进口批发 | 鞋及鞋類配件進口批發 |
| I300400 | 452206 | Import for wholesale of fresh flowers and plants | 鲜花及植物进口批发 | 鮮花及植物進口批發 |
| I300412 | 452312 | Import for wholesale of fruits and vegetables, fresh | 新鲜蔬果进口批发 | 新鮮蔬果進口批發 |
| I300479 | 452731 | Import for wholesale of furniture and fixtures | 家具及固定装置进口批发 | 傢俱及固定裝置進口批發 |
| I300422 | 452324 | Import for wholesale of groceries of general provisions | 一般粮油食品进口批发 | 一般糧油食品進口批發 |
| I300459 | 452499 | Import for wholesale of household goods n.e.c. | 其他家庭用品进口批发 | 其他家庭用品進口批發 |
| I300429 | 452406 | Import for wholesale of household linen, drapery, carpets, rugs and allied products | 日用寝具织品、帐幔、地毡、围毡及同类制品进口批发 | 日用寢具織品、帳幔、地氈、圍氈及同類製品進口批發 |
| I300443 | 452433 | Import for wholesale of imitation jewellery and | 人造珠宝及相关物品进口批发 | 人造珠寶及相關物品進口批發 |
| I300442 | 452432 | Import for wholesale of jewellery and precious metal accessories | 珠宝首饰及贵金属装饰物进口批发 | 珠寶首飾及貴金屬裝飾物進口批發 |
| I300397 | 452203 | Import for wholesale of leather (incl. imitation leather and other plastic sheetings) | 皮革进口批发(包括人造皮及其他塑料皮) | 皮革進口批發(包括人造皮及其他塑膠皮) |
| I300395 | 452201 | Import for wholesale of livestock and poultry | 禽畜进口批发 | 禽畜進口批發 |
| I300432 | 452411 | Import for wholesale of luggage cases, handbags and similar articles of leather or leather substitut | 皮革或类似材料制的行李箱、手袋及同类物品进口批发 | 皮革或類似材料制的行李箱、手袋及同類物品進口批發 |
| I300413 | 452313 | Import for wholesale of meat, fresh or frozen (incl. poultry and meat of wild animals) | 新鲜或急冻肉类进口批发(包括家禽肉类及野味) | 新鮮或急凍肉類進口批發(包括家禽肉類及野味) |
| I300418 | 452318 | Import for wholesale of meat, roasted, dried or preserved | 经烤制、干制或腌制的肉类进口批发 | 經烤制、幹制或醃制的肉類進口批發 |
| I300472 | 452633 | Import for wholesale of medical, health and hospital equipment and supplies | 医疗、卫生及医院设备与用品进口批发 | 醫療、衛生及醫院設備與用品進口批發 |
| I300478 | 452711 | Import for wholesale of metals and metal ores | 金属及金属矿进口批发 | 金屬及金屬礦進口批發 |
| I300460 | 452501 | Import for wholesale of motor vehicles | 汽车进口批发 | 汽車進口批發 |
| I300461 | 452502 | Import for wholesale of motorcycles | 电单车进口批发 | 電單車進口批發 |
| I300450 | 452442 | Import for wholesale of musical instruments | 乐器进口批发 | 樂器進口批發 |
| I300414 | 452314 | Import for wholesale of noodles and rice sticks | 粉面进口批发 | 粉面進口批發 |
| I300407 | 452305 | Import for wholesale of nuts, seeds and dried beans | 食用硬壳果、果仁及干豆进口批发 | 食用硬殼果、果仁及幹豆進口批發 |
| I300473 | 452634 | Import for wholesale of office appliances and equipment (excl. computers, furniture and fixtures) | 办公室器材及设备进口批发(计算机、家具及固定装置除外) | 辦公室器材及設備進口批發(電腦、傢俱及固定裝置除外) |
| I300476 | 452702 | Import for wholesale of oil fuels and lubricants | 燃油及润滑油进口批发 | 燃油及潤滑油進口批發 |
| I300484 | 452799 | Import for wholesale of other specialised products n.e.c. | 其他专卖产品进口批发 | 其他專賣產品進口批發 |
| I300463 | 452599 | Import for wholesale of other transport equipment (except motor vehicles and motorcycles) | 其他运输设备进口批发(汽车及电单车除外) | 其他運輸設備進口批發(汽車及電單車除外) |
| I300481 | 452742 | Import for wholesale of paints and varnishes | 油漆及清漆进口批发 | 油漆及清漆進口批發 |
| I300482 | 452743 | Import for wholesale of paper for industrial use and printing | 工业及印刷用纸进口批发 | 工業及印刷用紙進口批發 |
| I300455 | 452447 | Import for wholesale of paper products | 纸制品进口批发 | 紙製品進口批發 |
| I300462 | 452503 | Import for wholesale of parts and accessories of motor vehicles and motorcycles | 汽车及电单车配件及零件进口批发 | 汽車及電單車配件及零件進口批發 |
| I300401 | 452207 | Import for wholesale of pet animals (incl. aquarium fish) | 宠物动物(包括观赏鱼类)进口批发 | 寵物動物(包括觀賞魚類)進口批發 |
| I300477 | 452703 | Import for wholesale of petroleum products (kerosene and L.P. gas) | 石油产品(火水及石油气)进口批发 | 石油產品(火水及石油氣)進口批發 |
| I300446 | 452436 | Import for wholesale of photographic equipment and supplies | 摄影器材及用品进口批发 | 攝影器材及用品進口批發 |
| I300457 | 452451 | Import for wholesale of plastic products (incl. decorative ornaments and flowers) | 塑料制品进口批发(包括塑料饰物及塑料花) | 塑膠製品進口批發(包括塑膠飾物及塑膠花) |
| I300419 | 452321 | Import for wholesale of preserved provisions and spices | 经腌制的食品及香料进口批发 | 經醃制的食品及香料進口批發 |
| I300447 | 452437 | Import for wholesale of recorded audio and video tapes, CDs, DVDs and similar media | 已录制资料的录音带、录影带、光盘、数码视盘及类似媒体进口批发 | 已錄制資料的錄音帶、錄影帶、光碟、數碼視訊光碟及類似媒體進口批發 |
| I300415 | 452315 | Import for wholesale of rice | 食米进口批发 | 食米進口批發 |
| I300430 | 452407 | Import for wholesale of rope, cord and netting appliances | 绳索及网类用具进口批发 | 繩索及網類用具進口批發 |
| I300398 | 452204 | Import for wholesale of rubber | 橡胶进口批发 | 橡膠進口批發 |
| I300448 | 452438 | Import for wholesale of sacks and bags (excl. handbags and travelling bags) | 袋类制品进口批发(手袋及旅行袋除外) | 袋類製品進口批發(手袋及旅行袋除外) |
| I300470 | 452631 | Import for wholesale of scientific and professional instruments (excl. medical and dental instrument | 科学及专业仪器进口批发(医疗及牙科仪器除外) | 科學及專業儀器進口批發(醫療及牙科儀器除外) |
| I300471 | 452632 | Import for wholesale of sewing machines and parts (incl. stands) | 衣车及其零件进口批发(包括衣车架) | 衣車及其零件進口批發(包括衣車架) |
| I300423 | 452399 | Import for wholesale of specialised food n.e.c. | 其他专门食品进口批发 | 其他專門食品進口批發 |
| I300445 | 452435 | Import for wholesale of spectacles and optical supplies | 眼镜及光学用品进口批发 | 眼鏡及光學用品進口批發 |
| I300451 | 452443 | Import for wholesale of sports goods | 体育用品进口批发 | 體育用品進口批發 |
| I300449 | 452441 | Import for wholesale of stationery | 文具进口批发 | 文具進口批發 |
| I300416 | 452316 | Import for wholesale of sugar and flour | 糖及面粉进口批发 | 糖及麵粉進口批發 |
| I300426 | 452403 | Import for wholesale of tailoring accessories and trimming materials | 缝纫用辅件及饰料进口批发 | 縫紉用輔件及飾料進口批發 |
| I300417 | 452317 | Import for wholesale of tea, coffee and cocoa | 茶叶、咖啡及可可进口批发 | 茶葉、咖啡及可哥進口批發 |
| I300466 | 452611 | Import for wholesale of telecommunications equipment and parts | 电讯设备及其零件进口批发 | 電訊設備及其零件進口批發 |
| I300420 | 452322 | Import for wholesale of tobacco, cigarettes and cigars | 烟草、香烟及雪茄烟进口批发 | 煙草、香煙及雪茄煙進口批發 |
| I300439 | 452427 | Import for wholesale of toilet preparations and cleaning materials | 卫浴用剂及清洁剂料进口批发 | 衛浴用劑及清潔劑料進口批發 |
| I300452 | 452444 | Import for wholesale of toys | 玩具进口批发 | 玩具進口批發 |
| I300431 | 452408 | Import for wholesale of umbrellas | 雨伞进口批发 | 雨傘進口批發 |
| I300483 | 452744 | Import for wholesale of waste and scrap | 废物及废料进口批发 | 廢物及廢料進口批發 |
| I300454 | 452446 | Import for wholesale of watches and clocks | 钟表进口批发 | 鐘錶進口批發 |
| I300427 | 452404 | Import for wholesale of wearing apparel | 服装进口批发 | 服裝進口批發 |
| I300399 | 452205 | Import for wholesale of wood and rattan | 木材及藤料进口批发 | 木材及藤料進口批發 |
| I300394 | 452100 | Import for wholesale on a fee or contract basis | 按收费或以合约形式进口批发 | 按收費或以合約形式進口批發 |
| I300885 | 854904 | Industrial and commercial vocational schools | 工商科职业先修学校 | 工商科職業先修學校 |
| I300822 | 751400 | Industrial design services | 工业设计服务 | 工業設計服務 |
| I300755 | 620200 | Information technology consultancy activities and computer facilities management activities | 信息科技顾问活动及计算机设备管理活动 | 資訊科技顧問活動及電腦設備管理活動 |
| I300689 | 502200 | Inland freight water transport | 港内水上货运服务 | 港內水上貨運服務 |
| I300239 | 332000 | Installation of industrial machinery and equipment | 工业机械及设备安装 | 工業機械及設備安裝 |
| I300270 | 432105 | Intercommunication system, installation and maintenance | 闭路通讯系统安装及保养 | 閉路通訊系統安裝及保養 |
| I300819 | 751100 | Interior and furniture design services | 室内及家具设计服务 | 室內及傢俱設計服務 |
| I300280 | 439101 | Interior fitting, decoration and repairs for buildings | 楼房内部装设、装饰及修葺 | 樓房內部裝設、裝飾及修葺 |
| I300714 | 532100 | International courier activities | 国际速递活动 | 國際速遞活動 |
| I300751 | 619100 | Internet access services | 互联网接驳服务 | 互聯網接駁服務 |
| I300780 | 661901 | Investment advisory services | 投资顾问服务 | 投資顧問服務 |
| I300766 | 642000 | Investment and holding companies | 投资及控股公司 | 投資及控股公司 |
| I300777 | 661201 | Investment banking activities | 投资银行活动 | 投資銀行活動 |
| I300724 | 561108 | Italian cuisine restaurants | 意式餐馆 | 意式餐館 |
| I300719 | 561103 | Japanese cuisine restaurants | 日式餐馆 | 日式餐館 |
| I300688 | 502199 | Kaito and non-scheduled inland water passenger transport | 街渡及非固定航线港内水上客运服务 | 街渡及非固定航線港內水上客運服務 |
| I300931 | 939300 | Karaoke | 卡拉OK | 卡拉OK |
| I300856 | 851100 | Kindergartens | 幼儿园 | 幼稚園 |
| I300063 | 139199 | Knitting or crocheting of fabrics n.e.c. | 针织或钩针编织其他布料 | 針織或鉤針編織其他布料 |
| I300061 | 139101 | Knitting or crocheting of fabrics, cotton | 针织或钩针编织棉布 | 針織或鉤針編織棉布 |
| I300062 | 139102 | Knitting or crocheting of fabrics, wool | 针织或钩针编织毛布 | 針織或鉤針編織毛布 |
| I300720 | 561104 | Korean cuisine restaurants | 韩式餐馆 | 韓式餐館 |
| I300708 | 522903 | Land cargo forwarding services | 陆路货运代理服务 | 陸路貨運代理服務 |
| I300844 | 813000 | Landscape care and greenery services | 园境护理及绿化服务 | 園境護理及綠化服務 |
| I300677 | 492203 | Lantau taxi services | 大屿山的士服务 | 大嶼山的士服務 |
| I300952 | 960100 | Laundry and dry-cleaning services | 洗涤及干洗服务 | 洗滌及乾洗服務 |
| I300832 | 773000 | Leasing of intellectual property and similar non-financial intangible assets (except copyrighted wor | 知识产权及相类非金融无形资产的租赁(版权产品除外) | 知識產權及相類非金融無形資產的租賃(版權產品除外) |
| I300913 | 910100 | Libraries and archives activities | 图书馆及档案保存活动 | 圖書館及檔案保存活動 |
| I300687 | 502101 | Licensed and franchised ferry services | 持牌及专营渡轮服务 | 持牌及專營渡輪服務 |
| I300762 | 641201 | Licensed banks | 持牌银行 | 持牌銀行 |
| I300773 | 651100 | Life insurance underwriting | 人寿保险承包人 | 人壽保險承包人 |
| I300278 | 432901 | Lift and escalator, installation and maintenance | 升降机及电动扶梯安装及保养 | 升降機及電動扶梯安裝及保養 |
| I300884 | 854903 | Linguistic instruction | 语文训练 | 語文訓練 |
| I300698 | 522103 | Loading and unloading of luggage or freight during land transport | 陆路运输中的行李或货物提存上落服务 | 陸路運輸中的行李或貨物提存上落服務 |
| I300715 | 532200 | Local courier activities | 本地速递活动 | 本地速遞活動 |
| I300765 | 641300 | Local representative offices of foreign banks | 海外银行本地代表办事处 | 海外銀行本地代表辦事處 |
| I300692 | 510202 | Local representative offices of overseas airline companies (freight) | 海外航空公司的驻港办事处(货运) | 海外航空公司的駐港辦事處(貨運) |
| I300691 | 510201 | Local representative offices of overseas airline companies (passenger) | 海外航空公司的驻港办事处(客运) | 海外航空公司的駐港辦事處(客運) |
| I300948 | 953500 | Locksmith services | 锁匠服务 | 鎖匠服務 |
| I300660 | 477417 | Luxuries comprehensive stores | 奢侈品综合店 | 奢侈品綜合店 |
| I300954 | 960202 | Made-up, skin and facial care services | 化妆、皮肤及面部护理服务 | 化妝、皮膚及面部護理服務 |
| I300835 | 783000 | Management of human resources functions | 人力资源管理服务 | 人力資源管理服務 |
| I300241 | 352000 | Manufacture and distribution of gas | 燃气的制造及配送 | 燃氣的製造及配送 |
| I300020 | 101400 | Manufacture and processing of slaughtering by-products (excl. leather tanning and dressing) | 屠宰业副产品的制造及加工(皮革的鞣制和修整除外) | 屠宰業副產品的製造及加工(皮革的鞣制和修整除外) |
| I300138 | 211100 | Manufacture of Chinese herbal and drug medicine | 中草药及中成药的制造 | 中草藥及中成藥的製造 |
| I300231 | 329600 | Manufacture of advertising displays (except electric, neon and illuminated signs) | 商业广告牌的制造(电力、霓虹及照明灯号除外) | 商業看板的製造(電力、霓虹及照明燈號除外) |
| I300197 | 282100 | Manufacture of agricultural and forestry machinery | 农业及林业机械的制造 | 農業及林業機械的製造 |
| I300040 | 110200 | Manufacture of alcoholic beverage other than beer | 非啤酒酒类的制造 | 非啤酒酒類的製造 |
| I300154 | 239400 | Manufacture of articles of concrete, cement and plaster | 混凝土、水泥及石膏制品的制造 | 混凝土、水泥及石膏製品的製造 |
| I300091 | 142000 | Manufacture of articles of fur | 毛皮制品的制造 | 毛皮製品的製造 |
| I300123 | 190100 | Manufacture of asphalt | 沥青的制造 | 瀝青的製造 |
| I300182 | 264000 | Manufacture of audio and video equipment | 影音器材的制造 | 影音器材的製造 |
| I300028 | 107100 | Manufacture of bakery products | 烤烘食品的制造 | 烤烘食品的製造 |
| I300105 | 162903 | Manufacture of bamboo materials and articles | 竹制材料及物品的制造 | 竹制材料及物品的製造 |
| I300159 | 242200 | Manufacture of basic aluminium | 基本铝的制造 | 基本鋁的製造 |
| I300158 | 242100 | Manufacture of basic copper | 基本铜的制造 | 基本銅的製造 |
| I300157 | 241000 | Manufacture of basic iron and steel (excl. casting) | 基本钢铁的制造(铸造除外) | 基本鋼鐵的製造(鑄造除外) |
| I300161 | 242900 | Manufacture of basic non-ferrous metals n.e.c. (excl. casting) | 其他基本有色金属的制造(铸造除外) | 其他基本有色金屬的製造(鑄造除外) |
| I300025 | 106101 | Manufacture of bean curd | 豆腐的制造 | 豆腐的製造 |
| I300065 | 139202 | Manufacture of bed articles | 床上用品的制造 | 床上用品的製造 |
| I300039 | 110100 | Manufacture of beer | 啤酒的酿制 | 啤酒的釀制 |
| I300210 | 309200 | Manufacture of bicycles and invalid carriages | 自行车及伤病人士座车的制造 | 自行車及傷病人士座車的製造 |
| I300227 | 329301 | Manufacture of buttons | 钮扣的制造 | 鈕扣的製造 |
| I300131 | 202901 | Manufacture of camphor products | 樟脑产品的制造 | 樟腦產品的製造 |
| I300225 | 329100 | Manufacture of candles | 蜡烛的制造 | 蠟燭的製造 |
| I300176 | 259901 | Manufacture of cans and domestic utensils of metal | 金属罐及金属家庭用具的制造 | 金屬罐及金屬家庭用具的製造 |
| I300064 | 139201 | Manufacture of canvas products | 帆布制品的制造 | 帆布製品的製造 |
| I300072 | 139300 | Manufacture of carpets and rugs | 地毡及围毡的制造 | 地氈及圍氈的製造 |
| I300186 | 265203 | Manufacture of cases and parts for watches and clocks n.e.c. | 钟表壳及其他钟表零件的制造 | 鐘錶殼及其他鐘錶零件的製造 |
| I300153 | 239300 | Manufacture of cement, lime and plaster | 水泥、石灰及石膏的制造 | 水泥、石灰及石膏的製造 |
| I300030 | 107300 | Manufacture of cocoa, chocolate and confectionery products | 可可、朱古力及糖果的制造 | 可哥、朱古力及糖果的製造 |
| I300125 | 190900 | Manufacture of coke and refined petroleum products n.e.c. | 其他焦煤和精炼石油产品的制造 | 其他焦煤和精煉石油產品的製造 |
| I300181 | 263000 | Manufacture of communication equipment | 通讯设备的制造 | 通訊設備的製造 |
| I300180 | 262000 | Manufacture of computers and peripheral equipment | 计算机及其接口设备的制造 | 電腦及其周邊設備的製造 |
| I300107 | 162905 | Manufacture of cork materials and articles | 水松材料及物品的制造 | 水松材料及物品的製造 |
| I300129 | 202301 | Manufacture of cosmetics, perfumes and toilet | 化妆品、香水及卫浴用剂的制造 | 化妝品、香水及衛浴用劑的製造 |
| I300174 | 259302 | Manufacture of cutlery | 刀具的制造 | 刀具的製造 |
| I300024 | 105000 | Manufacture of dairy products | 乳类制品的制造 | 乳類製品的製造 |
| I300223 | 325200 | Manufacture of dentures (incl. dental laboratories) | 假牙的制造(包括牙科技术室) | 假牙的製造(包括牙科技術室) |
| I300130 | 202302 | Manufacture of detergent and soaps | 清洁剂及肥皂的制造 | 清潔劑及肥皂的製造 |
| I300194 | 275000 | Manufacture of domestic electric appliances | 家用电器的制造 | 家用電器的製造 |
| I300193 | 274000 | Manufacture of electric and non-electrical lighting equipment | 电力及非电力照明设备的制造 | 電力及非電力照明設備的製造 |
| I300191 | 273100 | Manufacture of electric wire, fibre optic cables and other cables | 电力电线、光纤电缆及其他电缆的制造 | 電力電線、光纖電纜及其他電纜的製造 |
| I300220 | 324500 | Manufacture of electronic games and toys | 电子游戏用品及玩具的制造 | 電子遊戲用品及玩具的製造 |
| I300178 | 261100 | Manufacture of electronic parts and components for computer and telecommunications equipment | 计算机及电讯设备用电子零件及组件的制造 | 電腦及電訊設備用電子零件及元件的製造 |
| I300179 | 261900 | Manufacture of electronic parts and components n.e.c. | 其他电子零件及组件的制造 | 其他電子零件及元件的製造 |
| I300185 | 265202 | Manufacture of electronic watches, watch movements, electronic clocks and clock movements | 电子钟及钟肉、电子表及表肉的制造 | 電子鐘及鐘肉、電子錶及表肉的製造 |
| I300078 | 139600 | Manufacture of embroidery | 刺绣品的制造 | 刺繡品的製造 |
| I300135 | 202905 | Manufacture of explosives | 炸药的制造 | 炸藥的製造 |
| I300073 | 139401 | Manufacture of fishing nets | 鱼网的制造 | 魚網的製造 |
| I300148 | 222902 | Manufacture of foam rubber articles and sponge goods | 乳胶制品及海绵制品的制造 | 乳膠製品及海綿製品的製造 |
| I300099 | 152000 | Manufacture of footwear | 鞋类制造 | 鞋類製造 |
| I300215 | 310900 | Manufacture of furniture and fixtures of other materials | 其他材料制家具及固定装置的制造 | 其他材料制傢俱及固定裝置的製造 |
| I300221 | 324900 | Manufacture of games and toys n.e.c. | 其他游戏用品及玩具的制造 | 其他遊戲用品及玩具的製造 |
| I300086 | 141199 | Manufacture of garments and clothing n.e.c | 其他衣物的缝制 | 其他衣物的縫製 |
| I300150 | 231000 | Manufacture of glass, glass fibre and glass products | 玻璃、玻璃纤维及玻璃产品的制造 | 玻璃、玻璃纖維及玻璃產品的製造 |
| I300134 | 202904 | Manufacture of glue | 胶水的制造 | 膠水的製造 |
| I300026 | 106199 | Manufacture of grain mill products n.e.c. | 其他谷物磨粉制品的制造 | 其他穀物磨粉製品的製造 |
| I300175 | 259303 | Manufacture of hand tools and metal hardware | 手工具及金属配件的制造 | 手工具及金屬配件的製造 |
| I300087 | 141902 | Manufacture of headgear (excl. straw headgear, plastic and metal and fibreglass helmet) | 帽类的制造(草帽与塑料、金属及玻璃纤维头盔除外) | 帽類的製造(草帽與塑膠、金屬及玻璃纖維頭盔除外) |
| I300187 | 266000 | Manufacture of irradiation, electromedical and electrotherapeutic equipment | 辐射、电子医学及电子诊疗设备的制造 | 輻射、電子醫學及電子診療設備的製造 |
| I300111 | 170901 | Manufacture of joss paper | 元宝衣纸的制造 | 元寶衣紙的製造 |
| I300132 | 202902 | Manufacture of joss sticks | 香(祭祀用)的制造 | 香(祭祀用)的製造 |
| I300092 | 143100 | Manufacture of knitted and crocheted hosiery (incl. all materials) | 针织或钩针编织袜(包括各类质料)的制造 | 針織或鉤針編織襪(包括各類質料)的製造 |
| I300093 | 143200 | Manufacture of knitted and crocheted outerwear (excl. garment not knitted, raincoat, leather garment | 针织或钩针编织外衣(非针织衣服、雨衣及皮革衣服除外)的制造 | 針織或鉤針編織外衣(非針織衣服、雨衣及皮革衣服除外)的製造 |
| I300094 | 143300 | Manufacture of knitted and crocheted underwear | 针织或钩针编织内衣的制造 | 針織或鉤針編織內衣的製造 |
| I300079 | 139700 | Manufacture of laminated cloth | 层压布的制造 | 層壓布的製造 |
| I300085 | 141105 | Manufacture of leather garments | 皮革衣服的缝制 | 皮革衣服的縫製 |
| I300096 | 151200 | Manufacture of luggage and handbags (excl. plastic shopping bags) | 行李箱及手袋的制造(塑料购物袋除外) | 行李箱及手袋的製造(塑膠購物袋除外) |
| I300201 | 282500 | Manufacture of machinery for food, beverage and tobacco processing | 食品、饮料及烟草加工用机械的制造 | 食品、飲料及煙草加工用機械的製造 |
| I300199 | 282300 | Manufacture of machinery for metallurgy | 冶金机械的制造 | 冶金機械的製造 |
| I300200 | 282400 | Manufacture of machinery for mining, quarrying and construction | 采矿业、采石业及建造业机械的制造 | 採礦業、採石業及建造業機械的製造 |
| I300202 | 282600 | Manufacture of machinery for textile, apparel and leather production | 纺织、成衣及皮革生产用机械的制造 | 紡織、成衣及皮革生產用機械的製造 |
| I300071 | 139299 | Manufacture of made-up textile articles (except apparel) n.e.c. | 其他纺织制成品(服装除外)的制造 | 其他紡織製成品(服裝除外)的製造 |
| I300190 | 268000 | Manufacture of magnetic and optical media | 磁性及光学媒体的制造 | 磁性及光學媒體的製造 |
| I300137 | 203000 | Manufacture of man-made fibres | 人造纤维的制造 | 人造纖維的製造 |
| I300183 | 265100 | Manufacture of measuring, testing, navigating and control equipment | 量度、检验、导航及控制用设备的制造 | 量度、檢驗、導航及控制用設備的製造 |
| I300184 | 265201 | Manufacture of mechanical watches, watch movements, mechanical clocks and clock movements | 机械钟及钟肉、机械表及表肉的制造 | 機械鐘及鐘肉、機械表及表肉的製造 |
| I300224 | 325900 | Manufacture of medical and dental instruments and supplies n.e.c. | 其他医疗与牙科仪器及用品的制造 | 其他醫療與牙科儀器及用品的製造 |
| I300214 | 310200 | Manufacture of metal furniture and fixtures | 金属家具及固定装置的制造 | 金屬傢俱及固定裝置的製造 |
| I300219 | 324400 | Manufacture of metal toys | 金属玩具的制造 | 金屬玩具的製造 |
| I300166 | 251101 | Manufacture of metal windows, doors and gates | 金属窗、门与门的制造 | 金屬窗、門及閘的製造 |
| I300198 | 282200 | Manufacture of metal-forming machinery and machine tools | 金属成型机械及机床的制造 | 金屬成型機械及機床的製造 |
| I300117 | 170999 | Manufacture of miscellaneous articles of paper and paperboard n.e.c | 其他杂项纸及纸板制品的制造 | 其他雜項紙及紙板製品的製造 |
| I300149 | 222999 | Manufacture of miscellaneous plastics products n.e.c. (except furniture, toys, sports goods and stat | 其他杂项塑料制品的制造(家具、玩具、体育用品及文具除外) | 其他雜項塑膠製品的製造(傢俱、玩具、體育用品及文具除外) |
| I300232 | 329900 | Manufacture of miscellaneous products n.e.c. | 其他杂项产品的制造 | 其他雜項產品的製造 |
| I300098 | 151999 | Manufacture of miscellaneous products of leather and leather substitutes n.e.c. (excl. footwear and | 其他杂项皮革及人造皮制品的制造(鞋类及服装制品除外) | 其他雜項皮革及人造皮製品的製造(鞋類及服裝製品除外) |
| I300133 | 202903 | Manufacture of mosquito sticks | 蚊香的制造 | 蚊香的製造 |
| I300209 | 309100 | Manufacture of motorcycles | 电单车的制造 | 電單車的製造 |
| I300173 | 259301 | Manufacture of nails, screws and hinges | 钉、螺丝及金属铰的制造 | 釘、螺絲及金屬鉸的製造 |
| I300089 | 141904 | Manufacture of neckwear | 领带围巾的制造 | 領帶圍巾的製造 |
| I300031 | 107400 | Manufacture of noodles and similar farinaceous products | 粉面及同类谷粉制品的制造 | 粉面及同類穀粉製品的製造 |
| I300195 | 279000 | Manufacture of other electrical equipment | 其他电力设备的制造 | 其他電力設備的製造 |
| I300196 | 281900 | Manufacture of other general-purpose machinery | 其他通用机械的制造 | 其他通用機械的製造 |
| I300136 | 202999 | Manufacture of other miscellaneous chemical products n.e.c. | 其他杂项化学产品的制造 | 其他雜項化學產品的製造 |
| I300177 | 259999 | Manufacture of other miscellaneous fabricated metal products n.e.c. | 其他杂项金属加工制品的制造 | 其他雜項金屬加工製品的製造 |
| I300037 | 107999 | Manufacture of other miscellaneous food products n.e.c. | 其他杂项食品的制造 | 其他雜項食品的製造 |
| I300080 | 139900 | Manufacture of other miscellaneous textiles n.e.c. | 其他杂项纺织品的制造 | 其他雜項紡織品的製造 |
| I300090 | 141999 | Manufacture of other miscellaneous wearing apparel n.e.c. | 其他杂项服装制品的制造 | 其他雜項服裝製品的製造 |
| I300156 | 239900 | Manufacture of other non-metallic mineral products n.e.c. | 其他非金属矿产制品的制造 | 其他非金屬礦產製品的製造 |
| I300189 | 267200 | Manufacture of other optical instruments and equipment (except ophthalmic goods) n.e.c. | 其他光学仪器及设备(眼科用品除外)的制造 | 其他光學儀器及設備(眼科用品除外)的製造 |
| I300142 | 221900 | Manufacture of other rubber products | 其他橡胶制品的制造 | 其他橡膠製品的製造 |
| I300203 | 282900 | Manufacture of other special-purpose machinery | 其他专用机械的制造 | 其他專用機械的製造 |
| I300211 | 309900 | Manufacture of other transport equipment n.e.c. | 其他运输设备的制造 | 其他運輸設備的製造 |
| I300081 | 141101 | Manufacture of outer garments (excl. leather garment, raincoat, knitwear from yarn) | 外衣的缝制(皮革衣服、雨衣及直接由纱线原件针织的衣物除外) | 外衣的縫製(皮革衣服、雨衣及直接由紗線原件針織的衣物除外) |
| I300128 | 202200 | Manufacture of paints, varnishes and similar coatings, printing ink and mastics | 油漆、清漆及同类涂料、印刷油墨及桐油灰的制造 | 油漆、清漆及同類塗料、印刷油墨及桐油灰的製造 |
| I300110 | 170202 | Manufacture of paper bags | 纸袋的制造 | 紙袋的製造 |
| I300109 | 170201 | Manufacture of paper boxes | 纸盒的制造 | 紙盒的製造 |
| I300112 | 170902 | Manufacture of paper cones | 纸筒的制造 | 紙筒的製造 |
| I300113 | 170903 | Manufacture of paper lantern | 纸灯笼的制造 | 紙燈籠的製造 |
| I300114 | 170904 | Manufacture of paper stationery | 纸制文具的制造 | 紙制文具的製造 |
| I300127 | 202100 | Manufacture of pesticides and other agrochemical | 杀虫剂和其他农用化学制品的制造 | 殺蟲劑和其他農用化學製品的製造 |
| I300188 | 267100 | Manufacture of photographic equipment (optical and digital) | 摄影器材(光学与数码)的制造 | 攝影器材(光學與數碼)的製造 |
| I300106 | 162904 | Manufacture of plaiting materials and straw wares | 草制材料及物品的制造 | 草制材料及物品的製造 |
| I300023 | 104000 | Manufacture of plant and animal oils and fat | 动植物油脂的制造 | 動植物油脂的製造 |
| I300145 | 222300 | Manufacture of plastic bags (excl. handbags) | 塑料袋的制造(手袋除外) | 塑膠袋的製造(手袋除外) |
| I300146 | 222400 | Manufacture of plastic cases and parts | 塑料外壳及零件的制造 | 塑膠外殼及零件的製造 |
| I300144 | 222200 | Manufacture of plastic domestic utensils | 塑料家庭用具的制造 | 塑膠家庭用具的製造 |
| I300143 | 222100 | Manufacture of plastic flowers and foliage (excl. metal flowers, other artificial flowers) | 塑料花及枝叶的制造(金属花卉及其他质料人造花卉除外) | 塑膠花及枝葉的製造(金屬花卉及其他質料人造花卉除外) |
| I300218 | 324300 | Manufacture of plastic toys | 塑料玩具的制造 | 塑膠玩具的製造 |
| I300126 | 201300 | Manufacture of plastics and synthetic rubber in primary forms | 初级塑料及合成橡胶的制造 | 初級塑料及合成橡膠的製造 |
| I300152 | 239200 | Manufacture of pottery, china and earthenware | 陶器、瓷器及瓦器制品的制造 | 陶器、瓷器及瓦器製品的製造 |
| I300038 | 108000 | Manufacture of prepared animal feeds | 动物饲料的制造 | 動物飼料的製造 |
| I300032 | 107500 | Manufacture of prepared meals and dishes | 预制膳食的制造 | 預製膳食的製造 |
| I300108 | 170100 | Manufacture of pulp, paper and paperboard | 纸浆、纸张及纸板的制造 | 紙漿、紙張及紙板的製造 |
| I300207 | 302000 | Manufacture of railway locomotives and rolling stock | 铁道车辆及机车的制造 | 鐵道車輛及機車的製造 |
| I300083 | 141103 | Manufacture of raincoats | 雨衣的缝制 | 雨衣的縫製 |
| I300213 | 310102 | Manufacture of rattan furniture | 藤制家具的制造 | 藤制傢俱的製造 |
| I300104 | 162902 | Manufacture of rattan materials and articles | 藤制材料及物品的制造 | 藤制材料及物品的製造 |
| I300151 | 239100 | Manufacture of refractory and structural clay products | 耐火材料及建筑用黏土制品的制造 | 耐火材料及建築用黏土製品的製造 |
| I300074 | 139402 | Manufacture of rope | 绳的制造 | 繩的製造 |
| I300141 | 221100 | Manufacture of rubber tyres and tubes; retreading and rebuilding of rubber tyres | 橡胶轮胎及内胎的制造、修补及翻新 | 橡膠輪胎及內胎的製造、修補及翻新 |
| I300066 | 139203 | Manufacture of sails and flags | 船帆及旗帜的制造 | 船帆及旗幟的製造 |
| I300075 | 139403 | Manufacture of shoe laces | 鞋带的制造 | 鞋帶的製造 |
| I300069 | 139206 | Manufacture of silkscreen for printing (excl. textile stencilling and printing) | 印刷用丝网的制造(纺织品印花除外) | 印刷用絲網的製造(紡織品印花除外) |
| I300228 | 329302 | Manufacture of slide fasteners | 拉链的制造 | 拉鍊的製造 |
| I300041 | 110300 | Manufacture of soft drinks; production of mineral waters and other non-alcoholic drinks | 汽水的制造;矿泉水及其他非酒类饮品的制造 | 汽水的製造;礦泉水及其他非酒類飲品的製造 |
| I300222 | 325100 | Manufacture of spectacles and ophthalmic products | 眼镜及眼科用品的制造 | 眼鏡及眼科用品的製造 |
| I300036 | 107904 | Manufacture of spices, sauces and condiments | 食用香料、酱油及调味品的制造 | 食用香料、醬油及調味品的製造 |
| I300027 | 106200 | Manufacture of starches and starch products | 淀粉及淀粉制品的制造 | 澱粉及澱粉製品的製造 |
| I300230 | 329500 | Manufacture of stationery articles (except paper stationery) | 文具的制造(纸制文具除外) | 文具的製造(紙制文具除外) |
| I300169 | 251300 | Manufacture of steam generators (except central heating hot water boilers) | 蒸汽锅炉的制造(中央供热热水锅炉除外) | 蒸汽鍋爐的製造(中央供熱熱水鍋爐除外) |
| I300167 | 251199 | Manufacture of structural products of metal n.e.c. | 其他建筑用金属制品的制造 | 其他建築用金屬製品的製造 |
| I300029 | 107200 | Manufacture of sugar | 糖的制炼 | 糖的制煉 |
| I300168 | 251200 | Manufacture of tanks, reservoirs and containers of metal | 油罐、水箱及金属容器的制造 | 油罐、水箱及金屬容器的製造 |
| I300034 | 107902 | Manufacture of tea products | 制茶 | 制茶 |
| I300042 | 120000 | Manufacture of tobacco products | 烟草制品的制造 | 煙草製品的製造 |
| I300115 | 170905 | Manufacture of toilet paper, tissue paper and napkins | 厕纸、纸巾及纸尿片的制造 | 廁紙、紙巾及紙尿片的製造 |
| I300076 | 139404 | Manufacture of twine | 合股线的制造 | 合股線的製造 |
| I300229 | 329400 | Manufacture of umbrellas and related products | 雨伞及相关制品的制造 | 雨傘及相關製品的製造 |
| I300084 | 141104 | Manufacture of under garments and night garments | 内衣及睡衣的缝制 | 內衣及睡衣的縫製 |
| I300101 | 162100 | Manufacture of veneer sheets and wood-based panels | 双面板及镶板木料的制造 | 雙面板及鑲板木料的製造 |
| I300140 | 212000 | Manufacture of veterinary pharmaceuticals | 兽医用药品的制造 | 獸醫用藥品的製造 |
| I300088 | 141903 | Manufacture of waist belts | 腰带的制造 | 腰帶的製造 |
| I300116 | 170906 | Manufacture of wallpaper | 墙纸的制造 | 牆紙的製造 |
| I300139 | 211200 | Manufacture of western medicine, diagnostic and therapeutic medicaments, and medical and nursing pre | 西药、诊治用药检剂及医护材料的制造 | 西藥、診治用藥檢劑及醫護材料的製造 |
| I300226 | 329200 | Manufacture of wigs and related products | 假发及相关制品的制造 | 假髮及相關製品的製造 |
| I300192 | 273200 | Manufacture of wiring devices | 配线器材的制造 | 配線器材的製造 |
| I300102 | 162200 | Manufacture of wooden containers (excl. chest of camphor woods | 木制容器的制造(樟木匣除外) | 木制容器的製造(樟木匣除外) |
| I300103 | 162901 | Manufacture of wooden domestic utensils, jewellery boxes or other articles | 木制家庭用品、首饰盒或其他物品的制造 | 木制家庭用品、首飾盒或其他物品的製造 |
| I300212 | 310101 | Manufacture of wooden furniture and fixtures | 木制家具及固定装置的制造 | 木制傢俱及固定裝置的製造 |
| I300097 | 151901 | Manufacture of wrist watchbands, leather or non-metallic | 真皮或非金属表带的制造 | 真皮或非金屬錶帶的製造 |
| I300864 | 854105 | Marital arts and taiji instruction | 武术及太极训练 | 武術及太極訓練 |
| I300818 | 742000 | Market research and public opinion polling | 市场研究及民意调查服务 | 市場研究及民意調查服務 |
| I300288 | 439906 | Masonry | 石工 | 石工 |
| I300961 | 960600 | Match-making, matrimonial agency and marriage ceremony services | 征友配对、月老及婚姻礼仪服务 | 征友配對、月老及婚姻禮儀服務 |
| I300890 | 861200 | Maternity homes | 留产院 | 留產院 |
| I300019 | 101300 | Meat preserving | 肉类的腌制 | 肉類的醃制 |
| I300894 | 869100 | Medical and X-ray laboratories | 医疗及X光化验所 | 醫療及X光化驗所 |
| I300892 | 862200 | Medical practitioners' offices | 执业医生医务所 | 執業醫生醫務所 |
| I300286 | 439904 | Metal scaffolding | 盖搭金属棚架 | 蓋搭金屬棚架 |
| I300701 | 522202 | Mid-stream operation | 中流作业 | 中流作業 |
| I300012 | 50000 | Mining of coal and lignite | 煤和褐煤的采掘 | 煤和褐煤的採掘 |
| I300014 | 70000 | Mining of metal ores | 金属矿的采掘 | 金屬礦的採掘 |
| I300016 | 90000 | Mining support service activities | 矿物开采辅助服务活动 | 礦物開採輔助服務活動 |
| I300259 | 422000 | Miscellaneous civil engineering works | 杂项土木工程 | 雜項土木工程 |
| I300279 | 432999 | Miscellaneous construction installation and maintenance n.e.c. | 其他杂项建筑设施安装及保养 | 其他雜項建築設施安裝及保養 |
| I300299 | 439999 | Miscellaneous finishing and specialised construction works n.e.c. | 其他杂项竣工前的修整及专门建造工程 | 其他雜項竣工前的修整及專門建造工程 |
| I300897 | 869900 | Miscellaneous human health services n.e.c. | 其他杂项人类保健服务 | 其他雜項人類保健服務 |
| I300006 | 15000 | Mixed farming | 农牧混合 | 農牧混合 |
| I300761 | 641100 | Monetary authorities | 货币管理机构 | 貨幣管理機構 |
| I300771 | 649901 | Money changers and foreign exchange brokers or dealers | 外币兑换点及外汇经纪或交易商 | 外幣兌換點及外匯經紀或交易商 |
| I300746 | 591400 | Motion picture projection activities | 电影放映活动 | 電影放映活動 |
| I300743 | 591100 | Motion picture, video and television programme | 电影、录像及电视节目制作活动 | 電影、錄像及電視節目製作活動 |
| I300745 | 591300 | Motion picture, video and television programme distribution activities | 电影、录像及电视节目发行活动 | 電影、錄像及電視節目發行活動 |
| I300744 | 591200 | Motion picture, video and television programme post-production activities | 电影、录像及电视节目后期制作活动 | 電影、錄像及電視節目後期製作活動 |
| I300249 | 383100 | Motor vehicle breaking | 拆车 | 拆車 |
| I300820 | 751200 | Multi-media, visual and graphic design activities | 多媒体、视觉及平面设计活动 | 多媒體、視覺及平面設計活動 |
| I300914 | 910200 | Museums activities and operation of historical sites | 博物馆活动及历史遗址经营管理 | 博物館活動及歷史遺址經營管理 |
| I300872 | 854202 | Music instruction | 音乐训练 | 音樂訓練 |
| I300676 | 492202 | New Territories taxi services | 新界的士服务 | 新界的士服務 |
| I300759 | 639100 | News agency activities | 新闻通讯社活动 | 新聞通訊社活動 |
| I300930 | 939200 | Night clubs and dance halls | 夜总会及舞厅 | 夜總會及舞廳 |
| I300774 | 651200 | Non-life insurance underwriting | 非人寿保险承包人 | 非人壽保險承包人 |
| I300678 | 492300 | Non-scheduled public light bus services | 非专线公共小型巴士服务 | 非專線公共小型巴士服務 |
| I300393 | 451900 | Non-specialised export trading | 非专卖货品出口贸易 | 非專賣貨品出口貿易 |
| I300485 | 452900 | Non-specialised import for wholesale | 非专卖货品进口批发 | 非專賣貨品進口批發 |
| I300579 | 460900 | Non-specialised wholesale | 非专卖货品批发 | 非專賣貨品批發 |
| I300898 | 871100 | Nursing homes for the elderly | 长者护养院 | 長者護養院 |
| I300899 | 871900 | Nursing homes n.e.c. | 其他护养院 | 其他護養院 |
| I300684 | 501402 | Operators of sea-going vessels for freight transport | 远洋货轮营运者 | 遠洋貨輪營運者 |
| I300683 | 501401 | Operators of sea-going vessels for passenger transport | 远洋客轮营运者 | 遠洋客輪營運者 |
| I300649 | 477404 | Optical shops | 眼镜店 | 眼鏡店 |
| I300298 | 439918 | Ornamentation fitting | 装饰品装设 | 裝飾品裝設 |
| I300785 | 662900 | Other activities auxiliary to insurance and pension funding | 其他保险及退休基金辅助活动 | 其他保險及退休基金輔助活動 |
| I300956 | 960299 | Other beauty and body prettifying treatment | 其他美容及美体护理 | 其他美容及美體護理 |
| I300843 | 812900 | Other building and industrial cleaning activities | 其他楼房及工业清洁活动 | 其他樓房及工業清潔活動 |
| I300879 | 854299 | Other cultural education | 其他文化教育 | 其他文化教育 |
| I300730 | 561901 | Other eating places with seats | 其他自设座位的餐食场所 | 其他自設座位的餐食場所 |
| I300760 | 639900 | Other information service activities n.e.c. | 其他信息服务活动 | 其他資訊服務活動 |
| I300756 | 620900 | Other information technology service activities | 其他信息科技服务活动 | 其他資訊科技服務活動 |
| I300782 | 661999 | Other miscellaneous activities auxiliary to financial service activities n.e.c. | 其他杂项金融服务辅助活动 | 其他雜項金融服務輔助活動 |
| I300853 | 829900 | Other miscellaneous business support service activities n.e.c. | 其他杂项业务支持服务活动 | 其他雜項業務支援服務活動 |
| I300887 | 854999 | Other miscellaneous education n.e.c. | 其他杂项教育 | 其他雜項教育 |
| I300934 | 939900 | Other miscellaneous entertainment activities n.e.c. | 其他杂项娱乐活动 | 其他雜項娛樂活動 |
| I300772 | 649999 | Other miscellaneous financial service activities n.e.c. | 其他杂项金融服务活动 | 其他雜項金融服務活動 |
| I300964 | 960900 | Other miscellaneous personal service activities n.e.c. | 其他杂项个人服务活动 | 其他雜項個人服務活動 |
| I300827 | 759000 | Other miscellaneous professional, scientific and technical activities n.e.c. | 其他杂项专业、科学及技术活动 | 其他雜項專業、科學及技術活動 |
| I300664 | 477499 | Other miscellaneous retail sale of new goods n.e.c. | 其他杂项全新商品零售店 | 其他雜項全新商品零售店 |
| I300752 | 619900 | Other miscellaneous telecommunications activities n.e.c. | 其他杂项电讯活动 | 其他雜項電訊活動 |
| I300712 | 522999 | Other miscellaneous transportation support activities n.e.c. | 其他杂项运输辅助活动 | 其他雜項運輸輔助活動 |
| I300740 | 581900 | Other publishing activities | 其他出版活动 | 其他出版活動 |
| I300793 | 682900 | Other real estate services n.e.c. | 其他地产服务 | 其他地產服務 |
| I300837 | 799000 | Other reservation service and tourist-related activities | 其他代订服务及旅游相关活动 | 其他代訂服務及旅遊相關活動 |
| I300903 | 879000 | Other residential care activities | 其他住宿照顾活动 | 其他住宿照顧活動 |
| I300672 | 478299 | Other retail sale not via stores and movable stalls | 其他无店面和不经流动货摊的零售 | 其他無店面和不經流動貨攤的零售 |
| I300585 | 471999 | Other retail sale of general merchandise | 其他综合商品零售店 | 其他綜合商品零售店 |
| I300909 | 889000 | Other social work activities without accommodation | 其他不提供住宿的社会工作活动 | 其他不提供住宿的社會工作活動 |
| I300928 | 931900 | Other sports activities | 其他体育活动 | 其他體育活動 |
| I300926 | 931199 | Other sports facilities operators n.e.c. | 其他体育设施运作经营 | 其他體育設施運作經營 |
| I300870 | 854199 | Other sports skills instruction | 其他运动技巧训练 | 其他運動技巧訓練 |
| I300850 | 829200 | Packaging activities | 包装活动 | 包裝活動 |
| I300709 | 522904 | Packing and crating services | 包装及装箱服务 | 包裝及裝箱服務 |
| I300294 | 439914 | Painting | 油漆 | 油漆 |
| I300874 | 854204 | Painting instruction | 绘画教学 | 繪畫教學 |
| I300769 | 649201 | Pawnshops | 当铺 | 當鋪 |
| I300775 | 652000 | Pension funding | 退休基金 | 退休基金 |
| I300910 | 901000 | Performing arts activities | 表演艺术活动 | 表演藝術活動 |
| I300912 | 903000 | Performing arts venue operation | 表演艺术场所经营 | 表演藝術場所經營 |
| I300770 | 649299 | Personal loan, mortgage, instalment credit and other credit granting | 私人贷款,按揭,分期付款信贷及其他信贷提供 | 私人貸款,按揭,分期付款信貸及其他信貸提供 |
| I300841 | 811000 | Pest control services | 病媒防治服务 | 病媒防治服務 |
| I300603 | 473100 | Petrol filling stations | 油站 | 油站 |
| I300124 | 190200 | Petroleum refineries | 石油精炼 | 石油精煉 |
| I300825 | 752200 | Photo printing and photo finishing services | 相片冲印及修整服务 | 相片沖印及修整服務 |
| I300120 | 181202 | Photo-engraving, composition and typesetting | 印刷版制作、版面构图及排字(设计除外) | 印刷版製作、版面構圖及排字(設計除外) |
| I300846 | 821900 | Photocopying, document preparation and other specialised office support activities | 影印、文件准备及其他专门办公室支持活动 | 影印、文件準備及其他專門辦公室支持活動 |
| I300824 | 752100 | Photographic production services | 拍摄服务 | 拍攝服務 |
| I300877 | 854207 | Photography instruction | 摄影教学 | 攝影教學 |
| I300002 | 13000 | Plant propagation | 植物的繁殖 | 植物的繁殖 |
| I300147 | 222901 | Plastic stencilling | 塑料制品印花 | 塑膠製品印花 |
| I300702 | 522203 | Port facilities operators (except container and marine cargo terminals) | 港口设施营运者(货柜及货运码头除外) | 港口設施營運者(貨櫃及貨運碼頭除外) |
| I300713 | 531000 | Postal activities | 邮政活动 | 郵政活動 |
| I300160 | 242300 | Precious metal refinery (excl. goldsmithing and silversmithing) | 贵金属提炼(打金及打银除外) | 貴金屬提煉(打金及打銀除外) |
| I300857 | 851200 | Primary schools | 小学 | 小學 |
| I300118 | 181100 | Printing | 印刷 | 印刷 |
| I300851 | 829300 | Printing agents | 印务代理 | 印務代理 |
| I300121 | 181299 | Printing allied industries n.e.c. | 其他印刷及有关活动 | 其他印刷及有關活動 |
| I300840 | 803000 | Private detective services | 私家侦探服务 | 私家偵探服務 |
| I300021 | 102000 | Processing and preserving of fish, crustaceans and molluscs | 鱼类、甲壳类及软件软动物食品的加工及腌制 | 魚類、甲殼類及軟體類動物食品的加工及醃制 |
| I300022 | 103000 | Processing and preserving of fruit and vegetables | 蔬果类食品的加工及腌制 | 蔬果類食品的加工及醃制 |
| I300035 | 107903 | Production of coffee products | 咖啡制品的制造 | 咖啡製品的製造 |
| I300790 | 681400 | Property holding and resale | 物业拥有及转售 | 物業擁有及轉售 |
| I300834 | 782000 | Provision of temporary personnel | 临时人力供应服务 | 臨時人力供應服務 |
| I300674 | 492100 | Public bus services | 公共巴士服务 | 公共巴士服務 |
| I300855 | 842000 | Public order and safety activities | 公共秩序及安全活动 | 公共秩序及安全活動 |
| I300800 | 702100 | Public relation services | 公共关系服务 | 公共關係服務 |
| I300741 | 582100 | Publishing of computer games | 计算机游戏出版 | 電腦遊戲出版 |
| I300739 | 581202 | Publishing of magazines and periodicals | 杂志及期刊出版 | 雜誌及期刊出版 |
| I300738 | 581201 | Publishing of newspapers | 报纸出版 | 報紙出版 |
| I300742 | 582900 | Publishing of other softwares | 其他软件出版 | 其他軟體出版 |
| I300015 | 80000 | Quarrying and other mining of non-metal ores | 采石及其他非金属矿的采掘 | 採石及其他非金屬礦的採掘 |
| I300748 | 601000 | Radio broadcasting | 电台广播 | 電臺廣播 |
| I300673 | 491000 | Railway and cable transport | 铁路及缆索运输 | 鐵路及纜索運輸 |
| I300003 | 14100 | Raising of livestock | 家畜的饲养 | 家畜的飼養 |
| I300005 | 14900 | Raising of other animals | 其他动物的饲养 | 其他動物的飼養 |
| I300004 | 14200 | Raising of poultry and eggs | 饲养家禽及采蛋 | 飼養家禽及采蛋 |
| I300791 | 682100 | Real estate brokerage and agency | 地产经纪及代理 | 地產經紀及代理 |
| I300787 | 681100 | Real estate development | 地产发展 | 地產發展 |
| I300789 | 681300 | Real estate development with leasing | 地产发展兼租赁 | 地產發展兼租賃 |
| I300788 | 681200 | Real estate leasing | 地产租赁 | 地產租賃 |
| I300792 | 682200 | Real estate maintenance management | 地产保养管理服务 | 地產保養管理服務 |
| I300250 | 383900 | Recovery of materials n.e.c. | 其他资源的回收 | 其他資源的回收 |
| I300251 | 390000 | Remediation activities and other waste | 污染防治活动及其他废弃物处理服务 | 污染防治活動及其他廢棄物處理服務 |
| I300017 | 101100 | Rendering of lard and tallow | 猪油及动物油的熬制 | 豬油及動物油的熬制 |
| I300828 | 771000 | Renting and leasing machinery and equipment | 机械设备租赁 | 機械設備租賃 |
| I300831 | 772900 | Renting and leasing of other personal and household goods | 其他个人及家庭用品租赁 | 其他個人及家庭用品租賃 |
| I300829 | 772100 | Renting and leasing of recreational and sports goods | 康乐及运动用品租赁 | 康樂及運動用品租賃 |
| I300830 | 772200 | Renting of video tapes and discs | 录影带及光盘租赁 | 錄影帶及光碟租賃 |
| I300237 | 331500 | Repair of air, water and rail transport equipment | 空中、海上及铁道运输设备维修 | 空中、海上及鐵道運輸設備維修 |
| I300944 | 953100 | Repair of audio and visual electronic products | 视听电子产品修理 | 視聽電子產品修理 |
| I300943 | 952200 | Repair of communications equipment | 通讯设备修理 | 通訊設備修理 |
| I300942 | 952100 | Repair of computers and peripheral equipment | 计算机及外围设备修理 | 電腦及週邊設備修理 |
| I300236 | 331400 | Repair of electrical equipment | 电力设备维修 | 電力設備維修 |
| I300235 | 331300 | Repair of electronic and optical equipment | 电子及光学设备维修 | 電子及光學設備維修 |
| I300233 | 331100 | Repair of fabricated metal products | 金属制品维修 | 金屬製品維修 |
| I300946 | 953300 | Repair of footwear and leather goods | 鞋类及皮革制品修补 | 鞋類及皮革製品修補 |
| I300947 | 953400 | Repair of furniture and home furnishings | 家具及室内陈设品修理 | 傢俱及室內陳設品修理 |
| I300945 | 953200 | Repair of household appliances, home and garden equipment | 家用器具及庭园设备修理 | 家用器具及庭園設備修理 |
| I300950 | 953700 | Repair of jewellery | 珠宝修理 | 珠寶修理 |
| I300234 | 331200 | Repair of machinery | 机械维修 | 機械維修 |
| I300238 | 331900 | Repair of other non-household equipment | 其他非家居用设备维修 | 其他非家居用設備維修 |
| I300951 | 953900 | Repair of other personal and household goods | 其他个人及家庭用品修理 | 其他個人及家庭用品修理 |
| I300949 | 953600 | Repair of watches and clocks | 钟表修理 | 鐘錶修理 |
| I300122 | 182000 | Reproduction of recorded media | 已储录资料媒体的复制 | 已儲錄資料媒體的複製 |
| I300812 | 721000 | Research and development on natural sciences and engineering | 自然科学及工程学研究及发展 | 自然科學及工程學研究及發展 |
| I300813 | 722000 | Research and development on social sciences and humanities | 社会科学及人文科学研究及发展 | 社會科學及人文科學研究及發展 |
| I300902 | 874000 | Residential care activities for persons with disabilities | 残疾人士住宿照顾活动 | 殘疾人士住宿照顧活動 |
| I300900 | 872000 | Residential care activities for substance abuse | 药物滥用者住宿照顾活动 | 藥物濫用者住宿照顧活動 |
| I300901 | 873000 | Residential care activities for the elderly | 长者住宿照顾活动 | 長者住宿照顧活動 |
| I300728 | 561199 | Restaurants n.e.c. | 其他餐馆 | 其他餐館 |
| I300763 | 641202 | Restricted licensed banks | 有限制牌照银行 | 有限制牌照銀行 |
| I300638 | 477201 | Retail sale of Chinese drugs and herbs | 中草药及中成药零售店 | 中草藥及中成藥零售店 |
| I300655 | 477412 | Retail sale of Chinese religious articles | 中式宗教物品零售店 | 中式宗教物品零售店 |
| I300599 | 472201 | Retail sale of alcoholic beverages in specialised stores | 酒类饮品专卖零售店 | 酒類飲品專賣零售店 |
| I300665 | 477501 | Retail sale of antiques | 古玩零售店 | 古玩零售店 |
| I300609 | 474200 | Retail sale of audio and video equipment | 视听器材零售店 | 視聽器材零售店 |
| I300620 | 475901 | Retail sale of bamboo and cane products (excl. furniture and fixtures) | 竹制品及藤制品零售店(家具及固定装置除外) | 竹製品及藤製品零售店(傢俱及固定裝置除外) |
| I300596 | 472113 | Retail sale of bean curd and bean products | 豆腐及豆类制品零售店 | 豆腐及豆類製品零售店 |
| I300601 | 472299 | Retail sale of beverages (incl. alcoholic and non-alcoholic) | 饮品(包括酒类及非酒类)零售店 | 飲品(包括酒類及非酒類)零售店 |
| I300627 | 476100 | Retail sale of books, newspapers and stationary | 书报及文具零售店 | 書報及文具零售店 |
| I300586 | 472101 | Retail sale of bread and pastry | 面包及糕饼类食品零售店 | 麵包及糕餅類食品零售店 |
| I300623 | 475904 | Retail sale of canvas and canvas products | 帆布及帆布制品零售店 | 帆布及帆布製品零售店 |
| I300619 | 475300 | Retail sale of carpets, rugs, wall and floor coverings | 地毯、围毡、墙壁与地板覆盖物零售店 | 地毯、圍氈、牆壁與地板覆蓋物零售店 |
| I300621 | 475902 | Retail sale of china, earthenware and glassware | 陶瓷及玻璃制品零售店 | 陶瓷及玻璃製品零售店 |
| I300631 | 476402 | Retail sale of computer games | 计算机游戏零售店 | 電腦遊戲零售店 |
| I300608 | 474103 | Retail sale of computer software | 计算机软件包零售店 | 電腦套裝軟體零售店 |
| I300607 | 474102 | Retail sale of computers and peripheral units | 计算机及接口设备零售店 | 電腦及周邊設備零售店 |
| I300587 | 472102 | Retail sale of confectioneries and biscuits | 糖果及饼干零售店 | 糖果及餅乾零售店 |
| I300622 | 475903 | Retail sale of cooking and kitchen utensils, other than electrical | 非电动的厨房及煮食用具零售店 | 非電動的廚房及煮食用具零售店 |
| I300641 | 477204 | Retail sale of cosmetics and personal care products | 化妆品及个人护理用品零售店 | 化妝品及個人護理用品零售店 |
| I300615 | 475106 | Retail sale of drapery (incl. blinds and curtains) | 帐幔零售店(包括滚动条式窗帘及一般窗帘) | 帳幔零售店(包括捲軸式窗簾及一般窗簾) |
| I300597 | 472114 | Retail sale of eggs | 蛋类零售店 | 蛋類零售店 |
| I300624 | 475905 | Retail sale of electrical goods (excl. machinery, office and telecommunications equipment and applia | 电器零售店(机械、办公室及电讯设备及器材、视听器材除外) | 電器零售店(機械、辦公室及電訊設備及器材、視聽器材除外) |
| I300613 | 475104 | Retail sale of embroidery and drawn works | 刺绣及抽纱制品零售店 | 刺繡及抽紗製品零售店 |
| I300610 | 475101 | Retail sale of fabrics | 布料零售店 | 布料零售店 |
| I300658 | 477415 | Retail sale of fire prevention equipment | 防火设备零售店 | 防火設備零售店 |
| I300604 | 473200 | Retail sale of firewood, charcoal, coke and similar fuels | 柴炭煤类燃料零售店 | 柴炭煤類燃料零售店 |
| I300588 | 472103 | Retail sale of fish and other sea products, dried or preserved | 经干制或腌制的鱼类及其他海产食品零售店 | 經幹制或醃制的魚類及其他海產食品零售店 |
| I300589 | 472104 | Retail sale of fish, other sea products and meat, fresh or frozen | 新鲜或急冻的鱼类、其他海产食品及肉类零售店 | 新鮮或急凍的魚類、其他海產食品及肉類零售店 |
| I300656 | 477413 | Retail sale of flowers and plants (incl. seeds, fertilisers and horticultural sundries) | 花卉及植物零售店(包括种子、化肥及园艺用品) | 花卉及植物零售店(包括種子、化肥及園藝用品) |
| I300668 | 478101 | Retail sale of food, beverages and tobacco products via mobile stalls | 经流动货摊的食品、饮料及烟草制品零售 | 經流動貨攤的食品、飲料及煙草製品零售 |
| I300633 | 477101 | Retail sale of footwear and shoe accessories | 鞋及鞋类配件零售店 | 鞋及鞋類配件零售店 |
| I300590 | 472105 | Retail sale of fruits and vegetables, fresh | 新鲜蔬果零售店 | 新鮮蔬果零售店 |
| I300625 | 475906 | Retail sale of furniture and fixtures | 家具及固定装置零售店 | 傢俱及固定裝置零售店 |
| I300632 | 476403 | Retail sale of gambling apparatus | 赌具零售店 | 賭具零售店 |
| I300659 | 477416 | Retail sale of gifts, novelties and souvenirs | 礼品、精品及纪念品零售店 | 禮品、精品及紀念品零售店 |
| I300618 | 475200 | Retail sale of hardware, metalware, paints and other building renovation materials | 五金器具、金属配件、油漆及其他装修材料零售店 | 五金器具、金屬配件、油漆及其他裝修材料零售店 |
| I300626 | 475999 | Retail sale of household articles n.e.c. | 其他家庭用品零售店 | 其他家庭用品零售店 |
| I300614 | 475105 | Retail sale of household linen | 日用寝具零售店 | 日用寢具零售店 |
| I300648 | 477403 | Retail sale of imitation jewellery and related articles | 人造珠宝及相关物品零售店 | 人造珠寶及相關物品零售店 |
| I300647 | 477402 | Retail sale of jewellery and precious metal accessories | 珠宝首饰及贵金属装饰物零售店 | 珠寶首飾及貴金屬裝飾物零售店 |
| I300605 | 473300 | Retail sale of kerosene and L.P. gas | 火水及石油气零售店 | 火水及石油氣零售店 |
| I300612 | 475103 | Retail sale of knitting yarn | 针织用纱线零售店 | 針織用紗線零售店 |
| I300636 | 477104 | Retail sale of luggage cases, handbags and similar articles of leather or leather substitutes | 皮革或类似材料制的行李箱、手袋及同类物品零售店 | 皮革或類似材料制的行李箱、手袋及同類物品零售店 |
| I300594 | 472111 | Retail sale of meat, roasted, dried or preserved | 经烤制、干制或腌制的肉类零售店 | 經烤制、幹制或醃制的肉類零售店 |
| I300640 | 477203 | Retail sale of medical goods | 医疗用品零售店 | 醫療用品零售店 |
| I300639 | 477202 | Retail sale of medicines and health supplements (with or without selling cosmetics and personal care | 药物及健康补给品零售店(兼售或不兼售化妆品及个人护理用品) | 藥物及健康補給品零售店(兼售或不兼售化妝品及個人護理用品) |
| I300644 | 477303 | Retail sale of motor vehicle and motorcycle parts and accessories | 汽车及电单车配件及零件零售店 | 汽車及電單車配件及零件零售店 |
| I300642 | 477301 | Retail sale of motor vehicles | 汽车零售店 | 汽車零售店 |
| I300643 | 477302 | Retail sale of motorcycles | 电单车零售店 | 電單車零售店 |
| I300628 | 476200 | Retail sale of music and video recordings | 录音及录像零售店 | 錄音及錄像零售店 |
| I300652 | 477407 | Retail sale of musical instruments | 乐器零售店 | 樂器零售店 |
| I300600 | 472202 | Retail sale of non-alcoholic beverages in specialised stores | 非酒类饮品专卖零售店 | 非酒類飲品專賣零售店 |
| I300591 | 472106 | Retail sale of noodles and rice sticks | 粉面零售店 | 粉面零售店 |
| I300663 | 477422 | Retail sale of office appliances and equipment (excl. computers, furniture and fixtures) | 办公室器材零售店(计算机、家具及固定装置除外) | 辦公室器材零售店(電腦、傢俱及固定裝置除外) |
| I300670 | 478199 | Retail sale of other goods via mobile stalls | 经流动货摊的其他商品零售 | 經流動貨攤的其他商品零售 |
| I300617 | 475199 | Retail sale of other textiles or textiles of several kinds | 其他纺织品或多类纺织品综合零售店 | 其他紡織品或多類紡織品綜合零售店 |
| I300645 | 477399 | Retail sale of other transport equipment (except motor vehicles and motorcycles) | 其他运输设备零售店(汽车及电单车除外) | 其他運輸設備零售店(汽車及電單車除外) |
| I300654 | 477411 | Retail sale of paper products | 纸制品零售店 | 紙製品零售店 |
| I300657 | 477414 | Retail sale of pets and animals (incl. feeds and accessories) | 宠物及动物零售店(包括饲料及配件) | 寵物及動物零售店(包括飼料及配件) |
| I300650 | 477405 | Retail sale of photographic equipment and supplies | 摄影器材及用品零售店 | 攝影器材及用品零售店 |
| I300592 | 472107 | Retail sale of preserved provisions and spices (incl. dried or preserved fruits and vegetables) | 经腌制的食品及香料零售店(包括经干制或腌制的蔬果) | 經醃制的食品及香料零售店(包括經幹制或醃制的蔬果) |
| I300593 | 472108 | Retail sale of rice | 食米零售店 | 食米零售店 |
| I300616 | 475107 | Retail sale of rope, cord and netting appliances | 绳索及网类用具零售店 | 繩索及網類用具零售店 |
| I300651 | 477406 | Retail sale of sacks and bags (excl. handbags and travelling bags) | 袋类制品零售店(手袋及旅行袋除外) | 袋類製品零售店(手袋及旅行袋除外) |
| I300661 | 477418 | Retail sale of scientific & professional instruments (excl. medical & dental equipment and appliance | 科学及专业仪器零售店(医疗及牙科设备与器材除外) | 科學及專業儀器零售店(醫療及牙科設備與器材除外) |
| I300667 | 477599 | Retail sale of second-hand goods n.e.c. | 其他二手货品零售店 | 其他二手貨品零售店 |
| I300662 | 477421 | Retail sale of sewing machines and parts (incl. stands) | 衣车及其零件零售店(包括衣车架) | 衣車及其零件零售店(包括衣車架) |
| I300629 | 476300 | Retail sale of sporting equipment | 运动设备零售店 | 運動設備零售店 |
| I300611 | 475102 | Retail sale of tailoring accessories and trimming materials | 缝纫用辅件及饰料零售店 | 縫紉用輔件及飾料零售店 |
| I300595 | 472112 | Retail sale of tea | 茶叶零售店 | 茶葉零售店 |
| I300606 | 474101 | Retail sale of telecommunications equipment | 电讯设备零售店 | 電訊設備零售店 |
| I300669 | 478102 | Retail sale of textiles, clothing and footwear via mobile stalls | 经流动货摊的纺织品、衣着及鞋类零售 | 經流動貨攤的紡織品、衣著及鞋類零售 |
| I300602 | 472300 | Retail sale of tobacco products in specialised stores | 烟草制品专卖零售店 | 煙草製品專賣零售店 |
| I300630 | 476401 | Retail sale of toys | 玩具零售店 | 玩具零售店 |
| I300635 | 477103 | Retail sale of umbrellas | 雨伞零售店 | 雨傘零售店 |
| I300653 | 477408 | Retail sale of watches and clocks | 钟表零售店 | 鐘錶零售店 |
| I300634 | 477102 | Retail sale of wearing apparel | 服装零售店 | 服裝零售店 |
| I300646 | 477401 | Retail sale of works of art and craft | 工艺品零售店 | 工藝品零售店 |
| I300671 | 478201 | Retail sale via mail order or internet | 经邮购或互联网的零售 | 經郵購或互聯網的零售 |
| I300070 | 139207 | Ribbon and tape cutting (excl. weaving of label and narrow fabrics) | 丝带及布带切割(梭织标签及窄幅布条除外) | 絲帶及布帶切割(梭織標籤及窄幅布條除外) |
| I300868 | 854111 | Riding instruction | 骑术训练 | 騎術訓練 |
| I300783 | 662100 | Risk and damage evaluation | 风险及损失评估 | 風險及損失評估 |
| I300290 | 439908 | Roofing and water proofing | 天面及防水工程 | 天面及防水工程 |
| I300100 | 161000 | Sawmilling and planing of wood | 锯木及刨木 | 鋸木及刨木 |
| I300679 | 492400 | Scheduled public light bus services | 专线公共小型巴士服务 | 專線公共小型巴士服務 |
| I300680 | 492500 | School bus services | 校车服务 | 校車服務 |
| I300875 | 854205 | Sculpture instruction | 雕塑教学 | 雕塑教學 |
| I300707 | 522902 | Sea cargo forwarding services | 海上货运代理服务 | 海上貨運代理服務 |
| I300858 | 852000 | Secondary schools | 中学 | 中學 |
| I300778 | 661202 | Securities brokerage | 证券经纪服务 | 證券經紀服務 |
| I300838 | 801000 | Security guard services | 人身财物护卫服务 | 人身財物護衛服務 |
| I300839 | 802000 | Security system operation services | 保安系统操控服务 | 保安系統操控服務 |
| I300705 | 522300 | Service activities incidental to air transportation | 航空运输辅助服务活动 | 航空運輸輔助服務活動 |
| I300699 | 522199 | Service activities incidental to land transportation n.e.c. | 其他陆路运输辅助服务活动 | 其他陸路運輸輔助服務活動 |
| I300704 | 522299 | Service activities incidental to water transportation n.e.c. | 其他水上运输辅助服务活动 | 其他水上運輸輔助服務活動 |
| I300941 | 951000 | Servicing and repairing of motor vehicles and motorcycles | 汽车及电单车维修服务 | 汽車及電單車維修服務 |
| I300244 | 370000 | Sewerage | 自来水集取、处理及供应 | 自來水集取、處理及供應 |
| I300289 | 439907 | Sheet metal work | 金属片铺设 | 金屬片鋪設 |
| I300686 | 501502 | Ship owners and operators of freight vessels moving between Hong Kong and the ports in Pearl River D | 往来香港与珠江三角洲港口的货轮船东及营运者 | 往來香港與珠江三角洲港口的貨輪船東及營運者 |
| I300685 | 501501 | Ship owners and operators of passenger vessels moving between Hong Kong and the ports in Pearl River | 往来香港与珠江三角洲港口的客轮船东及营运者 | 往來香港與珠江三角洲港口的客輪船東及營運者 |
| I300682 | 501302 | Ship owners of sea-going vessels for freight transport | 作货运服务的远洋轮船船东 | 作貨運服務的遠洋輪船船東 |
| I300681 | 501301 | Ship owners of sea-going vessels for passenger transport | 作客运服务的远洋轮船船东 | 作客運服務的遠洋輪船船東 |
| I300711 | 522906 | Shipbrokers | 船只经纪 | 船隻經紀 |
| I300261 | 431201 | Site formation and clearance | 地盘开拓及整理 | 地盤開拓及整理 |
| I300263 | 431203 | Site investigation | 地盘勘探 | 地盤勘探 |
| I300867 | 854108 | Skating and roller skating instruction | 溜冰及滚轴溜冰训练 | 溜冰及滾軸溜冰訓練 |
| I300920 | 931104 | Skating centres | 溜冰场 | 溜冰場 |
| I300018 | 101200 | Slaughtering | 屠宰 | 屠宰 |
| I300905 | 882000 | Social work activities without accommodation for the disabled | 不提供住宿的残疾人士社会工作活动 | 不提供住宿的殘疾人士社會工作活動 |
| I300904 | 881000 | Social work activities without accommodation for the elderly | 不提供住宿的老人社会工作活动 | 不提供住宿的老人社會工作活動 |
| I300794 | 691100 | Solicitor services | 事务律师法律服务 | 事務律師法律服務 |
| I300747 | 592000 | Sound recording and music publishing activities | 录音及音乐出版活动 | 錄音及音樂出版活動 |
| I300880 | 854300 | Special education | 特殊教育 | 特殊教育 |
| I300823 | 751900 | Specialised design activities n.e.c. | 其他专门设计活动 | 其他專門設計活動 |
| I300598 | 472199 | Specialised food retail stores, without seats provided n.e.c. | 其他专门食品零售店(不设座位) | 其他專門食品零售店(不設座位) |
| I300047 | 131199 | Spinning n.e.c. | 其他纺纱 | 其他紡紗 |
| I300044 | 131102 | Spinning, cotton | 纺棉纱 | 紡棉紗 |
| I300046 | 131104 | Spinning, synthetic fibre | 纺合成纤维纱 | 紡合成纖維紗 |
| I300045 | 131103 | Spinning, wool | 纺毛纱 | 紡毛紗 |
| I300731 | 561902 | Stalls at food court | 美食广场内的小店 | 美食廣場內的小店 |
| I300666 | 477502 | Stamp collection shops | 集邮社 | 集郵社 |
| I300284 | 439902 | Steel bending (incl. welding) | 扎铁工程(包括焊接) | 紮鐵工程(包括焊接) |
| I300254 | 419100 | Structural alteration and addition works | 建筑物结构更改及加建工程 | 建築物結構更改及加建工程 |
| I300804 | 711300 | Structural engineering services | 结构工程服务 | 結構工程服務 |
| I300253 | 412000 | Structural steel framework erection | 结构钢架工程 | 結構鋼架工程 |
| I300580 | 471101 | Supermarkets | 超级市场 | 超級市場 |
| I300242 | 359000 | Supply of air-conditioning, steam and similar products through mains systems | 空调、蒸汽及类似产品透过输配系统的供应 | 空調、蒸汽及類似產品透過輸配系統的供應 |
| I300007 | 16000 | Support activities to agriculture and post-harvest | 农业辅助活动及农作物收成后处理活动 | 農業輔助活動及農作物收成後處理活動 |
| I300803 | 711200 | Surveying services related to real estate and construction | 与建造及地产相关的测量服务 | 與建造及地產相關的測量服務 |
| I300862 | 854103 | Swimming and lifeguard instruction | 游泳拯溺训练 | 游泳拯溺訓練 |
| I300919 | 931103 | Swimming pools | 游泳池 | 游泳池 |
| I300051 | 131204 | Synthetic fibres weaving | 梭织合成纤维布 | 梭織合成纖維布 |
| I300082 | 141102 | Tailoring (excl. custom tailoring without workshop) | 裁缝(不设工厂的裁缝店除外) | 裁縫(不設工廠的裁縫店除外) |
| I300732 | 561903 | Takeaway shops and meal outlets without seats | 外卖店及不设座位的餐膳售卖处 | 外賣店及不設座位的餐膳售賣處 |
| I300095 | 151100 | Tanning and dressing of leather; dressing and dyeing of fur | 皮革鞣制和修整、毛皮修整与染色的制造及加工 | 皮革鞣制和修整、毛皮修整與染色的製造及加工 |
| I300810 | 712000 | Technical testing and analysis | 技术测试及分析 | 技術測試及分析 |
| I300271 | 432106 | Telecommunications equipment, installation and maintenance | 电讯设备安装及保养 | 電訊設備安裝及保養 |
| I300750 | 611000 | Telecommunications network operation | 电讯网络营运 | 電訊網路營運 |
| I300749 | 602000 | Television programming and broadcasting activities | 电视节目编制及广播活动 | 電視節目編制及廣播活動 |
| I300923 | 931107 | Tennis courts | 网球场馆 | 網球場館 |
| I300060 | 131399 | Textile finishing n.e.c. | 纺织品的其他整理 | 紡織品的其他整理 |
| I300053 | 131301 | Textile stencilling and printing of fabrics | 布料印花 | 布料印花 |
| I300054 | 131302 | Textile stencilling and printing of garment | 成衣印花 | 成衣印花 |
| I300043 | 131101 | Texturising | 鬈曲 | 鬈曲 |
| I300721 | 561105 | Thai cuisine restaurants | 泰式餐馆 | 泰式餐館 |
| I300808 | 711700 | Town planning and urban design activities | 城市规划及设计活动 | 城市規劃及設計活動 |
| I300826 | 753000 | Translation and interpretation services | 翻译及传译服务 | 翻譯及傳譯服務 |
| I300836 | 791000 | Travel agency activities | 旅行代理活动 | 旅行代理活動 |
| I300172 | 259299 | Treatment and coating of metals n.e.c. | 金属的其他处理和包覆 | 金屬的其他處理和包覆 |
| I300248 | 382200 | Treatment and disposal of hazardous waste | 有害废弃物的处理及处置 | 有害廢棄物的處理及處置 |
| I300247 | 382100 | Treatment and disposal of non-hazardous waste | 无害废弃物的处理及处置 | 無害廢棄物的處理及處置 |
| I300781 | 661902 | Trustees and custodians | 受托人及保管人 | 受託人及保管人 |
| I300767 | 644000 | Trusts, funds and similar financial entities | 信托,基金及相关金融工具 | 信託,基金及相關金融工具 |
| I300859 | 853000 | Universities and colleges providing post-secondary courses | 大学及提供专上课程的院校 | 大學及提供專上課程的院校 |
| I300675 | 492201 | Urban taxi services | 市区的士服务 | 市區的士服務 |
| I300697 | 522102 | Vehicular tunnel, bridge and highway operators | 汽车隧道、桥梁及高速公路营运者 | 汽車隧道、橋樑及高速公路營運者 |
| I300815 | 730000 | Veterinary activities | 兽医活动 | 獸醫活動 |
| I300722 | 561106 | Vietnamese cuisine restaurants | 越式餐馆 | 越式餐館 |
| I300243 | 360000 | Water collection, treatment and supply | 污水处理 | 污水處理 |
| I300274 | 432202 | Water plumbing and drain laying | 供水管及排水管铺设 | 供水管及排水管鋪設 |
| I300275 | 432203 | Water well drilling | 钻水井 | 鑽水井 |
| I300052 | 131299 | Weaving, blend fibre and other textiles n.e.c. | 梭织混纺织物及其他纺织布 | 梭織混紡織物及其他紡織布 |
| I300048 | 131201 | Weaving, cotton | 梭织棉布 | 梭織棉布 |
| I300077 | 139500 | Weaving, labels (excl. laces, ribbon/tape, ropes, twines and cordage) | 梭织标签(花边、丝带、饰带、绳、合股线及索具除外) | 梭織標籤(花邊、絲帶、飾帶、繩、合股線及索具除外) |
| I300050 | 131203 | Weaving, silk | 梭织丝绸 | 梭織絲綢 |
| I300049 | 131202 | Weaving, wool | 梭织毛布 | 梭織毛布 |
| I300758 | 631200 | Web portals | 入门网站 | 入門網站 |
| I300955 | 960203 | Weight control and slimming services | 体重控制及纤体服务 | 體重控制及纖體服務 |
| I300908 | 885000 | Welfare foundations and development projects | 福利基金及发展计划服务 | 福利基金及發展計畫服務 |
| I300529 | 460425 | Wholesale of Chinese drugs and herbs | 中成药及中草药批发 | 中成藥及中草藥批發 |
| I300548 | 460448 | Wholesale of Chinese religious articles | 中式宗教物品批发 | 中式宗教物品批發 |
| I300561 | 460621 | Wholesale of agricultural machinery, equipment and supplies | 农业机械、设备及其配备批发 | 農業機械、設備及其配備批發 |
| I300494 | 460299 | Wholesale of agricultural products and live animals n.e.c. | 其他农业原材料及活动物批发 | 其他農業原材料及活動物批發 |
| I300513 | 460323 | Wholesale of alcoholic drinks | 酒类饮品批发 | 酒類飲品批發 |
| I300525 | 460421 | Wholesale of antiques and works of art and craft | 古玩及工艺品批发 | 古玩及工藝品批發 |
| I300526 | 460422 | Wholesale of bamboo and cane products (excl. furniture and fixtures) | 竹制品及藤制品批发(家具及固定装置除外) | 竹製品及藤製品批發(傢俱及固定裝置除外) |
| I300559 | 460612 | Wholesale of blank audio and video tapes, diskettes, CDs and DVDs | 空白录音带、录影带、磁盘、光盘及数码视盘批发 | 空白錄音帶、錄影帶、磁片、光碟及數碼視訊光碟批發 |
| I300527 | 460423 | Wholesale of books, periodicals and newspapers | 书报及期刊批发 | 書報及期刊批發 |
| I300495 | 460301 | Wholesale of canned foods | 罐头食品批发 | 罐頭食品批發 |
| I300566 | 460635 | Wholesale of cases and other parts for watches and clocks | 钟表壳及其他钟表零件批发 | 鐘錶殼及其他鐘錶零件批發 |
| I300574 | 460741 | Wholesale of chemicals and allied products | 化学原料及有关产品批发 | 化學原料及有關產品批發 |
| I300528 | 460424 | Wholesale of china, earthenware and glassware | 陶瓷及玻璃制品批发 | 陶瓷及玻璃製品批發 |
| I300545 | 460445 | Wholesale of computer games | 计算机游戏批发 | 電腦遊戲批發 |
| I300557 | 460602 | Wholesale of computer software | 计算机软件包批发 | 電腦套裝軟體批發 |
| I300556 | 460601 | Wholesale of computers and computer peripheral equipment | 计算机及计算机接口设备批发 | 電腦及電腦周邊設備批發 |
| I300496 | 460302 | Wholesale of confectioneries and biscuits | 糖果及饼干批发 | 糖果及餅乾批發 |
| I300572 | 460721 | Wholesale of construction materials, hardware and plumbing equipment and supplies | 建材、五金、水管设备及其配备批发 | 建材、五金、水管設備及其配備批發 |
| I300530 | 460426 | Wholesale of cooking and kitchen utensils, other than electrical | 非电动的煮食及厨房用具批发 | 非電動的煮食及廚房用具批發 |
| I300533 | 460431 | Wholesale of cosmetics and perfumes | 化妆品及香水批发 | 化妝品及香水批發 |
| I300488 | 460202 | Wholesale of cotton, textile fibre and yarn | 棉花、纺织纤维及纱线批发 | 棉花、紡織纖維及紗線批發 |
| I300497 | 460303 | Wholesale of dairy products | 乳类制品批发 | 乳類製品批發 |
| I300532 | 460428 | Wholesale of drugs and pharmaceuticals (excl. Chinese drugs and herbs) | 药物批发(中成药及中草药除外) | 藥物批發(中成藥及中草藥除外) |
| I300498 | 460304 | Wholesale of edible oils | 食油批发 | 食油批發 |
| I300500 | 460306 | Wholesale of eggs | 蛋类批发 | 蛋類批發 |
| I300550 | 460452 | Wholesale of electrical goods (excl. machinery, office and telecommunications equipment and applianc | 电器批发(机械、办公室及电讯设备及器材除外) | 電器批發(機械、辦公室及電訊設備及器材除外) |
| I300560 | 460613 | Wholesale of electronic parts | 电子零件批发 | 電子零件批發 |
| I300520 | 460405 | Wholesale of embroidery and drawn works | 刺绣及抽纱制品批发 | 刺繡及抽紗製品批發 |
| I300517 | 460402 | Wholesale of fabrics | 布料批发 | 布料批發 |
| I300501 | 460307 | Wholesale of feeds for animals and pets | 动物及宠物饲料批发 | 動物及寵物飼料批發 |
| I300568 | 460701 | Wholesale of firewood, charcoal, coke and similar fuels | 柴炭煤类燃料批发 | 柴炭煤類燃料批發 |
| I300502 | 460308 | Wholesale of fish and other sea products, dried or preserved | 经干制或腌制的鱼类及其他海产食品批发 | 經幹制或醃制的魚類及其他海產食品批發 |
| I300503 | 460311 | Wholesale of fish and other sea products, fresh or frozen | 新鲜或急冻的鱼类及其他海产食品批发 | 新鮮或急凍的魚類及其他海產食品批發 |
| I300516 | 460401 | Wholesale of footwear and shoe accessories | 鞋及鞋类配件批发 | 鞋及鞋類配件批發 |
| I300492 | 460206 | Wholesale of fresh flowers and plants | 鲜花及植物批发 | 鮮花及植物批發 |
| I300504 | 460312 | Wholesale of fruits and vegetables, fresh | 新鲜蔬果批发 | 新鮮蔬果批發 |
| I300573 | 460731 | Wholesale of furniture and fixtures | 家具及固定装置批发 | 傢俱及固定裝置批發 |
| I300514 | 460324 | Wholesale of groceries of general provisions | 一般粮油食品批发 | 一般糧油食品批發 |
| I300536 | 460434 | Wholesale of hardware and metalware | 五金器具及金属配件批发 | 五金器具及金屬配件批發 |
| I300551 | 460499 | Wholesale of household goods n.e.c. | 其他家庭用品批发 | 其他家庭用品批發 |
| I300521 | 460406 | Wholesale of household linen, drapery, carpets, rugs and allied products | 日用寝具织品、帐幔、地毡、围毡及同类制品批发 | 日用寢具織品、帳幔、地氈、圍氈及同類製品批發 |
| I300535 | 460433 | Wholesale of imitation jewellery and related articles | 人造珠宝及相关物品批发 | 人造珠寶及相關物品批發 |
| I300534 | 460432 | Wholesale of jewellery and precious metal accessories | 珠宝首饰及贵金属装饰物批发 | 珠寶首飾及貴金屬裝飾物批發 |
| I300489 | 460203 | Wholesale of leather (incl. imitation leather and other plastic sheetings) | 皮革批发(包括人造皮及其他塑料皮) | 皮革批發(包括人造皮及其他塑膠皮) |
| I300487 | 460201 | Wholesale of livestock and poultry | 禽畜批发 | 禽畜批發 |
| I300524 | 460411 | Wholesale of luggage cases, handbags and similar articles of leather or leather substitutes | 皮革或类似材料制的行李箱、手袋及同类物品批发 | 皮革或類似材料制的行李箱、手袋及同類物品批發 |
| I300567 | 460699 | Wholesale of machinery and equipment n.e.c. (except furniture) | 其他机械及设备批发(家具除外) | 其他機械及設備批發(傢俱除外) |
| I300505 | 460313 | Wholesale of meat, fresh or frozen (incl. poultry and meat of wild animals) | 新鲜或急冻肉类批发(包括家禽肉类及野味) | 新鮮或急凍肉類批發(包括家禽肉類及野味) |
| I300510 | 460318 | Wholesale of meat, roasted, dried or preserved | 经烤制、干制或腌制的肉类批发 | 經烤制、幹制或醃制的肉類批發 |
| I300564 | 460633 | Wholesale of medical, health and hospital equipment and supplies | 医疗、卫生及医院设备与用品批发 | 醫療、衛生及醫院設備與用品批發 |
| I300571 | 460711 | Wholesale of metals and metal ores | 金属及金属矿批发 | 金屬及金屬礦批發 |
| I300552 | 460501 | Wholesale of motor vehicles | 汽车批发 | 汽車批發 |
| I300553 | 460502 | Wholesale of motorcycles | 电单车批发 | 電單車批發 |
| I300542 | 460442 | Wholesale of musical instruments | 乐器批发 | 樂器批發 |
| I300506 | 460314 | Wholesale of noodles | 粉面批发 | 粉面批發 |
| I300499 | 460305 | Wholesale of nuts, seeds and dried beans | 食用硬壳果、果仁及干豆批发 | 食用硬殼果、果仁及幹豆批發 |
| I300565 | 460634 | Wholesale of office appliances and equipment (excl. computers, furniture and fixtures) | 办公室器材及设备批发(计算机、家具及固定装置除外) | 辦公室器材及設備批發(電腦、傢俱及固定裝置除外) |
| I300569 | 460702 | Wholesale of oil fuels and lubricants | 燃油及润滑油批发 | 燃油及潤滑油批發 |
| I300578 | 460799 | Wholesale of other specialised products n.e.c | 其他专卖产品批发 | 其他專賣產品批發 |
| I300555 | 460599 | Wholesale of other transport equipment (except motor vehicles and motorcycles) | 其他运输设备批发(汽车及电单车除外) | 其他運輸設備批發(汽車及電單車除外) |
| I300575 | 460742 | Wholesale of paints and varnishes | 油漆及清漆批发 | 油漆及清漆批發 |
| I300576 | 460743 | Wholesale of paper for industrial use and printing | 工业及印刷用纸批发 | 工業及印刷用紙批發 |
| I300547 | 460447 | Wholesale of paper products | 纸制品批发 | 紙製品批發 |
| I300554 | 460503 | Wholesale of parts and accessories of motor vehicles and motorcycles | 汽车及电单车配件及零件批发 | 汽車及電單車配件及零件批發 |
| I300493 | 460207 | Wholesale of pet animals (incl. aquarium fish) | 宠物动物(包括观赏鱼类)批发 | 寵物動物(包括觀賞魚類)批發 |
| I300570 | 460703 | Wholesale of petroleum products (kerosene and L.P. gas) | 石油产品(火水及石油气)批发 | 石油產品(火水及石油氣)批發 |
| I300538 | 460436 | Wholesale of photographic equipment and supplies | 摄影器材及用品批发 | 攝影器材及用品批發 |
| I300549 | 460451 | Wholesale of plastic products (incl. decorative ornaments and flowers) | 塑料制品批发(包括塑料饰物及塑料花) | 塑膠製品批發(包括塑膠飾物及塑膠花) |
| I300511 | 460321 | Wholesale of preserved provisions and spices | 经腌制的食品及香料批发 | 經醃制的食品及香料批發 |
| I300539 | 460437 | Wholesale of recorded audio and video tapes, CDs, DVDs and similar media | 已录制资料的录音带、录影带、光盘、数码视盘及类似媒体批发 | 已錄制資料的錄音帶、錄影帶、光碟、數碼視訊光碟及類似媒體批發 |
| I300507 | 460315 | Wholesale of rice | 食米批发 | 食米批發 |
| I300522 | 460407 | Wholesale of rope, cord and netting appliances | 绳索及网类用具批发 | 繩索及網類用具批發 |
| I300490 | 460204 | Wholesale of rubber | 橡胶批发 | 橡膠批發 |
| I300540 | 460438 | Wholesale of sacks and bags (excl. handbags and travelling bags) | 袋类制品批发(手袋及旅行袋除外) | 袋類製品批發(手袋及旅行袋除外) |
| I300562 | 460631 | Wholesale of scientific and professional instruments (excl. medical and dental instruments) | 科学及专业仪器批发(医疗及牙科仪器除外) | 科學及專業儀器批發(醫療及牙科儀器除外) |
| I300563 | 460632 | Wholesale of sewing machines and parts (incl. stands) | 衣车及其零件批发(包括衣车架) | 衣車及其零件批發(包括衣車架) |
| I300515 | 460399 | Wholesale of specialised food n.e.c. | 其他专门食品批发 | 其他專門食品批發 |
| I300537 | 460435 | Wholesale of spectacles and optical supplies | 眼镜及光学用品批发 | 眼鏡及光學用品批發 |
| I300543 | 460443 | Wholesale of sports goods | 体育用品批发 | 體育用品批發 |
| I300541 | 460441 | Wholesale of stationery | 文具批发 | 文具批發 |
| I300508 | 460316 | Wholesale of sugar and flour | 糖及面粉批发 | 糖及麵粉批發 |
| I300518 | 460403 | Wholesale of tailoring accessories and trimming materials | 缝纫用辅件及饰料批发 | 縫紉用輔件及飾料批發 |
| I300509 | 460317 | Wholesale of tea, coffee and cocoa | 茶叶、咖啡及可可批发 | 茶葉、咖啡及可哥批發 |
| I300558 | 460611 | Wholesale of telecommunications equipment and parts | 电讯设备及其零件批发 | 電訊設備及其零件批發 |
| I300512 | 460322 | Wholesale of tobacco, cigarettes and cigars | 烟草、香烟及雪茄烟批发 | 煙草、香煙及雪茄煙批發 |
| I300531 | 460427 | Wholesale of toilet preparations and cleaning materials | 卫浴用剂及清洁剂料批发 | 衛浴用劑及清潔劑料批發 |
| I300544 | 460444 | Wholesale of toys | 玩具批发 | 玩具批發 |
| I300523 | 460408 | Wholesale of umbrellas | 雨伞批发 | 雨傘批發 |
| I300577 | 460744 | Wholesale of waste and scrap | 废物及废料批发 | 廢物及廢料批發 |
| I300546 | 460446 | Wholesale of watches and clocks | 钟表批发 | 鐘錶批發 |
| I300519 | 460404 | Wholesale of wearing apparel | 服装批发 | 服裝批發 |
| I300491 | 460205 | Wholesale of wood and rattan | 木材及藤料批发 | 木材及藤料批發 |
| I300866 | 854107 | Wilderness skills and mountaineering instruction | 野外技巧及山艺训练 | 野外技巧及山藝訓練 |
| I300293 | 439913 | Window installation and glass glazing | 装窗及玻璃装配 | 裝窗及玻璃裝配 |
| I300865 | 854106 | Windsurfing, yachting and rowing instruction | 风帆、帆船及划艇技巧训练 | 風帆、帆船及划艇技巧訓練 |
| I300863 | 854104 | Yoga and gymnastics instruction | 瑜伽及健身训练 | 瑜伽及健身訓練 |
| I300906 | 883000 | Youth centres | 青少年服务中心 | 青少年服務中心 |
| I300444 | 452434 | related articles Import for wholesale of hardware and metalware | 五金器具及金属配件进口批发 | 五金器具及金屬配件進口批發 |
# Introduction
Source: https://docs.oristapay.com/index
Welcome to OristaPay
By reshaping our architecture, we are redefining the global payments experience; the future of global payments should be seamless, compliant, secure, and Web3-compatible.
Currently, other outdated infrastructures remain fragmented and involve complex processes, requiring businesses to manage multiple partners and systems simultaneously. OristaPay offers a one-stop solution, enabling businesses to easily achieve compliant, secure, and instant exchange between fiat currencies and stablecoins through the OristaPay platform.
## Why choose OristaPay?
Enterprise-grade solutions connecting traditional and digital finance. Whether you're seeking more efficient cross-border funds management or want to embed compliant payment services into your platform, OristaPay leverages secure, licensed, and seamless infrastructure to accelerate your business growth.
Easily manage fiat and stablecoin payments within the OristaPay system, including conversions between them.
Comprehensive risk management and control, compliant with anti-money laundering/combating the financing of terrorism (AML/CFT) and Travel Rule regulatory requirements.
Localized HSM and safe room cold wallet storage system are used to ensure the security of customer information storage
The platform provides clear, straightforward guidance for rapid activation, significantly reducing integration time.
## Extensive application scenarios and industry classifications
Provides detailed support for a wide range of global commercial application scenarios and industry-specific classifications.
In response to the pain points of complex cross-border e-commerce capital links, OristaPay provides secure and compliant multi-currency payment solutions. E-commerce sellers can receive overseas payments in one stop and efficiently send payments to global suppliers. With licensed compliance guarantees, sellers can complete foreign exchange without switching systems, reduce exchange losses, and accelerate global capital flow.
OristaPay is an ideal B2B cross-border payment hub for import and export enterprises. Foreign trade enterprises can quickly receive payments from global buyers and exchange mainstream fiat currencies at highly competitive exchange rates in the system. Combined with its convergence network, enterprises can achieve fast settlement of cross-border funds on the same day, replacing traditional wire transfers and significantly shortening the account period.
OristaPay provides seamless channels for fiat currency and stablecoin deposits and withdrawals for overseas gaming and Web3 digital entertainment platforms. Through its unified account, companies can efficiently collect recharges from global players and quickly distribute earnings to overseas developers. Its compliance system effectively resolves the challenge of slow cross-border payments, helping companies confidently expand their global business.
Addressing the pain points in the tourism industry, OristaPay offers efficient multi-currency (USD, HKD, EUR, etc.) exchange and settlement services. OTAs and travel agencies can utilize its one-stop platform to make B2B payments to overseas ground operators or hotels at transparent and favorable exchange rates. This significantly reduces cross-border transaction fees, enabling faster capital flow in the tourism industry.
OristaPay provides compliant underlying support for fintech enterprises. Leveraging Hong Kong's SVF license, it unifies fiat currency and stablecoin payments on a single platform. Enterprises can seamlessly achieve efficient conversion between fiat currency and digital assets, as well as fund custody, reducing development costs and building an innovative next-generation digital financial ecosystem.
## Contact us
Need more support and communication? [Click here](mailto:itsupport@rd.group) to contact us by email.