Simulation Data

Initiate Payout API and Get Transaction Status API

Decentro provides certain static values for platforms to simulate the various scenarios.

Please utilize the input parameters, shared in the table below, for initiating the Initiate Payout API. The initiate payout API will share a decentroTxnId in the response payload. The decentroTxnId must be passed
in the Get Transaction Status API to receive the expected output.

📘

Note - Simulation Data

To test Simulation Staging data for Initiate Transfer and Status Handling, please use the following API Endpoint - https://in.staging.decentro.tech/core_banking/money_transfer/initiate

https://in.staging.decentro.tech/core_banking/money_transfer/get_status/

Validate Bank Account (Penny Drop)

Decentro provides certain static values for platforms to simulate the various scenarios of validating a bank account.

Please utilize the input parameters, shared in the table below, for initiating the Validate Bank Account.

📘

Note - Simulation Data

To test Simulation Staging data for Validate Bank Account (Penny Drop), please use the following API Endpoint - https://in.staging.decentro.tech/core_banking/money_transfer/validate_account

Validate VPA - Simulation Data

Below is the test data that can be used by platforms to test out standard scenarios for Validate UPI Handle (VPA).

The platform is expected to pass the parameters as-is to get the intended scenario.

📘

Note - Simulation Data

To test Simulation Staging data for Validate VPA, please use the following API Endpoint - https://in.staging.decentro.tech/v2/payments/vpa/validate

Steps to use this data:

1. Take the UPI ID from the values shared below depending on the scenario to be tested.
2. Trigger the validate VPA API with that UPI ID with the required type.
3. API response will state the validation of the VPA (valid or invalid)
4. The information about the UPI ID depends on the the type param passed in the request payload.

Generate payment link & Get transaction status API - Simulation Data

Below is the test data that can be used by platforms to test out standard scenarios for Generate payment link.

The platform is expected to pass the parameters as-is to get the intended scenario.

📘

Note - Simulation Data

To test Simulation Staging data for Generate payment link API & Get transaction status API, please use the following API Endpoint - https://in.staging.decentro.tech/v2/payments/upi/link https://in.staging.decentro.tech/v2/payments/transaction/status

Steps to use this data:

1. Generate a payment link with amount parameter as either 10, 20, 30 depending on the test case being observed.
2. Obtain the generated link in the response.
3. Use decentro_txn_id from the response and pass in Get transaction status API to fetch the terminal status of the transaction.
4. Depending on the Amount passed in step 1, you'll receive the terminal status.
5. Please refer to the table below for Amount v/s transaction status test cases in staging simulation.
6. In the live flow, step 4 will take some time till the end user enters the UPI pin and makes the payment. Till then the status of the transaction by GTS will be PENDING.

Collection request - Simulation Data

Coming soon

Refund - Simulation Data

coming soon

ENACH

Overview

The ENACH(Electronic National Automated Clearing House) product allows for electronic mandate registration and processing of recurring payments. This document outlines the simulation data used for testing various scenarios in the ENACH system.

👍

Please use staging credentials to test our ENACH simulation.

Refer to this ENACH API Reference Page.

Live Simulation APIs

Simulation Data - Testing Scenarios

Mandate Registration API

This API lets you test the mandate registration API. You can use the amount given below to test the different scenarios.

📘

Note - Simulation Data (eNACH Mandate Registration)

To test simulation staging data for eNACH Mandate Registration API - <https://staging.api.decentro.tech/v3/payments/enach/mandate>

📘

OTP Validation

1. Enter any 6-digit random number to validate the OTP.
2. "111-111" use this 6-digit number to verify the wrong OTP scenario.

📘

Debit Card Validation

1. Enter a random 12-digit debit card number.
2. Enter a random 3-digit CVV.
3. Enter a random debit card expiry date.

📘

Aadhar Validation

1. Enter random 12 digit Aadhar card number.
2. Enter random 6 digit OTP

Authentication Mode - Debit Card

Authentication Mode - Net Banking/Aadhar

Mandate Execution API

📘

Note : Simulation Data (eNACH Presentation)

To test simulation staging data for eNACH Mandate Execution API - <https://staging.api.decentro.tech/v3/payments/enach/mandate/execute>

This API lets you test the mandate execution API. You can use the amount given below to test the different scenarios.

🚧

Ensure to use UMRN generated from Mandate Registration API.

👍

Execution callbacks will be sent within 20 mins of the execution API call.

AUTOPAY

Simulation Data

Decentro's simulation data helps developers simulate all the real-world scenarios when using the Create mandate API.
This requires the platform to use standard request payloads to handle scenarios for each API and scenario, as mentioned below.
The platform will need to whitelist their IP and configure callback endpoints with Decentro if they wish to handle the flow. Please reach out to us at [email protected] for the same.

How to test?

Below is the flow to test the Simulation data

1. Generate a mandate link by using Create Mandate API with the 'amount' parameter in the required range as mentioned in the test bed section.
   1. Note: To test the instant presentation within a 5-minute scenario when the amount rule is set to MAX, ensure that you pass the simulation amount value in the default_amount parameter.
2. Click the generated link once before proceeding. This is a mandatory step to receive the simulation responses.
3. Next Decentro will propagate the updated status of the mandate as per the amount (range) passed in step-1.
4. Alternatively, client can use Get Mandate Status to fetch the latest status of the mandate.
5. Next proceed to trigger the Pre Debit Notification API to test various scenario basis the amount range values mentioned in the respective test bed section.
6. Next, proceed to trigger the Mandate Presentation API to test various scenarios basis the amount range values as mentioned in the respective test bed section.
7. Note: The simulation environment is an exact replica of production environment including all the checks of production systems for registration, notification and, presentation .

Test Bed

Mandate Creation

📘

Note : Simulation Data (Autopay Mandate Registration)

To test simulation data for Autopay Mandate Registration - https://staging.api.decentro.tech/v3/payments/upi/autopay/mandate/link

Pre Debit Notification

📘

Note : Simulation Data (Autopay Pre-Debit Notification)

To test simulation data for Autopay Pre-Debit Notification - https://staging.api.decentro.tech/v3/payments/upi/autopay/mandate/notify

Presentation

📘

Note : Simulation Data (Autopay Presentation)

To test simulation data for Autopay Presentation - https://staging.api.decentro.tech/v3/payments/upi/autopay/mandate/presentation

Mandate Presentation Callback

Mandate Registration Callback