API Test keys

API Test keys

Create a Customer

POST
/v1/customers

Click to copy

Use this endpoint to create or add a customer with basic details such as name and contact details.

Is this page helpful?

Curl

change language

change language

1
curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
2
-X POST https://api.razorpay.com/v1/customers \
3
-H "Content-Type: application/json" \
4
-d '{
5
"name": "Gaurav Kumar",
6
"contact": "9123456780",
7
"email": "gaurav.kumar@example.com",
8
"fail_existing": "0",
9
"notes": {
10
"notes_key_1": "Tea, Earl Grey, Hot",
11
"notes_key_2": "Tea, Earl Grey… decaf."
12
}
13
}'

Success

Failure

1
{
2
"id" : "cust_1Aa00000000004",
3
"entity": "customer",
4
"name" : "Gaurav Kumar",
5
"email" : "gaurav.kumar@example.com",
6
"contact" : "9123456780",
7
"gstin": null,
8
"notes": {
9
"notes_key_1":"Tea, Earl Grey, Hot",
10
"notes_key_2":"Tea, Earl Grey… decaf."
11
},
12
"created_at ": 1234567890
13
}
Request Parameters
name
string

Customer's name. Alphanumeric value with period (.), apostrophe (') and parentheses are allowed. The name must be between 3-50 characters in length. For example, Gaurav Kumar.

contact
string

The customer's phone number. A maximum length of 15 characters including country code. For example, +919876543210.

email
string

The customer's email address. A maximum length of 64 characters. For example, gaurav.kumar@example.com.

fail_existing
string

Possible values:

  • 0: If a customer with the same details already exists, fetches details of the existing customer.
  • 1 (default): If a customer with the same details already exists, throws an error.

gstin
string

Customer's GST number, if available. For example, 29XAbbA4369J1PA.

notes
object

This is a key-value pair that can be used to store additional information about the entity. It can hold a maximum of 15 key-value pairs, 256 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

Response Parameters
id
string

Unique identifier of the customer. For example, cust_1Aa00000000004.

entity
string

Indicates the type of entity.

name
string

Customer's name. Alphanumeric, with period (.), apostrophe (') and parentheses allowed. The name must be between 3-50 characters in length. For example, Gaurav Kumar.

contact
string

The customer's phone number. A maximum length of 15 characters including country code. For example, +919876543210.

email
string

The customer's email address. A maximum length of 64 characters. For example, gaurav.kumar@example.com.

gstin
string

GST number linked to the customer. For example, 29XAbbA4369J1PA.

notes
object

This is a key-value pair that can be used to store additional information about the entity. It can hold a maximum of 15 key-value pairs, 256 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

created_at
integer

UNIX timestamp, when the customer was created. For example, 1234567890.

Errors

The API <key/secret> provided is invalid.

Error Status: 4xx

The API credentials passed in the API call differ from the ones generated on the Dashboard. Possible reasons:

  • Different keys for test mode and live modes.
  • Expired API key.

Solution

Contact number should be at least 8 digits, including country code.

Error Status: 400

The contact number is less than 8 digits.

Solution

Create a Customer

POST
/v1/customers

Click to copy

Use this endpoint to create or add a customer with basic details such as name and contact details.

Is this page helpful?

Request Parameters
name
string

Customer's name. Alphanumeric value with period (.), apostrophe (') and parentheses are allowed. The name must be between 3-50 characters in length. For example, Gaurav Kumar.

contact
string

The customer's phone number. A maximum length of 15 characters including country code. For example, +919876543210.

email
string

The customer's email address. A maximum length of 64 characters. For example, gaurav.kumar@example.com.

fail_existing
string

Possible values:

  • 0: If a customer with the same details already exists, fetches details of the existing customer.
  • 1 (default): If a customer with the same details already exists, throws an error.

gstin
string

Customer's GST number, if available. For example, 29XAbbA4369J1PA.

notes
object

This is a key-value pair that can be used to store additional information about the entity. It can hold a maximum of 15 key-value pairs, 256 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

Response Parameters
id
string

Unique identifier of the customer. For example, cust_1Aa00000000004.

entity
string

Indicates the type of entity.

name
string

Customer's name. Alphanumeric, with period (.), apostrophe (') and parentheses allowed. The name must be between 3-50 characters in length. For example, Gaurav Kumar.

contact
string

The customer's phone number. A maximum length of 15 characters including country code. For example, +919876543210.

email
string

The customer's email address. A maximum length of 64 characters. For example, gaurav.kumar@example.com.

gstin
string

GST number linked to the customer. For example, 29XAbbA4369J1PA.

notes
object

This is a key-value pair that can be used to store additional information about the entity. It can hold a maximum of 15 key-value pairs, 256 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

created_at
integer

UNIX timestamp, when the customer was created. For example, 1234567890.

Errors

The API <key/secret> provided is invalid.

Error Status: 4xx

The API credentials passed in the API call differ from the ones generated on the Dashboard. Possible reasons:

  • Different keys for test mode and live modes.
  • Expired API key.

Solution

Contact number should be at least 8 digits, including country code.

Error Status: 400

The contact number is less than 8 digits.

Solution

Curl

change language

change language

1
curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
2
-X POST https://api.razorpay.com/v1/customers \
3
-H "Content-Type: application/json" \
4
-d '{
5
"name": "Gaurav Kumar",
6
"contact": "9123456780",
7
"email": "gaurav.kumar@example.com",
8
"fail_existing": "0",
9
"notes": {
10
"notes_key_1": "Tea, Earl Grey, Hot",
11
"notes_key_2": "Tea, Earl Grey… decaf."
12
}
13
}'

Success

Failure

1
{
2
"id" : "cust_1Aa00000000004",
3
"entity": "customer",
4
"name" : "Gaurav Kumar",
5
"email" : "gaurav.kumar@example.com",
6
"contact" : "9123456780",
7
"gstin": null,
8
"notes": {
9
"notes_key_1":"Tea, Earl Grey, Hot",
10
"notes_key_2":"Tea, Earl Grey… decaf."
11
},
12
"created_at ": 1234567890
13
}