API ReferenceIntegrationsKnowledge Base

Test Mode

RazorpayX test mode is a replica of RazorpayX in a sandbox environment that allows you to test your integration before you switch to Live Mode. You can test the following using the Test Mode:

Feature

API

Dashboard

Bulk Upload

Contacts

Fund accounts

Payouts

Webhooks

Handy Tips

  • Actions taken in the test mode have no consequences in your live environment.
  • Contacts, Fund accounts and Payouts created in the Test Mode do not appear in the live environment.
  • You can create Contacts and Fund accounts using real-world or dummy data.
  • Test Mode has its own dummy balance. No real money is used in the Test Mode. For example, a Contact created in the test mode does not carry over to the live mode and vice versa. Payouts made to a Fund account in the Test Mode uses funds from the test account balance, which is not real money.

Add Funds🔗

Just like in the live environment, you will need to add funds in the test mode before you can make payouts. Test mode uses its own dummy balance. No real money is used in the test mode.

To add funds to your test mode, click + Add test balance and follow the on-screen instructions.

Handy Tips
The account details in the test mode are dummy details. Do not load real money to this account.

Watch this video to see how to add finds in the test mode.

Contacts🔗

To make a payout, you need to create a Contact. The table below lists the various Contact actions you can perform in the test mode:

Action

API

Dashboard

Bulk Upload

Create a contact

Update a contact

x

View contact details

x

Mark as inactive

x

You can create Contacts using APIs and create Contacts in bulk.

Fund Accounts🔗

After you create a Contact, you need to create a Fund account for the Contact. You can create Fund accounts in the test mode only using Contacts created in the test mode. Payouts are made to the Fund account linked to the Contact.

The table below lists the various Fund account actions you can perform in the test mode.

Action

API

Dashboard

Bulk Upload

Create a fund account

View fund account details

Mark as inactive

x

You can create Fund accounts using APIs and create fund accounts in bulk.

Payouts🔗

Life Cycle🔗

Below is the payout life cycle.

Know more about payout states and its life cycle.

Watch Out!
The Approval Workflow is not available in the test mode. This means the pending and rejected states are not available in the test mode.

Actions🔗

The table below lists the various payout actions you can perform in the test mode.

Action

API

Dashboard

Bulk Upload

Create a payout

View payout details

x

You can create contacts using APIs and create contacts in bulk.

Move a Payout to Next State🔗

By default, Payouts created in the Test Mode acquire the processing state. However, if you do not have sufficient balance, the payout acquires the queued state. In this case, add funds to move the payout to the processing state.

From the processing state, you will have to manually move the payout to the next state from the Dashboard. You can move it forward to any state in the payout lifecycle. Unlike the Live Mode, this does not happen automatically.

Watch this video to view the payout states.

Account Statements🔗

The Test Mode has its own account statement based on transactions made in the Test Mode. You can view the account statement on the RazorpayX Dashboard or fetch details using the Transaction APIs.

Webhooks🔗

Know about webhooks, how to set them and the sample payloads.

The following webhook events are available in the test mode:

  • payout.queued
  • payout.initiated
  • payout.processed
  • payout.reversed
  • transaction.created
×