Order Status API
This is a Server-to-Server API that takes orderid as a path parameter and returns the status of the order along with other details. For information on different order status and handling, refer here
API Latency Guideline
What is API Latency?
Time taken by the server to respond to the API request.
Average API Percentile Metrics and Recommended Timeout
TP50 (s): This means 50% of the requests have a latency less than or equal to this value. It represents the typical latency most users will experience.
TP90 (s): The latency at the 90th percentile. This indicates that 90% of the requests have a latency less than or equal to this value, with 10% experiencing higher latency.
TP99 (s): The latency at the 99th percentile. This indicates that 99% of the requests have a latency less than or equal to this value, with 1% experiencing higher latency.
TP99.9 (s): The latency at the 99.9th percentile. This is important for identifying edge cases, where 0.1% of the requests take significantly longer than the others.
TP99.99 (s): The latency at the 99.99th percentile. This captures extremely rare cases, where just 0.01% of the requests take longer than this time. Monitoring this helps in identifying and addressing the rarest and most severe performance issues.
|
Transaction Percentile
|
Latency (ms)
|
|---|---|
TP50 (ms)
| 0.0198
|
TP90 (ms)
| 55.71
|
TP99 (ms)
| 351.85
|
TP99.9 (ms)
| 594.42
|
Recommended Timeout
| 1000
|
The recommended timeouts are based on TP99.9 data, though edge cases (0.01% of requests) may still exceed these limits and are captured in the TP99.99 data as shown below.
|
Transaction Percentile
|
Latency (ms)
|
|---|---|
TP99.99 (ms)
| 1431.42
|
Recommended Timeout
| 2000
|
Consists of two parts.
Username: API Key obtained from Juspay dashboard
Password: Empty string
Example:-
MUQ2QUZEQzhFQTY0OUU5QTIxQzNFNTQwNkFDMEZCOg==
Merchant ID provided by Juspay
Pass the date in YYYY-MM-DD format
application/x-www-form-urlencoded
Unique ID generated by JusPay for the given order
OrderId provided in the request
Status of the order. For information on different order status and handling, refer here
Status ID is a numeric id corresponding to the status value
The order amount
Order creation timestamp in UTC
Example: 2021-11-09T16:19:55Z
The email Id of the customer provided during order creation
The phone number of the customer provided during order creation
The customer id provided during order creation
The merchant id provided by Juspay
The currency provided during order creation.
Default: INR
The return url provided during order creation
The product_id provided during order creation
The user defined fields passed during order creation. Empty in case not passed
Transaction ID for the payment attempt. Can be used as an identifier at PG end and will be present in reconciliation report.
The payment method type used for transaction. Possible values are CARD, NB, WALLET, UPI, CONSUMER_FINANCE
The payment method used for the transaction
Possible values THREE_DS, OTP, VIES
true if the order has been completely refunded
false for partial refunds or if the order doesn't have any refunds
Amount which has been refunded so far for the given order
The refund block with the details of refund initiated for the given order.
The unique request id provided during refund initiation
The status of the refund initiated. Initial status will always be PENDING
The flag denotes if the refund was initiated to gateway. The initial status is always false, as refunds are queued at juspay for a period of 15 minutes
The type of refund. Values can be STANDARD, INSTANT
The name of gateway from which amount is refunded
The refund id provided by the PG
The source of initiation
The reference id provided by PG, if not available then its mapped to unique request id.
The refund amount passed in the request
The timestamp of refund creation
The unique id generated by Juspay for a particular transaction. Can be used as an identifier in case of UPI transaction
The json object with the details of the transaction
The json object with the details receive from PG
The response code provided by the gateway
The bank reference number provided by the gateway
The transaction creation timestamp
Transaction Id from the underlying gateway
Auth code provided by the gateway for the transaction.
Transaction Id for the payment attempt
The response message provided by the gateway
The type of offer applied provided by the gateway( available only if offers are applied)
true if the offer is applied at the payment gateway. Else it will be false ( available only if offers are applied)
The discount amount provided by the gateway for the availed offer ( available only if offers are applied)
Gateway Id of the gateway used for performing this transactions
The gateway reference id used for the transaction
The json containing the details of the card used for the transaction
The expiry year of the card used for the transaction
A reference identifier for the card.
The expiry month of the card used for the transaction
true if card was saved to locker, else false
The name on card used for the transaction
Indicates the bank which issued the card
The last four digit of the card used
true if transaction was done via a saved card
false if transaction via new card/unsaved card
The unique identifier for the card
The first six digit of the card used for the transaction
Indicates if the card is either CREDIT or DEBIT
The provider of the card, can be VISA, RUPAY etc.
Bad Request
Details of keys missing
Example:-
Mandatory fields are missing
Further Details of keys missing
error
access_denied
error
Internal server Error