UPI Plugin SDK

FAQs

  • What is request id?

    Request id is a random UUID v4 string. Request ids should be different for each activity. Refer Generating Request IDlink icon

  • What is customer id?

    Customer ID is any unique reference string associated with your customer. Customer id should be same for a user with same email id, sim id and device id.

  • When do we call initiate?

    For every new session, we need to call initiate so that it can download all the latest bundles and assets and will enable the SDK to boot up and fetch the preliminary data required to support subsequent operations for other SDK flows. Refer: Initiatelink icon

  • What is Process API? How is it different from Initiate? Use cases for calling this?

    Process API should be triggered for all operations required from the SDK. This API can be triggered any number of times based on requirements or app flow structure. Initiate is used to start the SDK whereas Process is used to carry out all other actions supported by UPI In-app SDK. Refer: Processlink icon, Process Payloadslink icon

  • What is UMN (Unique Mandate Number)?

    Unique Mandate Number is used for execution of the mandate. It will be sent in response only if mandate is initiated by Payer.

  • What is getSessionToken? When should it be called?

    This operation will provide the merchant with necessary information about the users onboarding status and VPA accounts available (if any). Based on the response, users will be redirected to different entry points in the onboarding & pay flow. It is required after every initiate for headless merchants. Default expiry of a session is 15 minutes. Refer: Get Session Tokenlink icon, Session Expirylink icon

  • What is the difference between P2P and P2M?

    P2P (Person-to-person) refers to the transaction done between a person and an other person registered on UPI.
    P2M (Person-to-merchant) refers to transaction done between the customer and the merchant.

  • What is the difference between unverified and verified merchant?

    Verified Merchants: These merchants are trusted merchant that has been securely added to the UPI system. You can safely make payment to Verified Merchant.
    Unverified Merchants: These merchants are not verified on the UPI system. However, you may still make payments to these merchants.

  • How many VPAs can the user have?

    Users can have at max of 2 VPAs using our SDK.

  • Is mobile number VPA mandatory?

    No, Users can create any VPA of there choice as long as that VPA is available to be taken.

  • On what all transactions can the complaints be raised?

    If the money is debited but not credited to user

    • In case your transaction is in Pending status kindly check the status of the transaction after T+2 working days. If the issue still persists, kindly raise a complaint.

    • In case your transaction has failed, but the amount was debited then the same will be reversed to you in T+2 working days. If you still face the issue, you can raise a complaint on transaction details page.

  • Which mandates can be edited by the user?

    The Mandates that are PAYER (user) initiated can be edited by the user. The editable fields are date and amount of the mandate. However, user can revoke the mandate whenever he/she wishes.

  • What is P2M (Person-to-merchant) pay?

    This operation will enable customers to pay for the order generated by the merchant. In simple words, in this operation, money is tranferred from the customer to the merchant. Refer: P2M Paylink icon

  • What does deregister process do?

    This process will be used for deregistering the customer from UPI In-app SDK. Removing the device binding, deleting the link between all the VPAs and accounts.

  • Types of bank accounts we can get in UPI?

    The account types that we can send are SAVINGS, CREDIT, CURRENT, SOD, UOD, NRO, NRE. In the case of LITE it will be present as e.g.) CURRENT || LITE.

  • Is Handling permission results mandatory?

    Yes, the SDK requires all the permissions present in the Check Permission call. Denying the permissions will not allow the users to proceed further in the app.

  • How is QR Code generated?

    QR code can be generated on different QR code generators available across internet. A QR code generator is a software which stores data into a QR code. Here, this data is the URL which can be constructed using NPCI guidelines.

  • What is the difference between Status Check APIs & Callbacks?

    After the completion of every payment/refund call, Juspay will provide direct notification to merchant's server regarding the event. These are called Webhooks or Callbacks. Merchant must configure a valid HTTP endpoint that is reachable from our servers to consume these notifications. Our servers will push data using HTTP POST call to merchant's endpoint. Whereas, Status APIs are Server-to-Server API that takes orderid as a path variable and returns the status of the order along with other details.
    Although, we send callbacks to the merchant server regarding certain events in the SDK, however, the merchant can anytime use the Status Check APIs to be know the status of a transaction. Refer: Backend APIslink icon, Callbackslink icon