Prerequisites
Before you begin, make sure you have:- A User with
USDRail enabled - A Virtual Account configured
Step 1: Create Settlement Rule
POST/v2/virtual-accounts/settlement-rules
Rule Type Examples
Fixed Calculation with Fixed Value
Fixed Calculation with Fixed Value
Fixed Calculation with Percentage
Fixed Calculation with Percentage
Tiered Calculation with Percentage
Tiered Calculation with Percentage
Step 2: Apply Rule to Virtual Account
Associate the settlement rule with a specific user’s virtual account: POST/v2/users/{userId}/virtual-accounts/{accountId}/settlement-rules/{ruleId}
Step 3: Monitor Settlement Activity
Track settlement transactions and fee distributions by:Check Wallet Balances
Monitor the specified wallet addresses in your settlement rules to see incoming fee payments:Look Up Transaction Hashes
When transactions occur, you can look up the transaction hash on the appropriate blockchain explorer:- Base Network: BaseScan
- Polygon Network: PolygonScan
- Ethereum Network: Etherscan
- Transaction details
- Fee amounts transferred
- Confirmation status
- Block information