Get Started
Integration FAQs
Essentials
Calculations
Transactions
Transactions
Create Refunds
Add a refund to a transaction
POST
/
tax
/
refunds
curl --request POST \
--url https://api.numeralhq.com/tax/refunds \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"transaction_id": "tr_123456789",
"type": "partial",
"refund_processed_at": 1714787673,
"line_items": [
{
"reference_product_id": "p-1233543",
"reference_line_item_id": "line_123456789",
"sales_amount_refunded": -200,
"quantity": 2,
"tax_amount_refunded": -14
}
]
}'
{
"id": "ref_tr_123456789",
"object": "tax.refund",
"refund_type": "partial",
"testmode": "false",
"refund_processed_at": 1714787673,
"line_items": [
{
"product": {
"reference_product_name": "Widget",
"reference_line_item_id": "line_987654321",
"reference_product_id": "p-1233543",
"product_tax_code": "GENERAL_MERCHANDISE"
},
"tax_jurisdictions": [
{
"tax_rate": 0.07,
"rate_type": "STATE SALES TAX",
"jurisdiction_name": "Indiana",
"fee_amount": 0
}
],
"quantity": 2,
"tax_amount": -14,
"amount_excluding_tax": -200,
"amount_including_tax": -214
}
]
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
Response
200
application/json
Refund response
The response is of type object
.
curl --request POST \
--url https://api.numeralhq.com/tax/refunds \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"transaction_id": "tr_123456789",
"type": "partial",
"refund_processed_at": 1714787673,
"line_items": [
{
"reference_product_id": "p-1233543",
"reference_line_item_id": "line_123456789",
"sales_amount_refunded": -200,
"quantity": 2,
"tax_amount_refunded": -14
}
]
}'
{
"id": "ref_tr_123456789",
"object": "tax.refund",
"refund_type": "partial",
"testmode": "false",
"refund_processed_at": 1714787673,
"line_items": [
{
"product": {
"reference_product_name": "Widget",
"reference_line_item_id": "line_987654321",
"reference_product_id": "p-1233543",
"product_tax_code": "GENERAL_MERCHANDISE"
},
"tax_jurisdictions": [
{
"tax_rate": 0.07,
"rate_type": "STATE SALES TAX",
"jurisdiction_name": "Indiana",
"fee_amount": 0
}
],
"quantity": 2,
"tax_amount": -14,
"amount_excluding_tax": -200,
"amount_including_tax": -214
}
]
}
Assistant
Responses are generated using AI and may contain mistakes.