API Test Keys

Create an Account

POST

/v2/accounts

Click to copy

Use this endpoint to create an account.

Is this page helpful?

Curl

change language

1curl -u <ACCESS_TOKEN> \
2-H "Content-Type: application/json" \
3-X POST https://api.razorpay.com/v2/accounts \
4-d '{
5  "email": "gauriagain.kumar@example.org",
6  "phone": "9000090000",
7  "legal_business_name": "Acme Corp",
8  "business_type": "partnership",
9  "customer_facing_business_name": "Example",
10  "profile": {
11    "category": "healthcare",
12    "subcategory": "clinic",
13    "description": "Healthcare E-commerce platform",
14    "addresses": {
15      "operation": {
16        "street1": "507, Koramangala 6th block",
17        "street2": "Kormanagala",
18        "city": "Bengaluru",
19        "state": "Karnataka",
20        "postal_code": 560047,
21        "country": "IN"
22      },
23      "registered": {
24        "street1": "507, Koramangala 1st block",
25        "street2": "MG Road",
26        "city": "Bengaluru",
27        "state": "Karnataka",
28        "postal_code": 560034,
29        "country": "IN"
30      }
31    },
32    "business_model": "Online Clothing ( men, women, ethnic, modern ) fashion and lifestyle, accessories, t-shirt, shirt, track pant, shoes."
33  },
34  "legal_info": {
35    "pan": "AAACL1234C",
36    "gst": "18AABCU9603R1ZM"
37  },
38  "brand": {
39    "color": "FFFFFF"
40  },
41  "notes": {
42    "internal_ref_id": "123123"
43  },
44  "contact_name": "Gaurav Kumar",
45  "contact_info": {
46    "chargeback": {
47      "email": "cb@example.org"
48    },
49    "refund": {
50      "email": "cb@example.org"
51    },
52    "support": {
53      "email": "support@example.org",
54      "phone": "9999999998",
55      "policy_url": "https://www.google.com"
56    }
57  },
58  "apps": {
59    "websites": [
60      "https://www.example.org"
61    ],
62    "android": [
63      {
64        "url": "playstore.example.org",
65        "name": "Example"
66      }
67    ],
68    "ios": [
69      {
70        "url": "appstore.example.org",
71        "name": "Example"
72      }
73    ]
74  }
75}'

Success

1{
2  "id": "acc_GRWKk7qQsLnDjX",
3  "type": "standard",
4  "status": "created",
5  "email": "gauriagain.kumar@example.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 6th block",
20        "street2": "Kormanagalo",
21        "city": "Bengaluru",
22        "state": "KARNATAKA",
23        "country": "IN",
24        "postal_code": 560047
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": 1611136837,
33  "phone": "9000090000",
34  "business_type": "partnership",
35  "legal_business_name": "Acme Corp",
36  "customer_facing_business_name": "Example",
37  "legal_info": {
38    "pan": "AAACL1234C",
39    "gst": "18AABCU9603R1ZM"
40  },
41  "apps": {
42    "websites": [
43      "https://www.example.org"
44    ],
45    "android": [
46      {
47        "url": "playstore.example.org",
48        "name": "Example"
49      }
50    ],
51    "ios": [
52      {
53        "url": "appstore.example.org",
54        "name": "Example"
55      }
56    ]
57  },
58  "brand": {
59    "color": "#FFFFFF"
60  },
61  "contact_info": {
62    "chargeback": {
63      "email": "cb@example.org",
64      "phone": null,
65      "policy_url": null
66    },
67    "refund": {
68      "email": "cb@example.org",
69      "phone": null,
70      "policy_url": null
71    },
72    "support": {
73      "email": "support@example.org",
74      "phone": "9999999998",
75      "policy_url": "https://www.google.com"
76    }
77  }
78}

Request Parameters

email

string

The sub-merchant's business email address.

phone

integer

The sub-merchant's business phone number, without the country code. The minimum length is 8 characters and the maximum length is 15. For example, 9876543210.

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 Dashboard. The minimum length is 1 character and the maximum length is 255.

business_type

string

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

Business Types

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 website/app details of the sub-merchant's business.

Show child parameters (3)

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. Possible values:

created: Account status when the merchant account is created.
activated: Account status when the merchant KYC is approved.
needs_clarification: Account status when the merchant is asked to provide clarifications related to the KYC details submitted.
under_review: Account status when the merchant submits all the KYC requirements.
suspended: Account status when the merchant account is identified as potentially fraudulent and is suspended.
rejected: Account status when the KYC details submitted by the merchant are rejected during manual review.

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 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

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.

Create an Account

POST

/v2/accounts

Click to copy

Use this endpoint to create an account.

Is this page helpful?

Request Parameters

email

string

The sub-merchant's business email address.

phone

integer

The sub-merchant's business phone number, without the country code. The minimum length is 8 characters and the maximum length is 15. For example, 9876543210.

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 Dashboard. The minimum length is 1 character and the maximum length is 255.

business_type

string

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

Business Types

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 website/app details of the sub-merchant's business.

Show child parameters (3)

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. Possible values:

created: Account status when the merchant account is created.
activated: Account status when the merchant KYC is approved.
needs_clarification: Account status when the merchant is asked to provide clarifications related to the KYC details submitted.
under_review: Account status when the merchant submits all the KYC requirements.
suspended: Account status when the merchant account is identified as potentially fraudulent and is suspended.
rejected: Account status when the KYC details submitted by the merchant are rejected during manual review.

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

business_type

string

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

Business Types

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

1curl -u <ACCESS_TOKEN> \
2-H "Content-Type: application/json" \
3-X POST https://api.razorpay.com/v2/accounts \
4-d '{
5  "email": "gauriagain.kumar@example.org",
6  "phone": "9000090000",
7  "legal_business_name": "Acme Corp",
8  "business_type": "partnership",
9  "customer_facing_business_name": "Example",
10  "profile": {
11    "category": "healthcare",
12    "subcategory": "clinic",
13    "description": "Healthcare E-commerce platform",
14    "addresses": {
15      "operation": {
16        "street1": "507, Koramangala 6th block",
17        "street2": "Kormanagala",
18        "city": "Bengaluru",
19        "state": "Karnataka",
20        "postal_code": 560047,
21        "country": "IN"
22      },
23      "registered": {
24        "street1": "507, Koramangala 1st block",
25        "street2": "MG Road",
26        "city": "Bengaluru",
27        "state": "Karnataka",
28        "postal_code": 560034,
29        "country": "IN"
30      }
31    },
32    "business_model": "Online Clothing ( men, women, ethnic, modern ) fashion and lifestyle, accessories, t-shirt, shirt, track pant, shoes."
33  },
34  "legal_info": {
35    "pan": "AAACL1234C",
36    "gst": "18AABCU9603R1ZM"
37  },
38  "brand": {
39    "color": "FFFFFF"
40  },
41  "notes": {
42    "internal_ref_id": "123123"
43  },
44  "contact_name": "Gaurav Kumar",
45  "contact_info": {
46    "chargeback": {
47      "email": "cb@example.org"
48    },
49    "refund": {
50      "email": "cb@example.org"
51    },
52    "support": {
53      "email": "support@example.org",
54      "phone": "9999999998",
55      "policy_url": "https://www.google.com"
56    }
57  },
58  "apps": {
59    "websites": [
60      "https://www.example.org"
61    ],
62    "android": [
63      {
64        "url": "playstore.example.org",
65        "name": "Example"
66      }
67    ],
68    "ios": [
69      {
70        "url": "appstore.example.org",
71        "name": "Example"
72      }
73    ]
74  }
75}'

Success

1{
2  "id": "acc_GRWKk7qQsLnDjX",
3  "type": "standard",
4  "status": "created",
5  "email": "gauriagain.kumar@example.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 6th block",
20        "street2": "Kormanagalo",
21        "city": "Bengaluru",
22        "state": "KARNATAKA",
23        "country": "IN",
24        "postal_code": 560047
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": 1611136837,
33  "phone": "9000090000",
34  "business_type": "partnership",
35  "legal_business_name": "Acme Corp",
36  "customer_facing_business_name": "Example",
37  "legal_info": {
38    "pan": "AAACL1234C",
39    "gst": "18AABCU9603R1ZM"
40  },
41  "apps": {
42    "websites": [
43      "https://www.example.org"
44    ],
45    "android": [
46      {
47        "url": "playstore.example.org",
48        "name": "Example"
49      }
50    ],
51    "ios": [
52      {
53        "url": "appstore.example.org",
54        "name": "Example"
55      }
56    ]
57  },
58  "brand": {
59    "color": "#FFFFFF"
60  },
61  "contact_info": {
62    "chargeback": {
63      "email": "cb@example.org",
64      "phone": null,
65      "policy_url": null
66    },
67    "refund": {
68      "email": "cb@example.org",
69      "phone": null,
70      "policy_url": null
71    },
72    "support": {
73      "email": "support@example.org",
74      "phone": "9999999998",
75      "policy_url": "https://www.google.com"
76    }
77  }
78}