API Test Keys

Fetch a Product Configuration

GET

/v2/accounts/:account_id/products/:product_id

Click to copy

Use this endpoint to retrieve the details of a product for a given sub-merchant's account. Know about the

various error responses

for this API.

Is this page helpful?

Curl

change language

1curl -u <ACCESS_TOKEN> \
2- X GET https://api.razorpay.com/v2/accounts/acc_HQVlm3bnPmccC0/products/acc_prd_HEgNpywUFctQ9e/ \

PL Success

PG Success

1{
2  "requested_configuration": {
3    "payment_methods": []
4  },
5  "active_configuration": {
6    "payment_capture": {
7      "mode": "automatic",
8      "refund_speed": "normal",
9      "automatic_expiry_period": 7200
10    },
11    "settlements": {
12      "account_number": null,
13      "ifsc_code": null,
14      "beneficiary_name": null
15    },
16    "checkout": {
17      "theme_color": "#FFFFFF",
18      "flash_checkout": true
19    },
20    "refund": {
21      "default_refund_speed": "normal"
22    },
23    "notifications": {
24      "whatsapp": true,
25      "sms": false,
26      "email": [
27        "b963e252-1201-45b0-9c39-c53eceb0cfd6_load@gmail.com"
28      ]
29    },
30    "payment_methods": {
31      "netbanking": {
32        "enabled": true,
33        "instrument": [
34          {
35            "type": "retail",
36            "bank": [
37              "hdfc",
38              "sbin",
39              "utib",
40              "icic",
41              "scbl",
42              "yesb"
43            ]
44          }
45        ]
46      },
47      "wallet": {
48        "enabled": true,
49        "instrument": [
50          "airtelmoney",
51          "jiomoney",
52          "olamoney",
53          "payzapp",
54          "mobikwik"
55        ]
56      },
57      "upi": {
58        "enabled": true,
59        "instrument": [
60          "upi"
61        ]
62      }
63    }
64  },
65  "requirements": [
66    {
67      "field_reference": "individual_proof_of_address",
68      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/stakeholders/{stakeholderId}/documents",
69      "status": "required",
70      "reason_code": "document_missing"
71    },
72    {
73      "field_reference": "individual_proof_of_identification",
74      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/stakeholders/{stakeholderId}/documents",
75      "status": "required",
76      "reason_code": "document_missing"
77    },
78    {
79      "field_reference": "business_proof_of_identification",
80      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/documents",
81      "status": "required",
82      "reason_code": "document_missing"
83    },
84    {
85      "field_reference": "settlements.beneficiary_name",
86      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/products/acc_prd_HEgNpywUFctQ9f",
87      "status": "required",
88      "reason_code": "field_missing"
89    },
90    {
91      "field_reference": "settlements.account_number",
92      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/products/acc_prd_HEgNpywUFctQ9f",
93      "status": "required",
94      "reason_code": "field_missing"
95    },
96    {
97      "field_reference": "settlements.ifsc_code",
98      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/products/acc_prd_HEgNpywUFctQ9f",
99      "status": "required",
100      "reason_code": "field_missing"
101    },
102    {
103      "field_reference": "contact_name",
104      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0",
105      "status": "required",
106      "reason_code": "field_missing"
107    },
108    {
109      "field_reference": "name",
110      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/stakeholders",
111      "status": "required",
112      "reason_code": "field_missing"
113    },
114    {
115      "field_reference": "customer_facing_business_name",
116      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0",
117      "status": "required",
118      "reason_code": "field_missing"
119    },
120    {
121      "field_reference": "kyc.pan",
122      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/stakeholders",
123      "status": "required",
124      "reason_code": "field_missing"
125    }
126  ],
127  "tnc":{
128    "id": "tnc_IgohZaDBHRGjPv",
129    "accepted": true,
130    "accepted_at": 1641550798
131  },
132  "id": "acc_prd_HEgNpywUFctQ9f",
133  "account_id": "acc_HQVlm3bnPmccC0",
134  "product_name": "payment_links",
135  "activation_status": "needs_clarification",
136  "requested_at": 1625478849
137}

Path Parameters

account_id

string

The unique identifier of a sub-merchant account generated by Razorpay. For example, acc_HQVlm3bnPmccC0.

id

string

The unique identifier of a product generated by Razorpay. For example, acc_prd_HEgNpywUFctQ9e.

Response Parameters

id

string

The unique identifier of a product generated by Razorpay for a sub-merchant account. This id is used to fetch or update a product.

product_name

string

The product(s) to be configured. Possible values:

payment_gateway
payment_links

tnc

object

It consists of the configuration for the accepted terms and conditions by the merchant for the requested product. If the terms and conditions are accepted by the user for the requested product, it would consist of the following fields:

Show child parameters (3)

activation_status

string

The status of the

product activation

requested
needs_clarification
under_review
activated
suspended

configuration

object

The following are the possible configurations:

Show child parameters (6)

requested_configuration

object

The configuration of the product requested by the user that is yet to be set as active.

active_configuration

object

The configuration of the product that has been set as active.

requirements

object

The list of requirements to be enabled for this product or some of the configurations under this product.

Show child parameters (5)

requested_at

integer

The Unix timestamp at which the product configuration is requested.

Fetch a Product Configuration

GET

/v2/accounts/:account_id/products/:product_id

Click to copy

Use this endpoint to retrieve the details of a product for a given sub-merchant's 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 generated by Razorpay. For example, acc_HQVlm3bnPmccC0.

id

string

The unique identifier of a product generated by Razorpay. For example, acc_prd_HEgNpywUFctQ9e.

Response Parameters

id

string

The unique identifier of a product generated by Razorpay for a sub-merchant account. This id is used to fetch or update a product.

product_name

string

The product(s) to be configured. Possible values:

payment_gateway
payment_links

tnc

object

Show child parameters (3)

activation_status

string

The status of the

product activation

requested
needs_clarification
under_review
activated
suspended

configuration

object

The following are the possible configurations:

Show child parameters (6)

requested_configuration

object

The configuration of the product requested by the user that is yet to be set as active.

active_configuration

object

The configuration of the product that has been set as active.

requirements

object

The list of requirements to be enabled for this product or some of the configurations under this product.

Show child parameters (5)

requested_at

integer

The Unix timestamp at which the product configuration is requested.

Curl

change language

1curl -u <ACCESS_TOKEN> \
2- X GET https://api.razorpay.com/v2/accounts/acc_HQVlm3bnPmccC0/products/acc_prd_HEgNpywUFctQ9e/ \

PL Success

PG Success

1{
2  "requested_configuration": {
3    "payment_methods": []
4  },
5  "active_configuration": {
6    "payment_capture": {
7      "mode": "automatic",
8      "refund_speed": "normal",
9      "automatic_expiry_period": 7200
10    },
11    "settlements": {
12      "account_number": null,
13      "ifsc_code": null,
14      "beneficiary_name": null
15    },
16    "checkout": {
17      "theme_color": "#FFFFFF",
18      "flash_checkout": true
19    },
20    "refund": {
21      "default_refund_speed": "normal"
22    },
23    "notifications": {
24      "whatsapp": true,
25      "sms": false,
26      "email": [
27        "b963e252-1201-45b0-9c39-c53eceb0cfd6_load@gmail.com"
28      ]
29    },
30    "payment_methods": {
31      "netbanking": {
32        "enabled": true,
33        "instrument": [
34          {
35            "type": "retail",
36            "bank": [
37              "hdfc",
38              "sbin",
39              "utib",
40              "icic",
41              "scbl",
42              "yesb"
43            ]
44          }
45        ]
46      },
47      "wallet": {
48        "enabled": true,
49        "instrument": [
50          "airtelmoney",
51          "jiomoney",
52          "olamoney",
53          "payzapp",
54          "mobikwik"
55        ]
56      },
57      "upi": {
58        "enabled": true,
59        "instrument": [
60          "upi"
61        ]
62      }
63    }
64  },
65  "requirements": [
66    {
67      "field_reference": "individual_proof_of_address",
68      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/stakeholders/{stakeholderId}/documents",
69      "status": "required",
70      "reason_code": "document_missing"
71    },
72    {
73      "field_reference": "individual_proof_of_identification",
74      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/stakeholders/{stakeholderId}/documents",
75      "status": "required",
76      "reason_code": "document_missing"
77    },
78    {
79      "field_reference": "business_proof_of_identification",
80      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/documents",
81      "status": "required",
82      "reason_code": "document_missing"
83    },
84    {
85      "field_reference": "settlements.beneficiary_name",
86      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/products/acc_prd_HEgNpywUFctQ9f",
87      "status": "required",
88      "reason_code": "field_missing"
89    },
90    {
91      "field_reference": "settlements.account_number",
92      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/products/acc_prd_HEgNpywUFctQ9f",
93      "status": "required",
94      "reason_code": "field_missing"
95    },
96    {
97      "field_reference": "settlements.ifsc_code",
98      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/products/acc_prd_HEgNpywUFctQ9f",
99      "status": "required",
100      "reason_code": "field_missing"
101    },
102    {
103      "field_reference": "contact_name",
104      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0",
105      "status": "required",
106      "reason_code": "field_missing"
107    },
108    {
109      "field_reference": "name",
110      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/stakeholders",
111      "status": "required",
112      "reason_code": "field_missing"
113    },
114    {
115      "field_reference": "customer_facing_business_name",
116      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0",
117      "status": "required",
118      "reason_code": "field_missing"
119    },
120    {
121      "field_reference": "kyc.pan",
122      "resolution_url": "/accounts/acc_HQVlm3bnPmccC0/stakeholders",
123      "status": "required",
124      "reason_code": "field_missing"
125    }
126  ],
127  "tnc":{
128    "id": "tnc_IgohZaDBHRGjPv",
129    "accepted": true,
130    "accepted_at": 1641550798
131  },
132  "id": "acc_prd_HEgNpywUFctQ9f",
133  "account_id": "acc_HQVlm3bnPmccC0",
134  "product_name": "payment_links",
135  "activation_status": "needs_clarification",
136  "requested_at": 1625478849
137}