JavaScript is disabled. Some features may not work. You can also read the static version: View text version

Netbanking Payment

Create a payment transaction for NetBanking. Once you have the response, depending on the “method” attribute, you will have to take the next step. If you receive GET, then take the value in the “URL” attribute and redirect the user to this location. If you receive POST, then “params” attribute will hold a map containing key-value pairs.

For Web, you can create a form with these parameters as hidden variables and auto submit the form. Example code in Javascript: Serialize Parameters.

For Android, serialize this data such that it can be loaded to WebView directly via postData. Example code in Java: Serialize Parameters.

Scroll inside to view more

payment_method	Bank
NB_AXIS	Axis Bank
NB_BOI	Bank of India
NB_BOM	Bank of Maharashtra
NB_CBI	Central Bank Of India
NB_CORP	Corporation Bank
NB_DCB	Development Credit Bank
NB_FED	Federal Bank
NB_HDFC	HDFC Bank
NB_ICICI	ICICI Netbanking
NB_IDBI	Industrial Development Bank of India
NB_INDB	Indian Bank
NB_INDUS	IndusInd Bank
NB_IOB	Indian Overseas Bank
NB_JNK	Jammu and Kashmir Bank
NB_KARN	Karnataka Bank
NB_KVB	Karur Vysya
NB_SBBJ	State Bank of Bikaner and Jaipur
NB_SBH	State Bank of Hyderabad
NB_SBI	State Bank of India
NB_SBM	State Bank of Mysore
NB_SBT	State Bank of Travancore
NB_SOIB	South Indian Bank
NB_UBI	Union Bank of India
NB_UNIB	United Bank Of India
NB_VJYB	Vijaya Bank
NB_YESB	Yes Bank
NB_CUB	CityUnion
NB_CANR	Canara Bank
NB_SBP	State Bank of Patiala
NB_CITI	Citi Bank NetBanking
NB_DEUT	Deutsche Bank
NB_KOTAK	Kotak Bank
NB_DLS	Dhanalaxmi Bank
NB_ING	ING Vysya Bank
NB_ANDHRA	Andhra Bank
NB_PNBCORP	Punjab National Bank CORPORATE
NB_PNB	Punjab National Bank
NB_BOB	Bank of Baroda
NB_CSB	Catholic Syrian Bank
NB_OBC	Oriental Bank Of Commerce
NB_SCB	Standard Chartered Bank
NB_TMB	Tamilnad Mercantile Bank
NB_SARASB	Saraswat Bank
NB_SYNB	Syndicate Bank
NB_UCOB	UCO Bank
NB_BOBCORP	Bank of Baroda Corporate
NB_ALLB	Allahabad Bank
NB_BBKM	Bank of Bahrain and Kuwait
NB_JSB	Janata Sahakari Bank
NB_LVBCORP	Lakshmi Vilas Bank Corporate
NB_LVB	Lakshmi Vilas Bank Retail
NB_NKGSB	North Kanara GSB
NB_PMCB	Punjab and Maharashtra Coop Bank
NB_PNJSB	Punjab and Sind Bank
NB_RATN	Ratnakar Bank
NB_RBS	Royal Bank of Scotland
NB_SVCB	Shamrao Vithal Coop Bank
NB_TNSC	Tamil Nadu State Apex Coop Bank
NB_DENA	DENA Bank
NB_COSMOS	COSMOS Bank
NB_DBS	DBS Bank Ltd
NB_DCBB	DCB BANK Business
NB_SVC	SVC Cooperative Bank
NB_BHARAT	Bharat Bank
NB_KVBCORP	Karur Vysya Corporate Banking
NB_UBICORP	Union Bank Corporate Banking
NB_IDFC	IDFC Bank
NB_NAIB	The Nainital Bank
NB_AIRTEL	Airtel Payments Bank
NB_AUB	AU Small Finance Bank

Handling POST
When you get POST as the authentication method in the response, then the customer must be redirected using a form. Example HTML code is given to you. Depending on your client language, choose the appropriate way to create the form.

Handling GET
When you get GET as the authentication method in the response, you may load the URL directly into the customer’s browser. You can easily achieve this by sending HTTP 302 from your server. However, if the API call was made from the browser, then you can utilize the code snippet provided.

Request

Response

API Endpoints

Sandbox Link

POST

https://sandbox.juspay.in/txns

Production Link

POST

https://api.juspay.in/txns

                      Content-Type
                      *
                      

String

Mandatory

application/x-www-form-urlencoded

                      x-routing-id
                      *
                      

String

Required

We recommend passing the customer_id as the x-routing-id. If the customer is checking out as a guest, you can pass an alternative ID that helps track the payment session lifecycle. For example, this could be an Order ID or Cart ID.

This ID is associated with the customer. It plays a key role in ensuring consistency and maintaining connections across different systems. If you fail to pass the same x-routing-id for the same customer in all related API calls, it could lead to issues with API functionality. Therefore, it’s crucial that you use the same x-routing-id for all requests tied to the same customer.

Example:- customer_1122

Body

                      order_id
                      *
                      

string

Mandatory

order_id pertaining to the order for which the payment is started.

                      merchant_id
                      *
                      

string

Mandatory

ID of the merchant_account that you hold with us.

                      payment_method_type
                      *
                      

string

Mandatory

Must be NB.

                      payment_method
                      *
                      

string

Mandatory

The actual payment method that was selected by the user. For NetBanking transactions, it must be one of from the table above..

                      redirect_after_payment
                      *
                      

string

Mandatory

This is a boolean variable and accepts true/false. We recommend that you set this to true and use the redirection flow. If set to true, then the user is redirected to the return_url configured for the order. If set to false, then the user will be stopped at the response page from the gateway. Your client should be able to read the page/title to infer that the user has completed the transaction.

                      format
                      *
                      

string

Mandatory

f it is set to json, then the response will be HTTP 200 with a JSON formatted text. Otherwise, the response is HTTP 302 with the Location attribute having the destination URL.

                      offers
                      
                      

array of Strings

The key offers should be passed only when juspay offers are being used. The value for this key can set as the offerID which is received from /v1/offers/list api

Response Body

                      order_id
                      
                      

string

:order_id

                      txn_id
                      
                      

string

:txn_id

                      status
                      
                      

string

PENDING_VBV

                      payment
                      
                      

object

                      authentication.method
                      
                      

String

                      authentication.url
                      
                      

string

                      authentication.params
                      
                      

object

Only when you have POST as the authentication method

                      key1
                      
                      

String

                      key2
                      
                      

String

                      key3
                      
                      

String

Response Body

                      status
                      
                      

string

error

                      error_message
                      
                      

string

Order timed out

                      error_code
                      
                      

string

invalid_request