Search terminal refunds
POST
/v2/terminals/refunds/search
Retrieves a filtered list of Interac Terminal refund requests created by the seller making the request.
| Name | Description |
|---|---|
query
|
Queries the Terminal refunds based on given conditions and the sort order. Calling
|
cursor
|
A pagination cursor returned by a previous call to this endpoint. Provide this cursor to retrieve the next set of results for the original query. |
limit
|
Limits the number of results returned for a single request. |
Response Fields
| Name | Description |
|---|---|
errors
|
Information about errors encountered during the request. |
refunds
|
The requested search result of |
cursor
|
The pagination cursor to be used in a subsequent request. If empty, this is the final response. See Pagination for more information. |
Examples
POST
/v2/terminals/refunds/search
cURL
- cURL
- Ruby
- Python
- C#
- Java
- PHP
- Node.js
curl https://connect.squareup.com/v2/terminals/refunds/search \
-X POST \
-H 'Square-Version: 2021-05-13' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"limit": 1,
"query": {
"filter": {
"status": "COMPLETED"
}
}
}'
Response JSON
{
"refunds": [
{
"id": "009DP5HD-5O5OvgkcNUhl7JBuINflcjKqUzXZY",
"refund_id": "5O5OvgkcNUhl7JBuINflcjKqUzXZY_43Q4iGp7sNeATiWrUruA1EYeMRUXaddXXlDDJ1EQLvb",
"payment_id": "5O5OvgkcNUhl7JBuINflcjKqUzXZY",
"amount_money": {
"amount": 111,
"currency": "CAD"
},
"reason": "Returning item",
"device_id": "f72dfb8e-4d65-4e56-aade-ec3fb8d33291",
"deadline_duration": "PT5M",
"status": "COMPLETED",
"created_at": "2020-09-29T15:21:46.771Z",
"updated_at": "2020-09-29T15:21:48.675Z",
"app_id": "sandbox-sq0idb-c2OuYt13YaCAeJq_2cd8OQ",
"card": {
"card_brand": "INTERAC",
"last_4": "1111",
"exp_month": 1,
"exp_year": 2022,
"fingerprint": "sq-1-B1fP9MNNmZgVVaPKRND6oDKYbz25S2cTvg9Mzwg3RMTK1zT1PiGRT-AE3nTA8vSmmw",
"card_type": "CREDIT",
"bin": "411111"
},
"order_id": "kcuKDKreRaI4gF4TjmEgZjHk8Z7YY",
"location_id": "76C9W6K8CNNQ5"
}
]
}