search

Net Banking Integration

This document explains how you can integrate net banking in the custom checkout solution to collect payment from your customer. Users can select netbanking as their payment source on the checkout page to complete the payment.

Demo

Integration steps

 

This section explains the integration steps to process payment through net banking. Make sure you have followed the Pre-requisites and Integration Steps mentioned on the Paytm Custom checkout page.

  1. Your backend server calls the Fetch Payment Options API using the transaction token received in the response of Initiate transaction API request. As part of the API response, you receive top 5 netbanking banks configured on your MID and having maximum number of transactions in the response.

    Note: In case you have already called this API as part of any other payment mode, then please ignore this step.

  2. In case a user wants to pay through a bank other than the top 5 banks received above, you call the Fetch NB Payment channel API.
  3. You receive the list of all the banks which are configured on your MID with their success rate and icons.
  4. Once the user selects a bank and clicks Pay to proceed for checkout, you call the Process Transaction API.

    Note: You can hit the Process transaction API either through Form post or JSON based.

  1. Paytm processes the request and returns the redirection URL to you using which you redirect the user to the bank page. It displays a bank form to the user where they enter their net banking credentials to complete the payment. Please refer to the sample Process Transaction request/response below:
    <form method="post" type="redirect" action="https://securegw-stage.paytm.in/theia/api/v1/processTransaction?mid=INTEGR7769XXXXXX9383&orderId=ORDERID_98765">
        <input type="text" name="mid" value="INTEGR7769XXXXXX9383" />
        <input type="text" name="orderId" value="ORDERID_98765" />
        <input type="text" name="txnToken" value="f0bed899539742309eebd8XXXX7edcf61588842333227" />
        <input type="text" name="paymentMode" value="NET_BANKING" />
        <input type="text" name="channelCode" value="SBI" />
        <input type="text" name="AUTH_MODE" value="otp" />
        <input type="submit" />
    </form>

     

  2. Once the user completes the payment on the bank page, they are redirected back to your payment confirmation page by Paytm after validating the transaction.
  3. You receive the transaction status on the Callback URL. Please refer response below:
    <form method="post" type="redirect" action="https://securegw-stage.paytm.in/theia/api/v1/processTransaction?mid=INTEGR7769XXXXXX9383&orderId=ORDERID_98765">
            <input type="text" name="mid" value="INTEGR7769XXXXXX9383" />
            <input type="text" name="orderId" value="ORDERID_98765" />
            <input type="text" name="txnToken" value="f0bed899539742309eebd8XXXX7edcf61588842333227" />
            <input type="text" name="paymentMode" value="EMI" />
            <input type="text" name="cardInfo" value="|4375515173401577|942|022022" />
            <input type="text" name="AUTH_MODE" value="otp" />
            <input type="text" name="planId" value="ICICI|3" />
            <input type="submit" />
    </form>

     

  4. Prior to verifying the payment, you must validate the checksumhash received in response to the Process Transaction API. To verify it, use the Paytm library with all the parameters in key-value pairs on the merchant server.
  5. Validate the transaction response via server-side request using the Transaction Status API. You must verify the Order ID and amount with your DB entries and consider the status as the final status of the transaction in all cases.
  6. After the transaction status verification, you show final payment status to the user.

Post integration steps

Post completion of integration in your staging environment, it is mandatory to test the Paytm payment sources integration on your website/app before moving into the live environment with production account details (received from Paytm team)

  1. You can view the staging transaction details in “Test Data” mode on your dashboard.
  2. You must ensure to re-verify the transaction response with Transaction Status API via server to server call for payment flow and not as a one-time activity.

Post successful testing in your staging environment, move your code to the live environment with production account details. These credentials will be available after you activate your business account with Paytm on the Merchant Dashboard.
 

Paytm recommends you to read about Managing Refunds and late payment notifications for a better understanding of the integration.
 

For any issues with the integration, refer to Get in touch.