Skip to main content

Testing

Your Tamaro Widget has two different modes - test mode and production mode. In test mode you can make payments with testing payment methods, which means that no real money flows. You can find testing payment methods here. This way, you can reproduce your donor's complete journey, without carrying out real payments.

If your widget is in production mode, a real payment is made upon submitting the form and the chosen payment method is charged with money that will be transferred to your organisation's bank account.

When you receive your <widget-id> during the onboarding process, it is always in test mode. Once you have integrated it into your website and have tested it, we will set it to production mode for you.

At any moment, you can clearly identify if the widget is in production or test mode.

If you see a blinking orange bar the widget is in test mode and you do not have to worry about submitting real payments.

Test Mode

If your widget is already in operation on your website and you still need to test, there are several options.

Set test mode via console​

You can set your widget into test mode anytime for you locally via the console. This way, test payments are possible. Go to the page where you have integrated your widget, open the console (right click on the website and go to 'inspect') and enter the following code:

window.rnw.tamaro.instance.config.testMode = true;

Your widget is now in test mode.

Please note that you do not have to refresh the page, because then you will have to set the test mode again.

Set test mode via URL​

There is a simple trick to set your Tamaro locally to test mode via the URL. Just add #widgetdebug to the URL where your Tamaro is integrated.

Example:

https://tamaro.raisenow.com/raisenow-docs/latest/index.html#widgetdebug

Reload the page. Then, at the bottom of the widget the debug console appears. Here you have several setting options, including setting the test mode. Go to menu item "EPP/EPMS configs" and check the box for "Test mode". The widget is instantly in test mode and you can make a test payment.

Widget Debug

Set test mode via code​

You can also set the test mode via code. This makes sense if your organisation has a permanent test page, where your widget should be in test mode permanently.

Set the following code:

window.rnw.tamaro.runWidget('.rnw-tamaro-widget', {
  testMode: true,
});

Generated test data​

When using the Tamaro widget to create test payments or test subscriptions, the generated records in RaiseNow will feature a "test_mode": true on the RaiseNow API.