Order बनाएँ (generic - e-Stamp सहित किसी भी entitled serviceCode के लिए)
Endpoint
POST /v1/orders
POST
/v1/ordersScope orders.createAPI शुल्क ₹5 से शुरूलाइवGeneric order-creation endpoint। e-Stamp के लिए e-Stamp serviceCode (GET /v1/services से) दें और instrument/party/value का विवरण free-form details object में रखें। अभी e-Stamp का कोई विशेष request/response contract नहीं है (state, article, parties[] जैसे first-class fields नहीं हैं) - e-Stamp के लिए details का shape upstream में अभी final नहीं है।
Request
Request के parameters
| Field | Type | विवरण |
|---|---|---|
Authorizationज़रूरी | header | Bearer <api-key> (जैसे sandbox में sk_test_..., production में sk_live_...)। x-api-key header भी स्वीकार किया जाता है। |
Idempotency-Key | header | वैकल्पिक idempotency key। |
externalOrderIdज़रूरी | string | इस order के लिए आपका अपना reference। |
externalCustomerIdज़रूरी | string | Customer के लिए आपका अपना reference। |
serviceCodeज़रूरी | string | जिस entitled service का order देना है (जैसे कोई estamp.* code)। |
details | object | Service-specific free-form payload (e-Stamp field shape अभी final नहीं है)। |
उदाहरण
Call करके देखें
curl -X POST "https://api-b2b.stampmitra.in/v1/orders" \
-H "Authorization: Bearer sk_test_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"externalOrderId":"ord_ext_123","externalCustomerId":"cust_ext_456","serviceCode":"estamp.instrument.rent_agreement","details":{"state":"MH","stampValue":500,"note":"Shape not finalized - illustrative only"}}'Playground
Try करें
Response
Response का उदाहरण
ResponseJSON
{
"externalOrderId": "ord_ext_123",
"createdAt": "2026-10-15T09:41:07.000Z",
"serviceCode": "estamp.instrument.rent_agreement"
}| Field | Type |
|---|---|
externalOrderId | string |
createdAt | string |
serviceCode | string |