post https://mf-api.smallcase.com/gateway/mf/verifyOtp
API to generate an OTP from MFCentral for a particular transactionId, phone and PAN combination
Learn how to generate an OTP for the Mutual Fund Holdings Import -
https://developers.gateway.smallcase.com/reference/get-otp-mf-holdings
On hitting the API for a 200 response, the holdings and orderbook will be fetched and shared with you on the registered webhook url.
Error Maps
| Description | statusCode | error message | errorType |
|---|---|---|---|
| Internal Error on the smallcase gateway server | 500 | Internal Error | InternalError |
| transactionId passed is either non-existent or invalid | 400 | TransactionIdNotFound | InputException |
transactionId passed is not of the intent MF_HOLDINGS_IMPORT | 400 | InvalidIntent | InputException |
| when the OTP is triggered on one method (e.g., email or phone), but the verification payload contains the OTP from a different method. | 400 | OTPMethodMismatch | InputException |
| transactionId passed is expired | 400 | TransactionIdExpired | AccessDenied |
| maximum number of wrong attempts exceeded with this particular transactionId (max. 5 attemps allowed per transaction) | 400 | wrong_attempts_exceeded | AccessDenied |
| Invalid request sent to MFCentral | 422 | Invalid Input or Request Format | MFCException |
| Ratelimit exceeded on MFCentral for the Client | 429 | Too many requests to the API (rate limiting) | MFCException |
| validation error on MFCentral | 400 | Validation error or Invalid request parameters or values | MFCException |
| Invalid access token or client Id | 401 | Invalid token or client Id | MFCException |
| Incorrect otp entered | 406 | Incorrect OTP | AccessDenied |