Sandbox: Tap to Pay Integration

When testing Tap to Pay in the sandbox environment, follow the steps outlined below to perform your simulations.

Terminal Registration

You do not need a physical device to perform sandbox testing. To simulate terminal registration:

  1. Send a registration request with any arbitrary value for the appDeviceId in the request body.
  2. Upon receiving a successful response, contact the Ezypay team to activate the device on the backend.
  3. Once activated, a terminal_registration webhook will be triggered and returned to your system, confirming the successful registration of the test device.

Terminal Invoice Simulation

In the sandbox environment, terminal invoices will return a PAID status for any entered amount, except for the specific values listed below. These amounts are preconfigured to simulate common payment failures, allowing you to test your error handling logic.

AmountSimulated Failure Reason
1951: Insufficient funds / Over credit limit / Not sufficient funds
2954: Expired card
49905_1: Could not find an acquirer account for the provided txvariant (amex), currency (AUD), and action (AUTH)