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
Use order.status as the main and highest-priority payment status. It is the only field that represents the overall state of the order.
txn_detail.status, refunds[].status, and chargeback.status are entity-specific statuses. They describe the state of the transaction, refund, and chargeback entities respectively and cannot override the overall payment status.
Final payment status cannot be derived solely from txn, refund, or chargeback statuses.
If a transaction request times out, first call the Order Status API to check if the payment is already in progress (PENDING_VBV or CHARGED) before deciding to retry, preventing accidental double charges.
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: BRL
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 and CASH.
The payment method used for the transaction.
You may refer to this doc for possible values for payment_method.
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
Have questions?
- Need help? Contact support
- LLM? Read llms.txt