paytm developer docs logoDeveloperDocumentation
search

Subscription activation - Standard Checkout

Demo

Overview

  1. User selects the plan and you get the Transaction Token using the Initiate Subscription API.
  2. Submit the request as HTML form POST and it will redirect the customer to Paytm's payment page.
  3. The customer enters the payment details to complete the activation.
  4. The response gets posted as an HTML form POST on your app/website's callback URL.
  5. Use the Subscription S2S Callback or Fetch Subscription Status API to confirm the subscription status and display the confirmation to the user on your app/website.

 

Flow diagram to show the subscription activation via Standard Checkout
 

Integration Steps

  1. Creating a payload

    Create a payload with parameters in the key value pairs. Using the payload, make an HTML form post and redirect the customer to Paytm server.
     

    Request Attributes

    PARAMETER DESCRIPTION MANDATORY
    orderId
    String    		 A unique reference ID generated by a merchant for the transaction and sent in the request. Yes
    txnToken
    String    		 Transaction Token received in the Initiate Subscription API response. Yes
    mid
    String    		 A unique identifier provided to every merchant by Paytm at the time of their creation. Yes

    HTML Form Post 
    <html>
    <head>
        <title>Standard Checkout</title>
    </head>
    <body>
        <center>
            <h1>Please do not refresh this page...</h1>
        </center>
            <form method="post" action="https://securegw-stage.paytm.in/theia/api/v1/showPaymentPage?mid=YOUR_MID_HERE&orderId=YOUR_ORDERID_HERE" name="paytm"> 
            <table border="1">
                <tbody>
                    <input type="hidden" name="mid" value="YOUR_MID_HERE">
                    <input type="hidden" name="orderId" value="YOUR_ORDERID_HERE">
                    <input type="hidden" name="txnToken" value="YOUR_TXNTOKEN_HERE">
                </tbody>
            </table>
            <script type="text/javascript">
                document.paytm.submit();
            </script>
        </form>
    </body>
</html>

  2. Redirecting to the bank page for authorization

    The customer enters the payment details and is redirected to the bank page for authorization. Once the subscription is authorized, Paytm receives the response from the bank and returns a status to your website via your callback URL. Response attributes description and sample HTML form post is provided here.

  3. Fetching the latest subscription status

    Paytm will provide an S2S callback on your configured callback URL. Alternatively, you use a Fetch Subscription Status API to fetch the latest status.