SBI National Hackathon-Code for Bank

SBI APIs

Customer Enquiry

1. Customer Account List Enquiry

The purpose of this API is to get the list of accounts and details for a given customer.

• API prime input is customer’s account number.
• On successful enquiry API returns account list details.
• On failure appropriate error code and description is returned

Input: A/c Number
Sample Data: A/c no. 30001834840
Output: Associated account no and its details pertains to the primary CIF of the input account no

2. Customer Enquiry

The purpose of this transaction API is to get customer details for a given account number.

• API prime input is customer’s account number.
• On successful enquiry API returns customer’s details including but not limited to CIF, name and address.
• On failure appropriate error code and description is returned"

Input: A/c Number
Sample Data: A/c no. 85001748678
Output: CIF Related customer information like address, name ,ID etc

Account

1. Customer Account Enquiry

The purpose of this API is to provide customer account details against the customer Account number.

• API prime input is the customer Account number

Input: Account Number
Sample Data: A/c no. 30001822846
Output: Account related details like balance, mode of operation etc

2. Mini-Account Statement with Journal

The purpose of this API is to get the account statement for a given customer’s account.

• API prime input is customer’s account number.
• On successful enquiry API returns current balance and transaction details.
• On failure appropriate error code and description is returned.

Input: AccountNumber
Output: Account statement of last 10 transactions with journal number

3. Account Statement

The purpose of this API is to provide Account Statement Details of primary and their linked Accounts.

• API prime input is Account Number
• On successful enquiry API returns account statement with details narration, transaction amount balance etc.
• On failure appropriate error code and description is returned.

Input: AccountNumber, FromAmount, FromDate, ToAmount, ToDate, TransactionNumber
Output: Account statement with details narration, transmaction amount balance etc.

Micro Services

1. Branch details from IFSC Code

The purpose of this API is to provide IFSC Code along with Branch Details.

• API prime input is IFSC Code string.
• On successful enquiry API returns BankName, Branch Address, Bracnch Name related to the IFSC Code.
• On failure appropriate error code and description is returned.

Input: IFSCCode
Sample Data: ProductCode: , IFSCCode: HDFC0000001
Output: BankName, BranchAddress, BranchName related to the IFSCCode

Fund Transfer

1. NEFT Fund Transfer

The purpose of this transaction API is to perform a NEFT transaction by debiting remitter’s account and crediting beneficiary’s account.

• API prime inputs are remitter’s account number, beneficiary’s account number, transaction amount and IFSC code.
• On successful transaction API returns Journal number created at B@NCS24
• On failure appropriate error code and description is returned

Input: NEFT originater and remitter details along with amount etc
Output: NEFT UTR no and status of the NEFT message

2. RTGS Fund Transfer

Real-time gross settlement systems (RTGS) are specialist funds transfer systems where transfer of money or securities takes place from one bank to another on a real time basis .The purpose of this transaction API is to perform a RTGS transaction by debiting remitter’s account and crediting beneficiary’s account.

• API prime inputs are remitter’s account number, beneficiary’s account number, amount and IFSC code.
• On successful transaction API returns Journal number created at B@NCS24
• On failure appropriate error code and description is returned

Input: RTGS originater and remitter details along with amount etc
Output: RTGS UTR no and status of the NEFT message

3. Customer to Customer Fund Transfer

The purpose of this transaction API is to debit requisite amount from one Customer account and credit to another Customer account.

• API prime inputs are debit account, credit account and transaction amount.
• On successful transaction API returns Journal number created at B@NCS24
• On failure appropriate error code and description is returned

Input: SBI to SBI trasnction account no, amount, narration etc
Sample Data: BranchCode : 00437, DebitAccount : 30001822846 , CreditAccount : 30001499606, TransactionAmount : 11111, Narration : test, ReconReferenceNumber :
Output: Transation status, journal no etc

Loan Account

1. TDS Enquiry

The purpose of this API is to provide Tax Deducted at Source Details with the Account Number of Customer for particular Financial Year.

• API prime input is Account Number and Financial Year
• On successful transaction API provide Tax Deducted at Source Details with the Account NUmber of Customers for particular financial year
• On failure appropriate error code and description is returned

Input: AccountNumber, FinancialYear
Sample Data: FinancialYear : 202122 , AccountNumber : 30001846108
Output: CIF, CustomerName, TaxYear, TDSExemption, Submit15H15G, ConcessionRateCertificate, TotalTaxProjected, TotalTaxPaid, ConcessionRate, ConcessionSurcharge, TDS_AC_DATA (AccountNumber, BranchCode, IncomeTaxProjected, IncomeTaxPaid, SurchargeProjected, SurchargePaid, CessProjected, CessPaid, InterestProjected, InterestPaid)

2. Education Loan Details Enquiry

The purpose of this API is to get education loan details for a given customer.

• API prime input is customer’s account number.
• On successful enquiry API returns educational loan details including but not limited to course, institution name and discipline.
• On failure appropriate error code and description is returned

Input: AccountNumber
Sample Data: Accountnumber : 3000182020
Output: AccountNumber, AnnualIncome, CourseTerm, CourseType, Discipline, InstitutionName, SubInterestRate, SubRequired, UniversityName

3. EnqLoan

The purpose of this product is to get Loan Details based on account number. This API is used for loan enquiry.

• API prime input is the customer Loan Account number.
• On successful enquiry API returns loan details based on Account Number.
• On failure appropriate error code and description is returned

Input: AccountNumber
Sample Data: AccountNumber: 30001791735
Output: AccountNo, Purpose, LoanAmount, TenureInMonths, RateofInterest, DateOfSanction, RepaymentStartDate, Outstanding, DateOfDisbursement, IrregularAmount, DateOfIrregualarity, IRACStatus, InstallmentDueDate, EMIAmount, Status, AccountName, CustomerName, GLClassificationCode, AppliedAmount, AdvanceAmount, AddLoan, AccountTypeCharge, Insu, RepaymentRate, RepaymentDate, LastMaintenanceDate, ApprovalDate, LastFinDate, RepayOption, LastAdvanceDate, InterestPrepayAmount, Theo, OldIRACStatus, StatementFrequency, StatementCycle, CurrentYearTaxDeduction, PreviousYearTaxDeduction, AdvanceValue, SecurityAmount

4. EnqLoan Details

This API is used to get additional loan details including principal and charges.

• API prime input is the customer Loan Account number
• On successful enquiry API returns additional loan details including principal and charges.
• On failure appropriate error code and description is returned

Input: AccountNumber
Sample Data: AccountNumber: 30001791735
Output: ReferenceNumber, HomeBranchNo, CIFNumber, CustomerName, Address1, Address2, Address3, Address4, ApprovedAmount, AdvanceAmount, InterestRate, RateType, Currency, AccountType, IntCategory, MaturityDate, RepayFrequency, InstallmentAmount, NextInstallmentDate, LoanBalance, Principal, Interest, Charges, Arrears, NegotiableIndicator

Authentication

1. PAN Enquiry

The purpose of this API is to provide Customer Details linked with their PAN Number.

• API prime input is PAN Number
• On successful enquiry API returns customer details associated with PAN Number.
• On failure appropriate error code and description is returned

Input: PANnumber
Sample Data: PANnumber : ENPPS3947l, ReferenceNumber :
Output: FirstName, MiddleName, LastName

Locker

1. Branch wise locker Dues enquiry

The purpose of this API is to provide details of branch- wise locker dues against given branch numbers and SC locker numbers.

• API prime input is Branch number
• On successful enquiry API returns details of branch-wise locker dues against given branch number and SC locker number
• On failure appropriate error code and description is returned"

Input: SC_LOCKER_NO, BRANCH_NUMBER
Sample Data: BRANCH_NUMBER : 437
Output: ACCOUNT_NUMBER, TOTAL_MAINTANANCE_DUE, CHARGE_DUE

2. Customer Locker Enquiry

The purpose of this API is to provide locker details against the customer number

• API prime input is Customer number
• On successful enquiry API returns locker details against the customer number
• On failure appropriate error code and description is returned"

Input: CUSTOMER_NO
Sample Data: CUSTOMER_NO : 80144598612
Output: LOCKER_ACCOUNT_NO, LOCKER_TYPE, CABINET_ID, LOCKER_ID, BRANCH_NO, TOTAL_ARREARS, TOTAL_VISITS

3. Locker Availability Enquiry

The purpose of this API is to provide customer enquiry against locker availability

• API prime input is CABINET_ID, CATEGORY_CODE, LOCKER_STATUS
• On successful enquiry API returns customer enquiry against locker availability
• On failure appropriate error code and description is returned

Input: CABINET_ID, CATEGORY_CODE, LOCKER_STATUS
Sample Data: CABNET_ID : ICICIBANDRA, CATEGORY_CODE : 06, LOCKER_STATUS : 01
Output: LOCKER_ID, LAST CLOSRE DATE, CABINET_ID

Cheque

1. Cheque issuance

The purpose of this API is to issue cheque against account number

• API prime input is Account Number
• On successful enquiry API returns journal number against the issued cheque
• On failure appropriate error code and description is returned

Input: ACCOUNT_NUMBER, CHEQUE_INSTRUMENT_TYPE, SUB_CATEGORY, CHEQUE_PER_BOOK, PICK_UP_BRANCH, NO_OF_BOOKS, SAN_TYPE, CHEQUE_BOOK_AMOUNT, IS_P_SEGMENT_ACCOUNT
Sample Data: ACCOUNT_NUMBER : 00000030001737857, CHEQUE_INSTRUMENT_TYPE : 31 , SUB_CATAGORY : 02, CHEQUE_PER_BOOK : 0100, PICK_UP_BRANCH : 00000, NO_OF_BOOKS : 01, SAN TYPE : 0, CHEQUE_BOOK_AMOUNT : 12000000002000000, IS_P_SEGMENT_ACCOUNT : < >
Output: JOURNAL_NUMBER, RESPONSE_STATUS

2. Stop Cheque

The purpose of this API is to stop cheque against given account number

• API prime input is Account Number and Other Check Details
• On successful enquiry API returns request status and journal number
• On failure appropriate error code and description is returned

Input: ACCOUNT_NUMBER, FROM_CHEQUE_NO, TO_CHEQUE_NO, STOP_ISSUE_DATE, INTRUMENT_TYPE, REASON_CODE, STOP_COMMENTS, CHEQUE_TYPE
Sample Data: ACCOUNT_NUMBER : 0000000030001822846, FROM_CHEQUE_NO : 00214581, TO_CHEQUE_NO : 00000000, STOP_ISSUE_DATE : 29102021, REASON_CODE : 02, STOP_COMMENTS : ganesh, CHEQUE_TYPE : <>, INSTRUMENT_TYPE : 031
Output: Request status, journal no etc.