Equipped with our services inventory and open API platform, we provide you the chance to reach, test and use ICICI Bank’s digital services. Using these, you now have the power of ICICI Bank supporting you to develop the next generation of applications. Let’s look how you can do it;
If you already have an account, then sign in and jump to step 2. Else follow the steps to create an account
Go to our sign-up page.
Complete the registration by entering your details and create an account.
When authorized, an email will be sent to your registered email-id with a link to activate your account by logging in.
You now have access to your dashboard. From here you can create and configure your apps.
This API will return all the accounts mapped to the user. If same account is mapped to multiple account then multiple entries of same account will be present in the result. This API will return all the accounts mapped to the user. If same account is mapped to multiple account then multiple entries of same account will be present in the result. This API will return all the accounts mapped to the user. If same account is mapped to multiple account then multiple entries of same account will be present in the result.
This API will return all the accounts mapped to the user. If same account is mapped to multiple account then multiple entries of same account will be present in the result.
Name | Description | Mandatory |
RequestFromString |
Indicates requester. |
YES |
RequestTypeString |
Type of Request |
YES |
CorpIDString |
Client ID |
YES |
UserIDString |
User ID under Client ID |
YES |
AggrNameString |
Name of the partner. |
YES |
AggrIDString |
ID of the partner. |
YES |
BankIDString |
Unique ID of the Bank. |
YES |
URNString |
This a unique value that partner will assign to each registration from his end for security and recon. |
YES |
AliasIDString |
If user created Alias id before registration then user need to pass this parameter in Reg API. |
NO |
Name | Description |
SuccessString |
Denotes if services all has successfully copleted. |
ResponseInt |
Response code of the API. Response code "0" indicates the success response. |
MessageString |
Response code description message. |
BankRRNInt |
The reference number of the transaction. |
UpiTranlogIDInt |
The Transaction ID generated by Switch. |
UserProfileString |
Profile Id of the user. |
MobileAppDataString |
Denotes the extra data or information to be shared with mobile APP. |
SeqNoString |
Seq-no input parameter will be echoed back. |
Error Code | Error Name | Error Logs |
8001 |
INVALID_JSON |
JSON Schema request empty. |
8002 |
INVALID_JSON |
JSON Schema request empty. |
8003 |
INVALID_FIELD FORMAT OR LENGTH |
JSON Schema request empty. |
8004 |
MISSING_REQUIRED_FIELD_Date |
JSON Schema request empty. |
8005 |
MISSING_REQUIRED_FIELD |
JSON Schema request empty. |
8006 |
INVALID_FIELD_LENGTH |
JSON Schema request empty. |
8007 |
Invalid JSON,OPEN CURLY BRACE MISSING. |
JSON Schema request empty. |
8008 |
Invalid JSON,END CURLY BRACE MISSING. |
JSON Schema request empty. |
8009 |
Internal Server Error |
White space characters. |
8010 |
Internal Service Failure |
Routing failure. |
8011 |
INVALID_FIELD |
Receive additional properties. |
{
"REQUESTFROM": "AGTR",
"REQUESTTYPE": "AGRSTXXXX",
"CORPID": "CIBNEXT",
"USERID": "CIBTESTXXXX",
"AGGRNAME": "MMSOFT",
"AGGRID": "AGGR00XX",
"BANKID": "IXX",
"URN": "2634AB",
"ALIASID": "CIBXXXX",
}
https://apigwuat.icicibank.com:8443
Copyright 2017 ICICI Bank Ltd. All rights reserved.
On the developer portal, click the Sign up button at right top corner. The portal is a self-service tool that will guide you through account creation. After creating an account and accepting the ICICI Bank API Portal and Services Agreement, you can start developing apps.
We are currently publishing this for new developers or existing partners with a new initiative. If you do not have an integration with ICICI Bank, use these APIs to get started.
You can sign up for a new Developer account and create an API key on your Developer Console. For more information, see our Documentation page. If you are an Enterprise Developer interested in adding or updating an application, please contact your Account Manager before creating an API key. If you are not able to access your Developer Console, contact your Account Manager.
API is the abbreviation for “Application Programming Interface”. An API allows a third party application to use a common set of services via a defined interface.
Simply create an account on the developer portal and then create one or more applications. Each application will get its own API key. Once your application is ready to go live you can request for an account plan upgrade via your Developer Console.
OAuth is an authentication protocol. For more information, please visit oauth.net.
REST (Representational State Transfer) is a simple stateless architecture i.e. each operation is entirely defined by the information sent to and received from the service. When a web service uses this architecture, it is known as a REST API.
The Organisation Administrator is your company’s representative for the ICICI Bank Developer Portal. This person has overall responsibility for the ICICI Bank Developer Portal account, and has access to all the services and functions available on the site. The Organisation Administrator’s main responsibilities include:
The Organisation Administrator is ICICI's first point of contact regarding the ICICI Bank Developer Portal.
Only users with the enterprise administrator role can add users. You can manage your users and permissions at User Managament page.
You will see details of various error responses within the API specifications. The Error description field in a response is meant to detail a message for the user. Refer to the error code information which details what the error code means and how this error code should be handled.
An Account Plan is a collection of one or more APIs. Every developer organization has an Account Plan. When a developer registers for a new organization account, the organization is automatically assigned to ‘Bronze Account Plan’. Using ‘Bronze Account Plan’ you can only consume ‘Test’ APIs. In order to consume ‘Production’ APIs, you have to upgrade your account plan to ‘Production Account Plan’.
An API Plan is a predefined set of rules and quotes of how to consume an API. Currently, we provide ‘Sandbox’ and ‘Production’ API plans. ’Test’ APIs are only available via ‘Sandbox API Plan’ and they are restricted to some quotes which means you will have limited access. On the other hand ‘Production’ APIs available via ‘Production API Plan’ can be consumed with higher quotes and they process live data. As mentioned under the title ‘What is an API Plan?’ you have to upgrade your account plan to ‘Production Account Plan’ in order to consume ‘Production’ APIs.
Yes, sandbox APIs are currently restricted to a limited number of calls, according to API Plan’s context.
Developers have to be invited by their Organisation Administrator to join the portal. Once joined, they can access most of the same functions as the Organisation Administrator. There are a few things developers won’t be able to do, and this includes inviting other developers to join, changing API or Account plans, or editing organisational details.
Your organisation has a choice of two Account Plans:
If you’re an Organisation Administrator, you can change your Account Plan by going to Dashboard/Applications. Simply select your preferred plan under ‘Account Plan Change’ in the first table. We’ll automatically be notified of your request and be in touch with any further requirements we may need from you.
If you’re an Organisation Administrator, you can request to move from Sandbox to Production for each API within a specific application using this portal:
We’ll then be in touch with any further requirements we may need from you.
No, so please make sure you’re certain you don’t want the application before deleting it.
Yes. Go to Dashboard/Applications, click on the cog to the right of the application, then ‘Disable’.
No. But your Application may be suspended or deleted which will suspend or delete the associated API key.
Quota usage across all applications
Application | API Key | Status | Platform | |
GTU Reuslt App |
l7xx1234f60026a64e82b12a0608178ccee3 |
Active |
iOS
|
|
Phone pe |
l7xx1234f60026a64e82b12a0608178c |
Active |
iOS |
|
Ease Tap |
l7xx1234f60026a64e82b12a0608178ccee3 |
Active |
android
Android |
|
Google Analytics |
l7xx1234f60026a64e82b12a0608178c |
Active |
Android |
|
Adsense |
l7xx1234f60026a64e82b12a |
Active |
iOS |
|
GTU Reuslt App |
l7xx1234f60026a64e82b12a0608178ccee3 |
Active |
Web |
|
Truecaller Money |
l7xx1234f60026a64e82b12a0608178cc |
Active |
Web |
I.P. Address | Status | |
143.172.168.101 |
Active |
|
192.168.117.107 |
Inactive |
|
192.168.117.107 |
Active |
|
143.172.168.101 |
Inactive |
|
192.168.117.107 |
Active |
|
192.168.117.107 |
Active |