Docs Logo

Account

Create an Account

Fetch an Account

Update an Account

Delete an Account

Docs Logo

API Test keys

Api

Partners

Account Onboarding

Delete

API Test keys

Api

Partners

Account Onboarding

Delete

Delete an Account

DELETE
/v2/accounts/:account_id

Click to copy

Use this endpoint to delete a sub-merchant account. Know about the

various error responses

for this API.

Is this page helpful?

Curl

change language

change language

1
curl -u <YOUR_KEY_ID>:<YOUR_KEY_SECRET> \
2
-X DELETE https://api.razorpay.com/v2/accounts/acc_GXQAkO2MrvBYg4 \

Success

1
{
2
  "id": "acc_GXQAkO2MrvBYg4",
3
  "type": "standard",
4
  "status": "suspended",
5
  "email": "gaurav.kumar@acme.org",
6
  "profile": {
7
    "category": "healthcare",
8
    "subcategory": "clinic",
9
    "addresses": {
10
      "registered": {
11
        "street1": "507, Koramangala 1st block",
12
        "street2": "MG Road",
13
        "city": "Bengaluru",
14
        "state": "KARNATAKA",
15
        "postal_code": "560034",
16
        "country": "IN"
17
      },
18
      "operation": {
19
        "street1": "507, Koramangala 1st block",
20
        "street2": "MG Road",
21
        "city": "Bengaluru",
22
        "state": "KARNATAKA",
23
        "country": "IN",
24
        "postal_code": "560034"
25
      }
26
    },
27
    "business_model": "Online Clothing ( men, women, ethnic, modern ) fashion and lifestyle, accessories, t-shirt, shirt, track pant, shoes."
28
  },
29
  "notes": {
30
    "internal_ref_id": "123123"
31
  },
32
  "created_at": 1612425180,
33
  "suspended_at": 1612425235,
34
  "phone": "9000090000",
35
  "reference_id": "account_COdeRandom",
36
  "business_type": "partnership",
37
  "legal_business_name": "Acme Corp Pvt Ltd",
38
  "customer_facing_business_name": "Acme",
39
  "legal_info": {
40
    "pan": "AAACL1234C",
41
    "gst": "18AABCU9603R1ZM"
42
  },
43
  "apps": {
44
    "websites": [
45
      "https://www.acme.org"
46
    ],
47
    "android": [
48
      {
49
        "url": "playstore.acme.org",
50
        "name": "Acme"
51
      }
52
    ],
53
    "ios": [
54
      {
55
        "url": "appstore.acme.org",
56
        "name": "Acme"
57
      }
58
    ]
59
  },
60
  "brand": {
61
    "color": "#FFFFFF"
62
  },
63
  "contact_name": "Gaurav Kumar",
64
  "contact_info": {
65
    "chargeback": {
66
      "email": "cb@acme.org",
67
      "phone": "9000090000",
68
      "policy_url": "https://www.google.com"
69
    },
70
    "refund": {
71
      "email": "cb@acme.org",
72
      "phone": "9898989898",
73
      "policy_url": "https://www.google.com"
74
    },
75
    "support": {
76
      "email": "support@acme.org",
77
      "phone": "9898989898",
78
      "policy_url": "https://www.google.com"
79
    }
80
  }
81
}
Path Parameters
account_id

*

string

The unique identifier of a sub-merchant account that must be deleted. For example, acc_GPaClllZWaPBfv.

Response Parameters
id
string

The unique identifier of a sub-merchant account generated by Razorpay. The maximum length is 18 characters. For example, acc_GLGeLkU2JUeyDZ.

type
string

The account type. Possible value is standard.

status
string

The status of the account changes to suspended.

email
string

The sub-merchant's business email address.

phone
integer

The sub-merchant's business phone number. The minimum length is 8 characters and the maximum length is 15.

legal_business_name
string

The name of the sub-merchant's business. For example, Acme Corp. The minimum length is 4 characters and the maximum length is 200.

customer_facing_business_name
string

The sub-merchant billing label as it appears on the Razorpay Dashboard. The minimum length is 1 character and the maximum length is 255. This parameter might be required to complete the KYC process. However, it is optional for this API.

business_type
string

The type of business operated by the sub-merchant. Possible values:

Business Types

.

suspended_at
integer

Timestamp, in Unix format, at which the account will be suspended.

reference_id
string

Partner's external account reference id. The minimum length is 1 character and the maximum length is 512.

profile
object

The business details of the sub-merchant's account.

Show child parameters (5)

legal_info
object

The legal details about the sub-merchant's business.

Show child parameters (3)

brand
object

The branding details of the sub-merchant's business.

Show child parameters (1)

notes
object

Contains user-defined fields stored by the partner for reference purposes.

contact_name
string

The name of the contact. The minimum length is 4 and the maximum length is 255 characters.

contact_info
object

Options available for contact support.

Show child parameters (3)

apps
object

The app details of the sub-merchant's business

Show child parameters (3)

activated_at
integer

Unix timestamp that indicates when the merchant account was activated. This parameter has null value till the account is activated.

live
boolean

Indicates the payments acceptance status of the merchant account. Possible values:

  • true: Merchant can start accepting customer payments.
  • false: Merchant cannot accept customer payments.

hold_funds
boolean

Indicates the settlements status of the merchant account. Possible values:

  • true: Settlement are on hold. Funds are not transferred to the merchant account.
  • false: Settlements can be transferred to the merchant account.

Delete an Account

DELETE
/v2/accounts/:account_id

Click to copy

Use this endpoint to delete a sub-merchant account. Know about the

various error responses

for this API.

Is this page helpful?

Path Parameters
account_id

*

string

The unique identifier of a sub-merchant account that must be deleted. For example, acc_GPaClllZWaPBfv.

Response Parameters
id
string

The unique identifier of a sub-merchant account generated by Razorpay. The maximum length is 18 characters. For example, acc_GLGeLkU2JUeyDZ.

type
string

The account type. Possible value is standard.

status
string

The status of the account changes to suspended.

email
string

The sub-merchant's business email address.

phone
integer

The sub-merchant's business phone number. The minimum length is 8 characters and the maximum length is 15.

legal_business_name
string

The name of the sub-merchant's business. For example, Acme Corp. The minimum length is 4 characters and the maximum length is 200.

customer_facing_business_name
string

The sub-merchant billing label as it appears on the Razorpay Dashboard. The minimum length is 1 character and the maximum length is 255. This parameter might be required to complete the KYC process. However, it is optional for this API.

business_type
string

The type of business operated by the sub-merchant. Possible values:

Business Types

.

suspended_at
integer

Timestamp, in Unix format, at which the account will be suspended.

reference_id
string

Partner's external account reference id. The minimum length is 1 character and the maximum length is 512.

profile
object

The business details of the sub-merchant's account.

Show child parameters (5)

legal_info
object

The legal details about the sub-merchant's business.

Show child parameters (3)

brand
object

The branding details of the sub-merchant's business.

Show child parameters (1)

notes
object

Contains user-defined fields stored by the partner for reference purposes.

contact_name
string

The name of the contact. The minimum length is 4 and the maximum length is 255 characters.

contact_info
object

Options available for contact support.

Show child parameters (3)

apps
object

The app details of the sub-merchant's business

Show child parameters (3)

activated_at
integer

Unix timestamp that indicates when the merchant account was activated. This parameter has null value till the account is activated.

live
boolean

Indicates the payments acceptance status of the merchant account. Possible values:

  • true: Merchant can start accepting customer payments.
  • false: Merchant cannot accept customer payments.

hold_funds
boolean

Indicates the settlements status of the merchant account. Possible values:

  • true: Settlement are on hold. Funds are not transferred to the merchant account.
  • false: Settlements can be transferred to the merchant account.

Curl

change language

change language

1
curl -u <YOUR_KEY_ID>:<YOUR_KEY_SECRET> \
2
-X DELETE https://api.razorpay.com/v2/accounts/acc_GXQAkO2MrvBYg4 \

Success

1
{
2
  "id": "acc_GXQAkO2MrvBYg4",
3
  "type": "standard",
4
  "status": "suspended",
5
  "email": "gaurav.kumar@acme.org",
6
  "profile": {
7
    "category": "healthcare",
8
    "subcategory": "clinic",
9
    "addresses": {
10
      "registered": {
11
        "street1": "507, Koramangala 1st block",
12
        "street2": "MG Road",
13
        "city": "Bengaluru",
14
        "state": "KARNATAKA",
15
        "postal_code": "560034",
16
        "country": "IN"
17
      },
18
      "operation": {
19
        "street1": "507, Koramangala 1st block",
20
        "street2": "MG Road",
21
        "city": "Bengaluru",
22
        "state": "KARNATAKA",
23
        "country": "IN",
24
        "postal_code": "560034"
25
      }
26
    },
27
    "business_model": "Online Clothing ( men, women, ethnic, modern ) fashion and lifestyle, accessories, t-shirt, shirt, track pant, shoes."
28
  },
29
  "notes": {
30
    "internal_ref_id": "123123"
31
  },
32
  "created_at": 1612425180,
33
  "suspended_at": 1612425235,
34
  "phone": "9000090000",
35
  "reference_id": "account_COdeRandom",
36
  "business_type": "partnership",
37
  "legal_business_name": "Acme Corp Pvt Ltd",
38
  "customer_facing_business_name": "Acme",
39
  "legal_info": {
40
    "pan": "AAACL1234C",
41
    "gst": "18AABCU9603R1ZM"
42
  },
43
  "apps": {
44
    "websites": [
45
      "https://www.acme.org"
46
    ],
47
    "android": [
48
      {
49
        "url": "playstore.acme.org",
50
        "name": "Acme"
51
      }
52
    ],
53
    "ios": [
54
      {
55
        "url": "appstore.acme.org",
56
        "name": "Acme"
57
      }
58
    ]
59
  },
60
  "brand": {
61
    "color": "#FFFFFF"
62
  },
63
  "contact_name": "Gaurav Kumar",
64
  "contact_info": {
65
    "chargeback": {
66
      "email": "cb@acme.org",
67
      "phone": "9000090000",
68
      "policy_url": "https://www.google.com"
69
    },
70
    "refund": {
71
      "email": "cb@acme.org",
72
      "phone": "9898989898",
73
      "policy_url": "https://www.google.com"
74
    },
75
    "support": {
76
      "email": "support@acme.org",
77
      "phone": "9898989898",
78
      "policy_url": "https://www.google.com"
79
    }
80
  }
81
}