Skip to main content
The refund endpoint handles both full and partial refunds for completed transactions. When you submit a refund, the engine performs a rounding normalization check: it verifies that the refund’s rounding delta correctly mirrors the direction of the original transaction’s rounding. This prevents scenarios where a customer is refunded a rounded amount that doesn’t correspond to what they originally paid. The refund is committed to the audit hash chain as a separate record linked to the original transaction ID.

​
Endpoint

​
Authentication

​
string
required
Your merchant or partner API key.

​
Request body

​
string
required
The ID of the transaction being refunded.
​
integer
required
Refund amount in cents. For a full refund, pass the original cash_total_cents. For a partial refund, pass the partial amount.
​
string
required
Reason code for the refund. One of: defective_product, customer_dissatisfied, wrong_item, price_adjustment.
​
string
required
The employee ID of the person processing the refund.

​
Example

If the normalization check detects that the refund rounding delta does not correctly reverse the original transaction’s direction, the failure is flagged in the response and logged to the audit trail — but the refund is not blocked. Review flagged refunds in the void analytics and compliance reports.