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

      post Validate API - EMI Subvention

      Use Case


      This api validates the dynamic conditions on the payment gateway page. Merchant needs to send one of the cacheCardtoken and cardNumber

      Request Attributes


      API Content Type: JSON

      Head1

      Head

      ATTRIBUTEDESCRIPTION
      channelId string(3)
      optional
      The parameter value identifies the Channel for which API call is initiated.
      Possible Values: WEBFor websites, the value to be passed should be "WEB", WAPFor Mobile websites/App, the value to be passed should be "WAP"
      requestId string(32)
      mandatory
      Unique reference ID for a transaction which is generated by merchant and sent in the request
      requestTimestamp string(15)
      mandatory
      EPOCH timestamp of the time at which request is being sent.
      version string(4)
      mandatory
      Version of the API.
      Example: v1
      tokenType string
      mandatory
      This is for authentication method.
      For SSO token authentication, the value is SSO.
      For checksum authentication, the value is CHECKSUM.
      token string
      mandatory
      For tokenType SSO, use SSO Token of Paytm User.
      For tokenType CHECKSUM, It's value to be sent should be the checksum string created by using Paytm checksum library.
      Body1

      Body

      ATTRIBUTEDESCRIPTION
      mid string(20)
      mandatory
      Paytm provides MID as a unique identifier to each merchant. For your staging MID, click here. You get the production MID post the account activation.
      Example: INTEGR7769XXXXXX9383
      planId string
      mandatory
      ID of the plan
      items items
      mandatory
      Item list sent for EMI
      Items +
      AttributeDescription
      id string
      mandatory
      Any unique identifier for one item in the request e.g. in case of 2 items in the cart, the values can be sent as 1234 and 1236.
      productId string
      mandatory
      Unique product identifier for the merchant.
      brandId string
      optional
      Product brand identifier for the merchant e.g. LG, Sony etc. Should be send in the request if EMI plans are configured with brand attribute.
      categoryList string[]
      mandatory
      Product category identifiers for the merchant (categories can be Electronics, footwears etc). This should be sent in the request with same value which is configured in the EMI plan.
      model string
      optional
      Model id of the product. This should be sent if the merchant's EMI plans are configured with model attribute.
      ean string
      optional
      (Bar code Number) of product. This should be sent if the merchant's EMI plans are configured with EAN attribute.
      price double
      mandatory
      Cumulative price of the product (multiplied by quantity)
      quantity int
      mandatory
      Quantity of the product.
      verticalId string
      mandatory
      Merchant need to send this field with value "PAYTM_EMI"
      isEmiEnabled boolean
      mandatory
      Whether EMI is Enabled for the product.
      offerDetails object
      mandatory
      OfferId that is enabled on the product
      OfferDetails +
      AttributeDescription
      offerId string
      mandatory
      OfferId of the product
      paymentDetails PaymentDetails
      mandatory
      PaymentDetails
      PaymentDetails +
      AttributeDescription
      cardNumber string
      optional
      Card Number of the card
      totalTransactionAmount double
      mandatory
      Total amount on which transaction has to be done
      generateTokenForIntent boolean
      optional
      It's value can be True or False. In case, the merchant wants to start the transaction, then it's value should be sent as True, else it's value should be sent as False.
      customerId string
      mandatory
      Unique reference ID for every customer which is generated by merchant. Special characters allowed in CustId are @, ! ,_ ,$,
      cacheCardToken boolean
      Conditional (either of cacheCardToken or cardNumber should be present)
      Conditional (either of cacheCardToken or cardNumber should be present)

      Response Attributes


      API Content Type: JSON

      Head2

      Head

      ATTRIBUTEDESCRIPTION
      requestId string
      Unique reference ID for a transaction which is generated by merchant.
      responseTimestamp string(15)
      EPOCH timestamp of the time at which response is being sent.
      Example: 1588402269
      version string(2)
      Version of the API passed in the request.
      Example: v1
      Body2

      Body

      ATTRIBUTEDESCRIPTION
      resultInfo object
      This parameter gives the information about the result of the API response
      ResultInfo +
      AttributeDescription
      resultCode string
      This is the resultCode corresponding to a particular message and is returned to the merchant. It's maximum length is 64. The different result codes corresponding to this API are mentioned below
      resultStatus string
      This parameter indicates the status of API call.
      Possible Values: SFor Success, FFor Failed
      resultMsg string(256)
      This parameter is the result message which contains information about the result.The different result messages corresponding to this API are mentioned below
      planId string
      ID of the plan
      pgPlanId string
      Identified for the EMI plan. Its value will be in the form BANK_CODE|TENUREE
      emiType enum
      Type of EMI. It's value can be SUBVENTION or STANDARD.
      emiLabel string
      Label for EMI [Subvention, "Zero/Low Cost EMI", Standard EMI]
      rate string
      Rate of interest in percentage for this EMI charged by bank.
      interval string
      Interval of EMI in months e.g. 3, 6, 9, 12 etc.
      emi string
      Effective EMI cost per month for the item.
      interest string
      Interest amount for this EMI charged by bank.
      gratifications object
      Gratitifications available on the plans. This field will be present for only subvention EMI plans.
      Gratifications +
      AttributeDescription
      value double
      Amount of gratficication e.g. the interest amount which is to be given as discount or cashback.
      type enum
      Type of grattification, its value can be DISCOUNT or CASHBACK
      label string
      Label for gratification.
      itemBreakUpList object
      Item wise breakUp of EMI and gratifications.
      ItemBreakUp +
      AttributeDescription
      id string
      ID of the item
      interest double
      Interest aplicable on item
      offerId string
      ID of the offer
      amountBearer object
      EMI of the item
      AmountBearer +
      AttributeDescription
      brand double
      Name of the brand (Amazon)
      merchant double
      Name of the merchant (MI)
      platform double
      Name of the platform (Paytm PG)
      subventionType enum
      Type of Subvention
      gratifications object
      Gratifications available on per item
      Gratifications +
      AttributeDescription
      value double
      Amount of gratficication e.g. the interest amount which is to be given as discount or cashback.
      type enum
      Type of grattification, its value can be DISCOUNT or CASHBACK
      label string
      Label for gratification.
      bankId string
      ID of the bank
      bankName string
      Name of the bank to which card belongs.
      bankCode string
      Bank code of the card (ICICI,SBI...)
      cardType string
      Type of Card(CREDIT_CARD or DEBIT_CARD)
      bankLogoUrl string
      URL for bank logo
      emiSubventionToken string
      Token which is generated when merchant intends to do payment on the card of customer. This field is present in the response when generateTokenForIntent boolean in the request is 'True'. It will be needed to send in the initiateTransaction API request.
      finalTransactionAmount string
      Amount that is returned after subvention is applied

      Response Codes and Messages


      resultCoderesultStatusresultMsg
      0000SSuccess
      0001FFAILED
      1001FRequest prameters are not valid
      1007FMissing mandatory element
      2006FMID is invalid
      EMI_001FMandatory info is missing
      EMI_002FItems's data is not valid
      EMI_003FItems are empty
      EMI_004FSome error occured. Please try later
      EMI_005FPlans not available right now. Please try later
      EMI_006FNo emi options are available for these items
      EMI_007FInvalid bank details
      EMI_008FYou are not eligible for availing EMI on this card
      EMI_009FSelected plan does not exist
      EMI_010FSelected plan is not eligible for these items
      EMI_011FSelected plan details might have changed
      EMI_012FLock is acquired, please try after some time
      EMI_013FCards details are invalid
      EMI_014FNo subvented items found to be stamped
      EMI_015FOrder data could not be stamped. Please try again
      EMI_016FOrder item status could not be updated. Please try again
      EMI_017FMore than 2 retries are not allowed
      EMI_018FEMI is not enabled on some items
      EMI_019FSome of the selected offers are invalid
      EMI_020FSelected plan is not offered by this bank
      StagingProduction
      REQUESTRESPONSE
      curl -X POST 'https://securegw-stage.paytm.in/theia/api/v1/emiSubvention/validateEmi?mid={mid}' \
      --header 'Content-Type: application/json' \
      --data '{"body":{"items":[{"id":"ITEMID_98765","productId":"PRODUCTID_98765","brandId":"BRANDID_98765","categoryList":["Electronics"],"quantity":"1","price":"1000","verticalId":"PAYTM_EMI","isEmiEnabled":true,"offerDetails":{"offerId":"OFFERID_98765"}}],"mid":"{mid}","customerId":"CUST_001","planId":"PLANID_98765","paymentDetails":{"totalTransactionAmount":"1000","cardNumber":"|4111111111111111|111|122032"},"generateTokenForIntent":true},"head":{"requestId":"REQUESTID_98765","token":"{checksum}","tokenType":"CHECKSUM"}}'