Deregister Fundsource Lite with Zero Balance

Deregister an active Fundsource Lite account with zero balance using Razorpay Fundsource Lite API.

DELETE /v1/upi/tpap/fundsource_lite/\{:liteid\}/deregister

Curl

curl -X DELETE 'https://api.rzp.<bank>.com/v1/upi/tpap/fundsource_lite/{lite_id}/deregister' \
-u [YOUR_KEY_ID]:[YOUR_SECRET] \
-H "Content-type: application/json" \
-H "x-device-fingerprint: <device_fingerprint>" \
-H "x-device-fingerprint-timestamp: 1496918882000" \
-H "x-customer-reference: cust_ref"

Success

{
  "entity": "upi.fundsource_lite",
  "id": "lite_id",
  "upi_lite_reference_number": "1234567890",
  "upi_transaction_id": "RZPc2ed455b797e4add8392110cfc528acc",
  "status": "deregistered",
  "upi_lite_credentials": {
    "ARPC": "string"
  },
  "fundsource": {
    "id": "fs_1234",
    "entity": "upi.fundsource",
    "type": "savings",
    "customer_name": "Gaurav Kumar",
    "masked_account_number": "XXXXXX5199",
    "account_reference_number": "999988126236990",
    "ifsc": "HDFC000001",
    "upi_pin_set": true,
    "upi_pin_length": 6,
    "otp_length": 6,
    "atm_pin_length": 4,
    "fundsource_provider": {
      "name": "HDFC Bank",
      "upi_iin": "600007",
      "upi_enabled": false,
      "mobile_registration_format": "format1",
      "logo_url": "<bank logo url>",
      "upi_lite_allowed": true
    },
    "vpas": {
      "entity": "collection",
      "count": 1,
      "items": [
        {
          "mobile": "9999999999",
          "address": "vpa@handle",
          "status": "active",
          "primary": true
        }
      ]
    }
  }
}

Available in🇮🇳 India

Use this endpoint to deregister a Fundsource Lite account when the balance is zero.

Curl

curl -X DELETE 'https://api.rzp.<bank>.com/v1/upi/tpap/fundsource_lite/{lite_id}/deregister' \
-u [YOUR_KEY_ID]:[YOUR_SECRET] \
-H "Content-type: application/json" \
-H "x-device-fingerprint: <device_fingerprint>" \
-H "x-device-fingerprint-timestamp: 1496918882000" \
-H "x-customer-reference: cust_ref"

Success

{
  "entity": "upi.fundsource_lite",
  "id": "lite_id",
  "upi_lite_reference_number": "1234567890",
  "upi_transaction_id": "RZPc2ed455b797e4add8392110cfc528acc",
  "status": "deregistered",
  "upi_lite_credentials": {
    "ARPC": "string"
  },
  "fundsource": {
    "id": "fs_1234",
    "entity": "upi.fundsource",
    "type": "savings",
    "customer_name": "Gaurav Kumar",
    "masked_account_number": "XXXXXX5199",
    "account_reference_number": "999988126236990",
    "ifsc": "HDFC000001",
    "upi_pin_set": true,
    "upi_pin_length": 6,
    "otp_length": 6,
    "atm_pin_length": 4,
    "fundsource_provider": {
      "name": "HDFC Bank",
      "upi_iin": "600007",
      "upi_enabled": false,
      "mobile_registration_format": "format1",
      "logo_url": "<bank logo url>",
      "upi_lite_allowed": true
    },
    "vpas": {
      "entity": "collection",
      "count": 1,
      "items": [
        {
          "mobile": "9999999999",
          "address": "vpa@handle",
          "status": "active",
          "primary": true
        }
      ]
    }
  }
}

Query Parameters

lite_id · string · required

Unique identifier of the Fundsource Lite account to be deregistered.

Response Parameters

entity · string

Name of the entity. Here it is upi.fundsource_lite.

id · string

Unique identifier for the Fundsource Lite entity.

upi_lite_reference_number · string

Reference number for the Lite account, assigned by the originator.

upi_transaction_id · string

Unique UPI transaction identifier.

status · string

Current status of the UPI Lite account. Possible values:

• initiated
• active
• deregistered

upi_lite_credentials · object

ARPC encrypted credential for authorisation.

ARPC · string

Authentication Response Code credential.

fundsource · object

The fundsource for which Lite is enabled.

id · string

Unique identifier of the fundsource.

entity · string

Name of the entity. Here it is fundsource.

type · string

Account type.

customer_name · string

Name of the customer.

masked_account_number · string

Masked version of the customer’s account number.

account_reference_number · string

Reference number assigned to the customer’s account.

ifsc · string

IFSC code of the account.

upi_pin_set · boolean

Indicates whether UPI PIN is already set.

• true: UPI PIN is already set.
• false: UPI PIN is not set.

upi_pin_length · integer

Length of UPI PIN.

otp_length · integer

OTP length used during registration.

atm_pin_length · integer

ATM PIN length of the account.

fundsource_provider · object

Details of the bank.

name · string

Name of the bank.

upi_iin · string

UPI IIN code assigned to the provider by NPCI.

upi_enabled · boolean

Indicates whether UPI is enabled for the provider. Possible values:

• true: UPI is enabled.
• false: UPI is not enabled.

mobile_registration_format · string

Mobile registration format supported.

logo_url · string

URL to the provider’s logo.

upi_lite_allowed · boolean

Indicates whether UPI Lite is allowed by the bank. Possible values:

• true: UPI Lite is allowed.
• false: UPI Lite is not allowed.

vpas · object

Collection of VPAs for the fundsource.

entity · string

Name of the entity. Here it is collection.

count · integer

Total number of VPA items.

items · array

Array of VPA objects.

mobile · string

Registered mobile number.

address · string

UPI VPA address.

status · string

Status of the VPA. Possible values:

• active
• inactive

primary · boolean

Indicates where the VPA is primary.

• true: VPA is primary.
• false: VPA is not primary.