Idempotency

BillDesk APIs supports idempotency for safely identifying requests without accidentally initiating the same request twice. The idempotency logic is applicable on all Create APIs.

The idempotency logic is on BD-Traceid and clientid combination and in case a duplicate BD-Traceid request for the same clientid is received an error block is returned as :

{
    "status": 409,
    "error_type": "duplicate_request_error",
    "error_code": "TRDRE0001",
    "message": "Transaction already exists with given mercid and orderid"
}

📘

Note

Note that the orderid should be unique for each transaction request.

To get the latest status of the request, the Retrieve APIs can be invoked with mercid and orderid combination, and the response payload will have the current status (success, failure, pending) with corresponding desc.

List of APIs where idempotency is maintained and its corresponding retrieve API is mentioned below: