Sandbox environment

Before going live, all new payment services run in sandbox environment. In sandbox environment no live billing is performed. Once you have finished testing, click the "Go live" button in service information tab to start processing real transactions.

Once live, payment service cannot be reverted back to sandbox mode. Due to this some merchants prefer to create one special sandbox testing payment service that can be used in QA process.

While in sandbox environment no real charging takes place, you will still need to have a working SIM card inserted into the phone. If any SIM card is inserted, SDK first tries to present you the payment flow of the carrier related to the SIM. If that carrier has not been added to the service, SDK checks if country Estonia has been added to the service and falls back to Estonian payment flow. If Estonia has not been added to the service, SDK attempts to fall back to any other country that has been added to the service.

When starting the testing process, you will first need to visit Fortumo dashboard and on service page select the scenario that you are about to test. There are four different scenarios available:

  • Billed - after a test payment, callback URL is immediately sent two payment notifications - first with status pending, second with status ok
  • Failed - after a test payment, callback URL is immediately sent two payment notifications - first with status pending, second with status failed
  • Pending - after a test payment, callback URL is sent one payment notification with status pending
  • Pending to Billed - after a test payment, callback URL is immediately sent a payment notification with status pending, followed by a second notification with status ok after a 30 second delay
  • Pending to Failed - after a test payment, callback URL is immediately sent a payment notification with status pending, followed by a second notification with status failed after a 30 second delay

All payment notification requests for transactions made in sandbox will include a test parameter. That will help you differentiate payments for which you will be earning revenue from ones where no real charging has occurred. Other parameters in the payment notification request are exactly the same as for production services.

Help us improve our Merchants Portal. Was this article helpful?