How can I simulate transactions in the Sandbox environment?

Finmo provides a sandbox environment that enables you to test and simulate transactions without moving real funds. This functionality is available through the Finmo Dashboard and via API, allowing you to test and validate payment flows such as wallet top-ups and payins in a safe, controlled environment.

Using the Finmo Dashboard

1. Enable Sandbox Mode

• Navigate to your dashboard.
• Ensure that the Sandbox toggle is turned on to enable simulation features.

2. Simulate a Wallet Top-Up (Virtual Account)

• Go to My Organization.
• Click on the wallet you want to top up.

• Select the Simulate option.
• Enter the desired amount and confirm the simulation.

3. Simulate a Transaction

• After creating a Payin, go to Receivables → Payins.
• Select the transaction you want to simulate.
• Make sure the transaction is in a PENDING state.

• Click Simulate to complete the test.

Using the Finmo API

You can also simulate transaction events using Finmo's sandbox APIs:

1. Create a Payin or Payout

• Use the Finmo API to initiate a Payin or Payout in sandbox mode.
• Refer to the API documentation: Create payout and Create Payin

2. Simulate the Transaction Outcome

Use the appropriate endpoint to simulate a transaction’s status update:

• Simulate Payin Completion/Cancellation
• Simulate Payout
  Note: The transaction must be in a PENDING state to simulate an update. Upon successful simulation, the status will be updated to COMPLETED, FAILED, or RETURNED based on the test case.