curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET]
-X GET https://api.razorpay.com/v1/disputes \
-H "Content-Type: application/json"
RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");
Dispute dispute = instance.dispute.fetchAll();
import razorpay
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))
client.dispute.all()
$api = new Api($key_id, $secret);
$api->dispute->all();
RazorpayClient client = new RazorpayClient(your_key_id, your_secret);
List<Dispute> disputes = client.Dispute.All();
require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')
Razorpay::Dispute.all()
var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })
var options = {
count: 1
}
instance.disputes.all(options)
import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")
body, err := client.Dispute.All(nil, nil)
razorpay disputes list
# With filters
razorpay disputes list --count 10 --skip 0 --from 1609459200 --to 1612137600
{
"entity": "collection",
"count": 2,
"items": [
{
"id": "disp_Esz7KAitoYM7PJ",
"entity": "dispute",
"payment_id": "pay_EsyWjHrfzb59eR",
"amount": 10000,
"currency": "SGD",
"amount_deducted": 0,
"reason_code": "pre_arbitration",
"respond_by": 1590604200,
"status": "open",
"phase": "pre_arbitration",
"created_at": 1590059211,
"evidence": {
"amount": 10000,
"summary": null,
"shipping_proof": null,
"billing_proof": null,
"cancellation_proof": null,
"customer_communication": null,
"proof_of_service": null,
"explanation_letter": null,
"refund_confirmation": null,
"access_activity_log": null,
"refund_cancellation_policy": null,
"term_and_conditions": null,
"others": null,
"submitted_at": null
}
},
{
"id": "disp_Esyvk3kZj0isXk",
"entity": "dispute",
"payment_id": "pay_EsyWjHrfzb59eR",
"amount": 5000,
"currency": "SGD",
"amount_deducted": 0,
"reason_code": "warning_bulletin_or_exception_file",
"respond_by": 1590604200,
"status": "won",
"phase": "chargeback",
"created_at": 1590058554,
"evidence": {
"amount": 5000,
"summary": null,
"shipping_proof": [
"doc_EFtmUsbwpXwBH9",
"doc_EFtmUsbwpXwBH8"
],
"billing_proof": null,
"cancellation_proof": null,
"customer_communication": null,
"proof_of_service": null,
"explanation_letter": null,
"refund_confirmation": null,
"access_activity_log": null,
"refund_cancellation_policy": null,
"term_and_conditions": null,
"others": null,
"submitted_at": 1590604100
}
}
]
}
{
"status_code":400,
"success":false,
"errors":[
"Value of each expand must be one of following types: payment, transaction.settlement",
"Status Code: 400"
]
}
Refunds
Fetch All Disputes
Fetch all Disputes using Razorpay Disputes API.
GET
/
v1
/
disputes
curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET]
-X GET https://api.razorpay.com/v1/disputes \
-H "Content-Type: application/json"
RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");
Dispute dispute = instance.dispute.fetchAll();
import razorpay
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))
client.dispute.all()
$api = new Api($key_id, $secret);
$api->dispute->all();
RazorpayClient client = new RazorpayClient(your_key_id, your_secret);
List<Dispute> disputes = client.Dispute.All();
require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')
Razorpay::Dispute.all()
var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })
var options = {
count: 1
}
instance.disputes.all(options)
import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")
body, err := client.Dispute.All(nil, nil)
razorpay disputes list
# With filters
razorpay disputes list --count 10 --skip 0 --from 1609459200 --to 1612137600
{
"entity": "collection",
"count": 2,
"items": [
{
"id": "disp_Esz7KAitoYM7PJ",
"entity": "dispute",
"payment_id": "pay_EsyWjHrfzb59eR",
"amount": 10000,
"currency": "SGD",
"amount_deducted": 0,
"reason_code": "pre_arbitration",
"respond_by": 1590604200,
"status": "open",
"phase": "pre_arbitration",
"created_at": 1590059211,
"evidence": {
"amount": 10000,
"summary": null,
"shipping_proof": null,
"billing_proof": null,
"cancellation_proof": null,
"customer_communication": null,
"proof_of_service": null,
"explanation_letter": null,
"refund_confirmation": null,
"access_activity_log": null,
"refund_cancellation_policy": null,
"term_and_conditions": null,
"others": null,
"submitted_at": null
}
},
{
"id": "disp_Esyvk3kZj0isXk",
"entity": "dispute",
"payment_id": "pay_EsyWjHrfzb59eR",
"amount": 5000,
"currency": "SGD",
"amount_deducted": 0,
"reason_code": "warning_bulletin_or_exception_file",
"respond_by": 1590604200,
"status": "won",
"phase": "chargeback",
"created_at": 1590058554,
"evidence": {
"amount": 5000,
"summary": null,
"shipping_proof": [
"doc_EFtmUsbwpXwBH9",
"doc_EFtmUsbwpXwBH8"
],
"billing_proof": null,
"cancellation_proof": null,
"customer_communication": null,
"proof_of_service": null,
"explanation_letter": null,
"refund_confirmation": null,
"access_activity_log": null,
"refund_cancellation_policy": null,
"term_and_conditions": null,
"others": null,
"submitted_at": 1590604100
}
}
]
}
{
"status_code":400,
"success":false,
"errors":[
"Value of each expand must be one of following types: payment, transaction.settlement",
"Status Code: 400"
]
}
Available in🇮🇳 India🇲🇾 Malaysia🇸🇬 Singapore🇺🇸 United States
Use this endpoint to retrieve all the disputes raised by your customers.
curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET]
-X GET https://api.razorpay.com/v1/disputes \
-H "Content-Type: application/json"
RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");
Dispute dispute = instance.dispute.fetchAll();
import razorpay
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))
client.dispute.all()
$api = new Api($key_id, $secret);
$api->dispute->all();
RazorpayClient client = new RazorpayClient(your_key_id, your_secret);
List<Dispute> disputes = client.Dispute.All();
require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')
Razorpay::Dispute.all()
var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })
var options = {
count: 1
}
instance.disputes.all(options)
import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")
body, err := client.Dispute.All(nil, nil)
razorpay disputes list
# With filters
razorpay disputes list --count 10 --skip 0 --from 1609459200 --to 1612137600
{
"entity": "collection",
"count": 2,
"items": [
{
"id": "disp_Esz7KAitoYM7PJ",
"entity": "dispute",
"payment_id": "pay_EsyWjHrfzb59eR",
"amount": 10000,
"currency": "SGD",
"amount_deducted": 0,
"reason_code": "pre_arbitration",
"respond_by": 1590604200,
"status": "open",
"phase": "pre_arbitration",
"created_at": 1590059211,
"evidence": {
"amount": 10000,
"summary": null,
"shipping_proof": null,
"billing_proof": null,
"cancellation_proof": null,
"customer_communication": null,
"proof_of_service": null,
"explanation_letter": null,
"refund_confirmation": null,
"access_activity_log": null,
"refund_cancellation_policy": null,
"term_and_conditions": null,
"others": null,
"submitted_at": null
}
},
{
"id": "disp_Esyvk3kZj0isXk",
"entity": "dispute",
"payment_id": "pay_EsyWjHrfzb59eR",
"amount": 5000,
"currency": "SGD",
"amount_deducted": 0,
"reason_code": "warning_bulletin_or_exception_file",
"respond_by": 1590604200,
"status": "won",
"phase": "chargeback",
"created_at": 1590058554,
"evidence": {
"amount": 5000,
"summary": null,
"shipping_proof": [
"doc_EFtmUsbwpXwBH9",
"doc_EFtmUsbwpXwBH8"
],
"billing_proof": null,
"cancellation_proof": null,
"customer_communication": null,
"proof_of_service": null,
"explanation_letter": null,
"refund_confirmation": null,
"access_activity_log": null,
"refund_cancellation_policy": null,
"term_and_conditions": null,
"others": null,
"submitted_at": 1590604100
}
}
]
}
{
"status_code":400,
"success":false,
"errors":[
"Value of each expand must be one of following types: payment, transaction.settlement",
"Status Code: 400"
]
}
Response Parameters
string
The unique identifier of the dispute generated by Razorpay. For example,
disp_AHfqOvkldwsbqt.string
Indicates the type of entity. In this case, it is
dispute.string
The unique identifier of the payment against which the dispute was created. For example,
pay_EsyWjHrfzb59eR.integer
Amount, in currency subunits, for which the dispute was created.
string
3-letter ISO currency code associated with the amount. Check the list of supported currencies.
integer
The amount, in currency subunits, deducted from your Razorpay current balance when the dispute is
lost. This amount will be 0 unless the status of dispute is updated to lost. Know about the different states of disputes.string
Code associated with the reason for the dispute.
string
A brief description of the reason for dispute.
integer
Unix timestamp by which a response should be sent to the customer.
string
The status of the dispute. Possible statuses are:
open: Indicates that the dispute has been created.under_review: Indicates that the issuing bank is reviewing the dispute.won: Indicates that the bank has accepted the remedial documents, and you have won the chargeback.lost: Indicates that the bank did not accept the remedial documents, and you have lost the chargeback.closed: Indicates that the fraudulent transaction was closed after you provided either the transaction details or made a refund to the customer.
string
Phase associated with the dispute. Possible phases are:
fraud: A dispute raised by the bank when it suspects a transaction to be fraudulent based on the risk analysis.retrieval: A request initiated by the customer with their issuer bank for additional information about a transaction.chargeback: A refund claim initiated by the customers with their issuer banks. In such cases, the bank starts an official inquiry.pre_arbitration: A chargeback that you have won is challenged by the customer for the second time.arbitration: A chargeback that you have won is challenged for a third time by the customer and the card networks directly getting involved.
integer
Unix timestamp when the dispute was created.
object
Provides details of the evidence submitted/saved for contesting a dispute. Use the Documents API to securely share documents with Razorpay.
integer
The contested amount in currency subunits, for which evidence is provided. The value can vary from
0 to the dispute amount. The default value is the dispute amount.string
The explanation provided by you for contesting the dispute. It can have a maximum length of 1000 characters.
list
List of document ids which serves as proof that the product was shipped to the customer at their provided address. It should show their complete shipping address, if possible.
list
List of document ids which serves as proof of order confirmation, such as a receipt.
list
List of document ids that serves as proof that this product/service was cancelled.
list
List of document ids listing any written/email communication from the customer confirming that the customer received the product/service or is satisfied with the product/service.
list
List of document ids showing proof of service provided to the customer.
list
(List of document ids) Any letter(s) from you specifying information pertinent to the dispute/payment that needs to be considered for processing the dispute.
list
List of document ids showing proof that the refund had been provided to the customer.
list
List of document ids of any server or activity logs which prove that the customer accessed or downloaded the purchased digital product.
list
List of document ids listing your refund and/or cancellation policy, as shown to the customer.
list
List of document ids listing your sales terms and conditions, as shown to the customer.
list
Specifies the evidence documents to be uploaded as a part of contesting a dispute. It is a list of tuples consisting of the following:
string
Describes the custom type of evidence document(s) provided.
list
List of document ids corresponding to the customer evidence type.
Example
[
{
"type": "receipt_signed_by_customer",
"document_ids": [
"doc_EFtmUsbwpXwBH7",
"doc_EFtmUsbwpXwBH6"
]
}
]
integer
Unix timestamp when the dispute was last submitted by you (for review) to Razorpay. The default value is
null.Errors
The api key provided is invalid
The api key provided is invalid
Code:
401This error occurs when there is a mismatch between the API credentials passed in the API call and the API credentials generated on the Dashboard.Solution: Make sure the API Keys are active and entered correctly. Also, there should not be any whitespaces before or after the keys.Value of each expand must be one of following types: payment, transaction.settlement
Value of each expand must be one of following types: payment, transaction.settlement
Code:
400The value of the expand query parameter is neither payments nor transaction.settlement.Solution: Pass the expand query parameter value as either payments or transaction.settlement.Was this page helpful?