Simulator (Coming Soon)
Before going live, test every scenario your product might encounter—top-ups, spends, settlements, reversals, and fee events—in a fully isolated sandbox. Sandbox accounts behave identically to production accounts, ensuring your integration handles financial logic perfectly.
No real funds are ever involved.
Authentication
To use the simulator, authenticate your API requests using a Sandbox API Key, which you can generate from your developer dashboard.
What You Can Simulate
The simulator allows you to trigger network-like events programmatically, giving you full control over the testing lifecycle.
Fund Wallets
Simulate funding a business operating account or crediting a customer wallet with test funds.
Process Spends
Simulate processing a card spend on the Visa network against a customer's available balance.
Reverse Transactions
Test your edge cases and ledger logic by reversing a previously committed transaction.
Query Balances
Fetch the current, real-time balance of any wallet at any point during the simulation flow.
Fetch History
Retrieve the paginated transaction history and ledger entries to verify double-entry accounting.
Example Simulation Flow
Here is how you can test a complete end-to-end payment lifecycle using the simulator:
Create Entities
Create a business entity and a customer account via the standard Vrtx API.
Fund the Wallet
Call topup to simulate an inbound transfer, instantly funding the customer's wallet.
Simulate a Spend
Call spend and the system will process the purchase, deduct the customer's balance, and automatically capture any configured fees.
Verify Balances
Confirm that the final balances across your customer and fee accounts perfectly match your expectations.