API's for the diamond industry

Transaction API - Initiation

Overview: Automate your order placement on IDEX for one or more diamonds.

Input Parameters

Note: you must use a valid Api Key that provides access to this service.
Parameter Details Format Mandatory
api_key Your API key, for example "HNNSSA1223311" String Yes
api_secret Your API secret, for example "DDccdaaedf123" String Yes
diamonds diamond_id, numeric, mandatory
customer_name, string, optional
notes, string, optional
sales_person, string, optional
Object Array Yes
branch_id Branch ID for delivery. For example 54312
Integer Yes
total_cost Total amount to pay, including shipping. This will be verified before finalizing the order. Decimal Yes
shipping_method The shipping method you choose. Can be "standard" or "expedited" String Yes
mode The mode is to allow testing. This can be "test" or "live". Test transactions won't be placed, you will receive a fictitious transaction number in response. String Yes

Sample Request

HTTP JSON
Endpoint: https://api.idexonline.com/transactionapi/api/v3.0/initiate
{
	"authentication_details":{
		"api_key":"HNNSSA1223311",
		"api_secret":"DDccdaaedf123"
	},
	"parameters":{
		"diamonds": [
			{
				"diamond_id": 389254754, 
				"customer_name": "John Grisham"  
				"notes": "your note for later"  
				"sales_person": "Michael"  
			},
			{
				"diamond_id": 389254750, 
				"notes":"for Jane."  
			}
		],
		"branch_id": 2489 ,
		"total_cost": 1872.64,
		"shipping_method": "standard",
		"mode": "test"
	}
}

Sample Success Response

JSON Data
If all goes well, the HTTP code will be 200 and the JSON will contain a "response_code" with value 0
{
  "result_info": {
	"response_code": 0,
	"response_description": ""
  },
  "results": {
	"place_order_success": true,
	"transaction_id": 66543
  }
}

Sample Error Response

JSON Data
In case of an exception, either the HTTP code will be 500 or the error message will be displayed in this format:
{
    "result_info": {
        "response_code": 32110,
        "response_description": "A description of the exception."
    }
}

Error Codes

Common error codes
51001
Missing authentication section in JSON
51002
Missing api_key
51003
Missing api_secret
52101
Api Secret does not match Api Key (authentication failed)
52201
Not authorized
52202
Not authorized to buy.
51299
Specific parameter missing (details in message)
53101
Unrecognized value (details in message)
53203
Validation failed (details in message)
53206
One or more diamonds not available
53207
Pricing mismatch, include all fees in total.
53208
That's not your branch
53209
No shipping route found for shipping method for that destination.

Go to the test page







© IDEX 2025, www.idexonline.com