Body
Refund Order API
Create a refund for an Order. Refunds can be initiated only for transactions that are CHARGED. The response of refund initiation is similar to that of order status API Response with the addition of refund block.
Request
Response
API Endpoints
Production Link
POST
https://api.juspay.in/orders/{order_id}/refunds
Authorization Header
Basic Auth
*
Base64 Encoded Username:Password
Mandatory
Consists of two parts.
Username: API Key obtained from Juspay dashboard
Password: Empty string
Example:-
Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==
Headers
version
*
string
Required
Pass the current date in YYYY-MM-DD format
Content-Type
*
string
Required
application/x-www-form-urlencoded
x-merchantid
*
string
Required
The merchant_id/username that you hold at Juspay
Request Schema: application/json
Parameters
unique_request_id
*
string
Required
Request ID that uniquely identifies this request. You cannot reuse the value for two different refund requests. This is to avoid processing duplicate refund requests.The length of the unique_request_id should be less than 21 characters
amount
*
Double
Required
Amount that has to be refunded. Amount has to be less than or equal to the amount of the order that is not yet refunded. If this parameter is not passed, then the order is refunded entirely
200 : Success
Response Body
udf1-10
string
txn_uuid
string
eulwh5QbZSBvwpt7333f3
txn_id
string
merchant_success-JP1636474794-1
txn_detail
object
txn_uuid
string
eulwh5QbZSBvwpt7333f3
txn_id
string
merchant_success-JP1636474794-1
txn_amount
integer
tax_amount
null
surcharge_amount
null
status
string
redirect
boolean
order_id
string
JP1636474794
net_amount
integer
gateway_id
integer
gateway
string
RAZORPAY
express_checkout
boolean
error_message
string
error_code
string
currency
string
INR
created
string
2021-11-09T16:20:52Z
status_id
integer
status
string
CHARGED
rewards_breakup
String
return_url
string
refunds
array of Objects
object
object
unique_request_id
String
The unique request id that is passed during refund initiation. Do not pass any special characters.
status
String
The status of the refund initiated. Initial status will always be PENDING
sent_to_gateway
String
The flag denotes if the refund was initiated to gateway. The initial status is always false, as refunds are queued at juspay for a max of 15minutes.
refund_type
String
The type of refund. Values can be STANDARD, INSTANT
refund_source
String
The name of gateway
ref
String
The refund id provided by the PG
initiated_by
String
The source of initiation.
id
String
The reference id provided by PG, if not available then its mapped to unique request id.
error_message
String
The error message provided by the PG
error_code
String
The error code provided by the PG
created
String
The refund amount passed in the request
amount
integer
The timestamp of refund creation
refunded
boolean
product_id
string
payment_method_type
string
payment_method
string
payment_links
object
web
string
https://api.juspay.in/merchant/pay/ordeh_57dfd768bb7d4896bc0c3f30bc9ad77
mobile
string
https://api.juspay.in/merchant/pay/ordeh_57dfd768bb7d4896bc0c3f30bc9ad77?mobile=true
iframe
string
https://api.juspay.in/merchant/ipay/ordeh_57dfd768bb7d4896bc0c3f30bc9ad77
payment_gateway_response
object
txn_id
string
merchant_success-JP1636474794-1
rrn
string
156555
resp_message
string
SUCCESS
resp_code
string
SUCCESS
epg_txn_id
string
pay_IJZKtTpkiYWE24
created
string
2021-11-09T16:21:11Z
auth_id_code
string
156555
order_id
string
JP1636474794
offers
array
metadata
object
RAZORPAY:gateway_reference_id
string
testmid
merchant_id
string
merchant_success
id
string
ordeh_57dfd768bb7d4896bc0c3f30bc9ad77
gateway_reference_id
string
testmid
gateway_id
integer
effective_amount
integer
date_created
string
2021-11-09T16:19:55Z
customer_phone
string
9999999999
customer_id
string
testcardenc1
customer_email
string
test@gmail.com
currency
string
INR
card
object
using_token
boolean
using_saved_card
boolean
saved_to_locker
boolean
name_on_card
string
last_four_digits
string
expiry_year
string
2024
expiry_month
string
12
card_type
string
CREDIT
card_reference
string
17a2ec4f27c918ttvbc58c9ae74090e
card_issuer
string
JP Morgan
card_isin
string
411111
card_fingerprint
string
32qqi3svf5t5t37fq7ura2rgqqb
card_brand
string
VISA
bank_pg
null
bank_error_message
string
bank_error_code
string
auth_type
string
THREE_DS
amount_refunded
integer
amount
integer
400 : Invalid Input data
Response Body
Duplicate unique_request_id
JSON
status
String
ERROR
error_code
String
duplicate.call
error_message
String
A refund call was already completed with this unique_request_id for the order.
Duplicate Refund Request within 5 seconds
JSON
status
String
ERROR
error_code
String
duplicate.call
error_message
String
A refund call was already processing with this amount for the order.
Refund amount greater than refundable
JSON
status
String
ERROR
error_code
String
invalid.amount.exceeded
error_message
String
Refund amount exceeds the refundable amount.
Amount/unique_request_id not passed
JSON
status
String
Bad Request
error_code
String
Mandatory fields are missing
error_message
String
Mandatory fields are missing
Refund Amount is 0
JSON
status
String
ERROR
error_code
String
invalid amount
error_message
String
Amount is invalid
Invalid Order id
JSON
status
String
NOT_FOUND
status_id
String
40
order_id
String
66721145_keexeV8cNyb7DrYzs
Unsuccessful order
JSON
status
String
ERROR
error_code
String
invalid.order.not_successful
error_message
String
Cannot process unsuccessful order
Refund limit exceeds
String
25 refunds per order is the default limit
status
String
ERROR
error_code
String
request.exceeded
error_message
String
Refund create exceeded the limit
401 : Authentication Failed
Response Body
status
String
error
error_code
String
access_denied