• Getting Started
    • Mobile Integration (Android/IOS)
      Enterprise Solutions
      Retail Solutions
      Accept Payments
      Process Payments
      API References
      Other Processes
      Mini Program Platform

      Paytm Payment Links

      Paytm Payment Links are used to collect payments from your customers, wherever they are. A Payment Link is a simple web address that can be shared via SMS, email or your favorite chat software with one or many customers. When your customers click on the link, they can complete payment either via Paytm app if it’s installed on your customer’s phone or via a simple payment page that opens in a web/mobile web browser.

      Payment Links can be created via your Paytm Dashboard or via APIs. Your customers do not need to have a Paytm account to pay you using Payment Links.

      Payment Links can be customized according to your requirements -

      Type of LinkDescription
      Generic LinkThere is no limit on number of customers, payments or amount.
      Fixed Amount LinkThere is no restriction on number of payments but the amount is fixed.
      Payment PageYou can collect customer details by capturing additional information during payments.
      Invoice LinkTypically used for a single payment only with a fixed amount

      Demo of Payment via Payment Links

      Overview of Payment Processing via Paytm Payment Links

      1. You can create Payment Links manually via Paytm Dashboard
      2. Use the Create Link API when you need to generate links in bulk or within your application
      3. Specify the mobile number and email to send Link via SMS/Email automatically after Link creation
      4. Use the Resend Notification Link API to resend a Link to any mobile number/email address in case you need to remind a customer for payment
      5. When your customer clicks on the link, one of the following two things will happen -
        1. If your customer has the Paytm App installed, the app is invoked to make payment
        2. If your customer does not have the Paytm App, payment link opens in a desktop/mobile browser
      6. Customers can pay using all available payment methods on your account - Paytm Wallet, UPI, Paytm Payments Bank, Credit/Debit Cards, Netbanking, Paytm Postpaid and more
      7. Once a customer completes the payment, a Payment Callback Notification is sent to your Callback URL specified at the time of link creation. In case a Callback URL is not specified, the notification is sent on the registered Callback URL submitted at the time of account creation
      8. You can get a list of all the Links you have created using Fetch Link API. Get the details of payments against a Link using Fetch Transaction API

      Find the detailed interaction of each system component in the flowchart below:

      flow diagram

      Payment Links Status

      A Payment Link can have any of the following status after creation -

      issuedPayment link is created and sent to customer (if applicable)
      paidPayment for the link is completed by the customer. This is only relevant for Invoice Links.
      cancelledPayment link has been cancelled
      expiredPayment link has expired. Merchant can set a expiry timestamp at the time of creation

      Steps in processing payments via Paytm Link API

      STEP 1: Get your authentication keys

      Generate your staging account credentials from the dashboard -

      • MID (Merchant ID): This is a unique identifier provided to every merchant by Paytm. MID is part of your account credentials and is different on staging and production environment. Your staging MID is available here and production MID will be available once your activation is complete
      • Merchant Key: This is a unique secret key used for secure encryption of every request. This needs to be kept on server side and should not be shared with anyone

      Please note: Client Secret and Merchant Key are secret keys used for encryption so never share these with anyone.

      STEP 2: Create a Payment Link & share it with your customer.

      Demo of Link Creation

      The following is a representative demo of how you can create payment links in your own application -

      • Create a Payment Link with the Create Link API. You can specify the mobile number and email of the customer if you want to send this link to the customer on Email & SMS respectively
      • You can modify the link anytime using the Update Link API. Please note you can only modify the Link Description and Expiry date.
      • You can cancel a link anytime using the Expire Link API. Your customer would not be able to complete payment once the link is expired.
      • You can resend the Link to your customer on any Email ID and Mobile number by using the Resend Link API.
      Payment Pages: Collect additional information from customersdropdown

      You can accept information from your users by sending a form along with the payment link. The customer journey will be as follows:
      1. Customer clicks on the payment link
      2. Form is opened in the web or mobile browser
      3. Post filling the required fields the customer proceeds to payment
      4. If your customer has the Paytm App installed, the app is invoked to make payment
      5. If your customer does not have the Paytm App, payment process is continued in the desktop/mobile browser
      You can attach a form to your link using any of the following two ways
      1. Create form template using Paytm Merchant Dashboard
        1. Go to Paytm’s Dashboard and click on Payment links
        2. Create a payment link and click on capture additional details to start creating a form template
        3. Once you create a template, you will get a template id
        4. Use this template ID in the Create Link API to send the form along with your Payment Link
      2. Create the form using APIs
        1. Use the Fetch Suggested Fields API to start creating a form. Suggested fields will help you create forms faster by showing you pre created fields
        2. Once you have decided the fields in your form use the Save Template API to save the form template. A template ID will be linked to each of the templates
        3. Use the Fetch Templates API to attach a previously saved form template to your link. 
        4. Use this template ID in the Create Link API to Send the Form along with your Payment Link
        5. Using the Fetch Template Fields API, the fields related to a template ID will be populated
        6. If you wish to delete a saved field use the Delete Custom Field API. You can also delete a template by using the Delete Template API

      STEP 3: Payment Confirmation and Reconciliation

      STEP 4: Managing Refunds

      If you need to cancel or refund a successful transaction, you can do so by simply sending a Refund API request and ensuring success using the Refund Status API.

      REFID - REFID parameter in Refund API should mandatory be sent as Unique ID for every refund request sent to Paytm.The refund request can fail due to insufficient funds in MPA (Merchant Payable Account). For failure refund status, the merchant can retry refunds. However, for Pending refunds merchant should not retry refund.

      On completion of your integration

      Once the test transaction is complete, move your code to live environment with production account details. Note that production accounts details are available after you have activated your account on the dashboard.

      In case of any issues with integration, please get in touch.