Skip to main content

Dummy Payment Provider for Simplified Integration (InStore App Developer Mode)

Important

This feature is available with InStore App v1.2.8-rc1 and later.

The InStore App supports a developer mode that exposes a hidden Dummy Payment Provider, allowing easy integration and testing of different payment success and error scenarios without requiring access to a real payment provider.

Developer mode is now activated automatically based on the type of CashBox the InStore App is paired with:

  • Sandbox CashBox — Developer mode is enabled automatically.
  • Production CashBox — Developer mode is disabled automatically.

There is no manual toggle, no logo tap, and no PIN entry required.

Configuring the Dummy Payment Provider

  1. Make sure the InStore App is paired with a sandbox CashBox.
  2. Open Settings and navigate to the Payment settings section.
  3. Tap Payment entry (the first item in Payment Settings) and select the Dummy Payment Provider, which is visible because developer mode is active.

Using the Dummy Payment Provider

When executing a payment action with the use_auto or test protocol, payments will be processed by the Dummy Payment Provider, which is visible via the payment progress screen that appears when starting a payment action.

Any payment amount will return a SUCCESS response, except for the following defined special amounts:

Payment requestResult
30000,10DECLINED
30000,20TIMEOUT (returned as an error message as no other option is available yet)
30000,40CANCELLED BY USER
30000,50SUCCESS with added guest tip (see HOWTO_01_Payment for instructions on handling tips)
30000,60SUCCESS after 1-minute delay
30000,70SUCCESS after 3-minute delay
30000,80SUCCESS after 6-minute delay
30000,90SUCCESS, but only 15000,50 will be approved

For more information, see the fiskaltrust POS System API - Development Kit.