> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Turbo UPI SDK - Error Codes

> List of error codes for Turbo UPI SDK.

<div style={{display:"flex",flexWrap:"wrap",alignItems:"center",gap:"0.35rem 0.9rem",border:"1px solid rgba(128,128,128,0.28)",borderRadius:"0.5rem",padding:"0.45rem 0.75rem",margin:"0 0 1.25rem",fontSize:"0.875rem"}}>
  <span style={{fontWeight:600}}>Available in</span>
  <span>🇮🇳 India</span>
</div>

Given below is the list of error codes categorised by error reasons, with relevant descriptions, source and step.

### Bad Request Errors

Given below is the list of Bad Request errors.

<AccordionGroup>
  <Accordion title="bank_not_live_on_upi">
    * **Description**: The selected bank is not enabled on UPI. Please try using another bank.
    * **Source**: gateway
    * **Step**: customer\_onboarding
  </Accordion>

  <Accordion title="account_does_not_exist">
    <AccordionGroup>
      <Accordion title="Payment Debit Request">
        * **Description**: No accounts found for the selected bank. Please try using another bank.
        * **Source**: issuer\_bank
        * **Step**: payment\_debit\_request
      </Accordion>

      <Accordion title="Payment Credit Request">
        * **Description**: Payment was unsuccessful as the receiver's bank account is not valid. Any amount deducted will be refunded within 5-7 working days.
        * **Source**: beneficiary\_bank
        * **Step**: payment\_credit\_request
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="transaction_not_allowed">
    <AccordionGroup>
      <Accordion title="Payment Debit Request">
        * **Description**: Transaction not permitted to the account as per your bank policy. Please contact your bank for more details or try with another bank account.
        * **Source**: customer
        * **Step**: payment\_debit\_request
      </Accordion>

      <Accordion title="Payment Credit Request">
        * **Description**: Payment not allowed as it got declined by the receiver's bank. Any amount deducted will be refunded within 5-7 working days.
        * **Source**: beneficiary\_bank
        * **Step**: payment\_credit\_request
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="upi_pin_registration_card_expired">
    * **Description**: Card used while setting UPI PIN has expired. Please use another debit card or use another bank account.
    * **Source**: issuer\_bank
    * **Step**: payment\_authentication
  </Accordion>

  <Accordion title="upi_pin_registration_card_not_found">
    * **Description**: Card details used while setting UPI PIN are incorrect. Please re-check and try again.
    * **Source**: issuer\_bank
    * **Step**: payment\_authentication
  </Accordion>

  <Accordion title="upi_pin_registration_card_restricted">
    * **Description**: Card used while setting UPI PIN has been blocked by your bank. Please reach out to your bank for more information or try using another bank account.
    * **Source**: issuer\_bank
    * **Step**: payment\_authentication
  </Accordion>

  <Accordion title="bank_technical_error">
    * **Description**: Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.
    * **Source**: beneficiary\_bank
    * **Step**: payment\_status\_request
  </Accordion>

  <Accordion title="pin_not_set">
    * **Description**: Payment was unsuccessful as you have not set the UPI PIN on the app. Try using another method.
    * **Source**: customer\_psp
    * **Step**: payment\_authentication
  </Accordion>

  <Accordion title="customer_not_registered">
    * **Description**: No bank account is associated with this mobile number. Please try again by adding your account.
    * **Source**: gateway
    * **Step**: customer\_onboarding
  </Accordion>

  <Accordion title="server_error">
    * **Description**: Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.
    * **Source**: gateway
    * **Step**: payment\_authentication
  </Accordion>

  <Accordion title="payment_cancelled_by_user">
    * **Description**: Flow was aborted as you pressed back from the PIN screen. Please try again.
    * **Source**: customer
    * **Step**: payment\_authorization
  </Accordion>
</AccordionGroup>

### Gateway Errors

Given below is the list of gateway errors.

<AccordionGroup>
  <Accordion title="incorrect_otp">
    * **Description**: You have entered an incorrect OTP. Try again.
    * **Source**: customer
    * **Step**: customer\_onboarding
  </Accordion>

  <Accordion title="otp_expired">
    * **Description**: You have entered an expired OTP. Please regenerate OTP and try again.
    * **Source**: customer
    * **Step**: customer\_onboarding
  </Accordion>

  <Accordion title="insufficient_funds">
    * **Description**: Payment was unsuccessful due to insufficient funds. Kindly check your balance and try again.
    * **Source**: customer
    * **Step**: payment\_debit\_request
  </Accordion>

  <Accordion title="insufficient_funds_mandate_block">
    * **Description**: Payment was unsuccessful as the amount in your account is blocked for another payment. Try using another account.
    * **Source**: issuer\_bank
    * **Step**: payment\_authentication
  </Accordion>

  <Accordion title="otp_attempts_exceeded">
    * **Description**: You have entered an incorrect OTP too many times. Try again in some time.
    * **Source**: customer\_psp
    * **Step**: customer\_onboarding
  </Accordion>

  <Accordion title="account_dormant">
    * **Description**: Payment was unsuccessful as the receiver's bank account is inactive. Any amount deducted will be refunded within 5-7 working days.
    * **Source**: beneficiary\_bank
    * **Step**: payment\_credit\_request
  </Accordion>

  <Accordion title="bank_not_live_on_upi">
    * **Description**: Selected bank is not available on UPI. Please try using another bank.
    * **Source**: issuer\_bank
    * **Step**: customer\_onboarding
  </Accordion>

  <Accordion title="payment_timed_out">
    <AccordionGroup>
      <Accordion title="Temporary Issue">
        * **Description**: Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.
        * **Source**: beneficiary\_bank
        * **Step**: payment\_response
      </Accordion>

      <Accordion title="UPI ID Not Reachable">
        * **Description**: Payment was unsuccessful as the bank linked to this UPI ID is not reachable at this time.
        * **Source**: issuer\_bank
        * **Step**: payment\_debit\_response
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="first_transaction_limit_exceeded">
    * **Description**: Payment was unsuccessful as you exceeded the first-time transaction limit set by your bank. You can use another bank account or retry after 24 hours.
    * **Source**: issuer\_bank
    * **Step**: payment\_debit\_response
  </Accordion>

  <Accordion title="transaction_limit_exceeded">
    <AccordionGroup>
      <Accordion title="Limit Set By Bank Exceeded">
        * **Description**: Payment was unsuccessful as you exceeded the transaction limit set by your bank. Try using another account.
        * **Source**: issuer\_bank
        * **Step**: payment\_debit\_response
      </Accordion>

      <Accordion title="Daily Amount Limit Exceeded">
        * **Description**: Payment was unsuccessful as you exceeded the amount limit for the day with this bank account. Try using another account.
        * **Source**: issuer\_bank
        * **Step**: payment\_debit\_response
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="first_time_transaction_freeze_period">
    * **Description**: Payment was unsuccessful due to the cooling period set by your bank for first-time user. Please try again after some time.
    * **Source**: issuer\_bank
    * **Step**: payment\_debit\_response
  </Accordion>

  <Accordion title="transaction_frequency_limit_exceeded">
    * **Description**: Payment was unsuccessful as the number of transactions exceeds the max limit set by the bank. You can use another bank account or retry after some time.
    * **Source**: issuer\_bank
    * **Step**: payment\_debit\_response
  </Accordion>

  <Accordion title="bank_account_inactive">
    <AccordionGroup>
      <Accordion title="Issuer Bank Account Inactive">
        * **Description**: Payment was unsuccessful as your account is not active. Please try using another bank account.
        * **Source**: issuer\_bank
        * **Step**: payment\_debit\_request
      </Accordion>

      <Accordion title="Receiver Bank Account Inactive">
        * **Description**: Payment was unsuccessful as the receiver's bank account is not active. Any amount deducted will be refunded within 5-7 working days.
        * **Source**: beneficiary\_bank
        * **Step**: payment\_debit\_request
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="server_error">
    <AccordionGroup>
      <Accordion title="Temporary Issue - Issuer Bank">
        * **Description**: Payment was unsuccessful due to a temporary issue. Please retry in some time.
        * **Source**: beneficiary\_bank
        * **Step**: payment\_request
      </Accordion>

      <Accordion title="Temporary Issue - Beneficiary Bank">
        * **Description**: Payment was unsuccessful due to a temporary issue. Please retry in some time.
        * **Source**: issuer\_bank
        * **Step**: payment\_request
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="invalid_ifsc">
    * **Description**: Payment was unsuccessful due to a temporary issue. Please retry in some time.
    * **Source**: gateway
    * **Step**: payment\_authentication
  </Accordion>

  <Accordion title="upi_pin_registration_card_blocked">
    * **Description**: Card used while setting UPI PIN has been blocked by your bank. Please reach out to your bank for more information or try using another bank account.
    * **Source**: issuer\_bank
    * **Step**: payment\_authentication
  </Accordion>

  <Accordion title="bank_technical_error">
    <AccordionGroup>
      <Accordion title="UPI ID Temporarily Unavailable">
        * **Description**: Payment was unsuccessful as the bank linked to this UPI ID is temporarily unavailable. Any amount deducted will be refunded within 5-7 working days.
        * **Source**: issuer\_bank
        * **Step**: payment\_credit\_response
      </Accordion>

      <Accordion title="Temporary Issue">
        * **Description**: Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.
        * **Source**: issuer\_bank
        * **Step**: payment\_credit\_response
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="payment_declined">
    <AccordionGroup>
      <Accordion title="Declined by Bank">
        * **Description**: Payment was unsuccessful as it was declined by your bank. Reach out to your bank for more details. Try using another account.
        * **Source**: issuer\_bank
        * **Step**: payment\_debit\_request
      </Accordion>

      <Accordion title="Temporary Issue">
        * **Description**: Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.
        * **Source**: beneficiary\_bank
        * **Step**: payment\_debit\_request
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="pin_attempts_exceeded">
    * **Description**: You have exceeded the incorrect UPI PIN attempts. You can use another bank account or retry after 24 hours.
    * **Source**: customer
    * **Step**: payment\_authentication
  </Accordion>

  <Accordion title="incorrect_pin">
    * **Description**: You have entered incorrect UPI PIN. Please try again with the correct UPI PIN.
    * **Source**: customer
    * **Step**: payment\_authentication
  </Accordion>

  <Accordion title="linked_account_removal_failed">
    * **Description**: Unable to remove the account. Please try again.
    * **Source**: customer\_psp
    * **Step**: account\_management
  </Accordion>

  <Accordion title="sms_text_not_received">
    * **Description**: Something went wrong while sending SMS. Please try again.
    * **Source**: gateway
    * **Step**: customer\_onboarding
  </Accordion>
</AccordionGroup>

### Server Errors

Given below is the list of server errors.

<AccordionGroup>
  <Accordion title="server_error">
    * **Description**: Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.
    * **Source**: issuer\_bank
    * **Step**: customer\_onboarding
  </Accordion>

  <Accordion title="server_error">
    * **Description**: We are facing some trouble completing your request at the moment. Please try again shortly.
    * **Source**: internal
    * **Step**: payment\_authorization
  </Accordion>
</AccordionGroup>