Skip to main content

sandbox FPS payment simulator

to facilitate rapid integration testing without utilizing real currency, divit provides a fully-functional, web-based FPS payment simulator at bank.divit.dev.

this tool mimics a standard Hong Kong consumer retail banking app's payment confirmation, transaction authorization, and settlement notification flows.

simulated payment journey​

when testing your payment order integration in sandbox mode, follow these steps to simulate successful or failed payment settlements:

step 1: open the simulator​

  1. navigate to bank.divit.dev on your computer or mobile device.
  2. ensure that "sandbox" is selected under the application's configuration options.

step 2: scan or input payment details​

  • scanning (recommended for mobile): open the simulator on a mobile phone, tap "scan to pay", and scan the FPS QR code presented on your divit sandbox checkout screen.
  • manual entry: enter your order's merchantRef directly into the simulator's input field to retrieve the transaction context.

step 3: configure transaction outcomes​

on the simulator's transaction review screen, you can simulate different business cases:

  • success scenario: keep the default settings and tap "confirm payment". this triggers real-time settlement simulation and dispatches the success webhook (2001).
  • failure scenario: open the "advanced options" section, toggle the "is failure payment" switch, and confirm. this simulates a payment authorization failure, dispatching the appropriate webhook callback.

simulator visual walkthrough​

the interface is modeled after industry-standard bank authorization screens: