For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
Help CenterSign Up
GuidesAPI Reference
GuidesAPI Reference
  • Sales Tax API
    • GETHealth
      • POSTRefund order
  • Management API
    • API Disclaimer
Help CenterSign Up
Sales Tax APIRefunds

Refund order

POST
https://api.v3.taxcloud.com/tax/connections/:connectionId/orders/refunds/:orderId
POST
/tax/connections/:connectionId/orders/refunds/:orderId
$curl -X POST https://api.v3.taxcloud.com/tax/connections/25eb9b97-5acb-492d-b720-c03e79cf715a/orders/refunds/orderId \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{}'
1[
2  {
3    "connectionId": "25eb9b97-5acb-492d-b720-c03e79cf715a",
4    "items": [
5      {
6        "index": 1,
7        "itemId": "string",
8        "price": 1.1,
9        "quantity": 1.1,
10        "tax": {
11          "amount": 1.1
12        },
13        "tic": 0
14      }
15    ],
16    "batchId": "string",
17    "createdDate": "2024-01-15T09:30:00Z",
18    "returnedDate": "2024-01-15T09:30:00Z"
19  }
20]
Create a refund against an order. Multiple refunds are supported, but the total refunded quantity cannot exceed the original order quantity for each item. IMPORTANT: Refund prices and tax amounts are automatically calculated from the order. If the order had discounts applied, refunds will reflect the discounted prices (the actual amount paid). Do not send price or tax fields in the refund request - only itemId and quantity are required.
Was this page helpful?
Previous

Ping

Next
Built with

Create a refund against an order. Multiple refunds are supported, but the total refunded quantity cannot exceed the original order quantity for each item. IMPORTANT: Refund prices and tax amounts are automatically calculated from the order. If the order had discounts applied, refunds will reflect the discounted prices (the actual amount paid). Do not send price or tax fields in the refund request - only itemId and quantity are required.

Authentication

AuthorizationBearer
This authentication type can be used to directly call the service.
OR
X-API-KEYstring
This authentication type is supported by using the provided API key for the merchant account.

Path parameters

connectionIdstringRequired>=36 characters
represents the ID of a connection. It is used as a unique identifier for the connection
orderIdstringRequired
the id of the order to refund against

Request

This endpoint expects an object.
batchIdstringOptional
Optional batch ID for grouping refunds
itemslist of objectsOptional

represents the items of the refund request, if an empty lists or no lists is passed it is assumed the entire order will be refunded. IMPORTANT: Prices and tax amounts are automatically calculated from the order. If the order had discounts, refunds will use the discounted prices (actual amount paid).

returnedDatestring or nullOptionalformat: "date-time"

include only if this return is a change to a previously filed sales tax return, will trigger an Amended Sales Tax Return. (Not typically recommended to include.)

Response

Created
connectionIdstring>=36 characters
represents the ID of a connection. It is used as a unique identifier for the connection
itemslist of objects
batchIdstring
Batch ID for grouping refunds
createdDatestringformat: "date-time"
represents the time when the refund was created.
returnedDatestringformat: "date-time"
represents the time when the refund took effect.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error