Transaction Errors

A transaction is initialised when a transactionId is passed to the triggerTransaction method on the client side SDK. Transaction is complete when the user logs in with the broker account & confirms the intent.

However, if intent is not completed, SDK shares error message & code to identify the cause of failure.

Here is a list of error messages that you can handle on your application and show relevant communication to the users:

Initialisation Errors

Following errors appear while the client side SDK is being initialised on your application –

Error message

Error code

Description

invalid_transactionId

n/a

transactionId passed to the sdk is incorrect

transaction_in_process

n/a

another transaction is in process, must wait for it to complete

invalid_gateway

n/a

gateway_name passed in the sdk initialization is invalid or not registered

invalid_jwt

n/a

JWT parameter for SDK initialization is invalid. Make sure the payload is as suggested & JWT is signed with valid shared secret

invalid_elementorselector

n/a

could not find HTMLElement to insert Iframe

invalid_user_data

n/a

smallcaseAuthToken is not provided or is invalid

Once the SDK is setup, next step is to initiate a transaction using triggerTransaction method provided by the SDK. Below is a list of errors that you can expect as the failure response from triggerTransaction method -

Generic errors

Following errors are applicable to all intents

Error message

Error code

Description

user_mismatch

1001

For a connected user's session on Gateway, user is expected to login with the mapped broker account only.
If the user would login with another broker account, this error is returned

transaction_expired

1005

Transaction session expired.
TransactionId is a short lived token & for one time use only. Either the user could not place the order within the session duration of 5min, or he tried refreshing the order window

User has restart the transaction again from partner platform

no_broker

1006

User could not find his broker in the list of brokers shown

no_broker

1007

User could not find his broker in the available list & opted to signup for a new broking account

no_broker

1008

User selected a broker that did not support the transaction intent

user_cancelled

1010

user has closed the broker chooser popup

user_cancelled

1011

user has closed the order journey after selecting the broker, but before successful login

user_cancelled

1012

When the user completes broker login to view the order popup and abandons the order journey, this error is returned

api_error

2000

Something went wrong with our APIs/SDK. We do take note of these errors cautiously and look in to them on priority

transaction_expired

3001

TransactionId passed in the triggerTransaction method is used or expired

Single stock or basket order errors

These errors are applicable only when a user is placing single (or multiple) stock orders.

Error message

Error code

Description

market_closed

4004

broker is not accepting orders

smallcase order errors

These errors are applicable only when a user is placing smallcase orders with the broker.

Error message

Error code

Description

no_order

1020

smallcase is already up to date as suggested by the rebalance. rebalance was ignored

smallcase_archived

1013

smallcase has been deleted post archival

already_subscribed

4000

user has already subscribed to the smallcase

market_closed

4005

the transaction could not processed as amo orders because either of these:

  1. broker does not support AMO orders
  2. particular smallcase order type cannot be executed in after-market hours (ex - rebalance)

order_pending

4006

last order for the smallcase by the user is still in pending status

invalid_scid

a smallcase could not be found with given information

invalid_iscid

cannot find the invested smallcase

Holdings import error

While importing broker holdings via Gateway, a user consent is required before holdings can be imported by the partner. In case user denies to give consent, consent_denied error is thrown.

Error message

Error code

Description

consent_denied

1003

user denies consent for holdings import. This step comes once in user lifetime for all broker

webhook_unreachable

3003

webhook could not be reached when trying to send holdings data

Show orders error

These errors are applicable only when a user is viewing the order list page.

Error message

Error code

Description

intent_not_enabled_for_broker

3000

If the user's connected broker is not available to show the order list page.


Did this page help you?