Node.js
import Shoply from "@shoplygg/node";
const shoply = new Shoply({ apiKey: process.env.SHOPLY_API_KEY });
const result = await shoply.disputes.forOrder("ORDER_ID");<?php
require 'vendor/autoload.php';
$shoply = new Shoply\Client(['apiKey' => getenv('SHOPLY_API_KEY')]);
$result = $shoply->disputes->forOrder('ORDER_ID');
import shoply
client = shoply.Client() # reads SHOPLY_API_KEY
result = client.disputes.forOrder("ORDER_ID")
curl --request GET \
--url https://api.shoply.gg/v1/stores/{storeId}/orders/{orderId}/disputes \
--header 'Authorization: Bearer <token>'package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.shoply.gg/v1/stores/{storeId}/orders/{orderId}/disputes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.shoply.gg/v1/stores/{storeId}/orders/{orderId}/disputes")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.shoply.gg/v1/stores/{storeId}/orders/{orderId}/disputes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": null,
"code": null,
"data": [
{
"id": "ae36fc25-3cea-4d17-acaa-4bdb43d84a0e",
"orderId": "71ed606f-3119-4f9f-b7f7-ecd25740e15b",
"email": "mila@example.com",
"provider": "stripe",
"providerName": "Stripe",
"externalId": "dp_1QdZ8x2eZvKYlo2C",
"reason": "fraudulent",
"reasonText": "Says they did not make the payment",
"stage": "chargeback",
"providerStatus": "needs_response",
"status": "needs_response",
"amount": 49,
"currency": "USD",
"dueAt": "2026-10-27T16:20:19Z",
"answer": {
"state": "",
"at": null,
"by": "",
"note": ""
},
"answeredFrom": "provider",
"answerPlace": "your Stripe Dashboard",
"accessTaken": false,
"dateCreated": "2026-10-22T16:20:19Z",
"dateClosed": null
}
]
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}Disputes
List an order's disputes
The disputes on one order, newest first, each as List disputes has it. Most orders have none; a payment disputed twice has two.
Needs the disputes.read permission (Read Disputes).
GET
/
stores
/
{storeId}
/
orders
/
{orderId}
/
disputes
Node.js
import Shoply from "@shoplygg/node";
const shoply = new Shoply({ apiKey: process.env.SHOPLY_API_KEY });
const result = await shoply.disputes.forOrder("ORDER_ID");<?php
require 'vendor/autoload.php';
$shoply = new Shoply\Client(['apiKey' => getenv('SHOPLY_API_KEY')]);
$result = $shoply->disputes->forOrder('ORDER_ID');
import shoply
client = shoply.Client() # reads SHOPLY_API_KEY
result = client.disputes.forOrder("ORDER_ID")
curl --request GET \
--url https://api.shoply.gg/v1/stores/{storeId}/orders/{orderId}/disputes \
--header 'Authorization: Bearer <token>'package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.shoply.gg/v1/stores/{storeId}/orders/{orderId}/disputes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.shoply.gg/v1/stores/{storeId}/orders/{orderId}/disputes")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.shoply.gg/v1/stores/{storeId}/orders/{orderId}/disputes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": null,
"code": null,
"data": [
{
"id": "ae36fc25-3cea-4d17-acaa-4bdb43d84a0e",
"orderId": "71ed606f-3119-4f9f-b7f7-ecd25740e15b",
"email": "mila@example.com",
"provider": "stripe",
"providerName": "Stripe",
"externalId": "dp_1QdZ8x2eZvKYlo2C",
"reason": "fraudulent",
"reasonText": "Says they did not make the payment",
"stage": "chargeback",
"providerStatus": "needs_response",
"status": "needs_response",
"amount": 49,
"currency": "USD",
"dueAt": "2026-10-27T16:20:19Z",
"answer": {
"state": "",
"at": null,
"by": "",
"note": ""
},
"answeredFrom": "provider",
"answerPlace": "your Stripe Dashboard",
"accessTaken": false,
"dateCreated": "2026-10-22T16:20:19Z",
"dateClosed": null
}
]
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}Authorizations
A secret API key, made under Developers in the dashboard: Authorization: Bearer shoply_sk_...
Path Parameters
The store's ID. A key reaches the store it was made in: GET /key answers which.
The order, by its ID.

