# ReceiptAmountSummaryDto

A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.

DTO for transaction amount information displayed on a receipt.

## Fields
- `subtotal` (number(double)): Subtotal (base amount before tax and tip), in the transaction currency. (nullable)
- `tax` (number(double)): Tax amount, in the transaction currency. (nullable)
- `tip` (number(double)): Tip/gratuity amount, in the transaction currency. (nullable)
- `shipping` (number(double)): Shipping amount, in the transaction currency. Null / zero when no shipping amount was collected, in which case no shipping line is rendered. (nullable)
- `total` (number(double)): Total transaction amount, in the transaction currency. (nullable)
- `approvedAmount` (number(double)): Approved amount, in the transaction currency (may differ from total for partial approvals). (nullable)
- `isPartialApproval` (boolean): Whether the approval was partial.
- `requestedAmount` (number(double)): The amount requested from the card issuer, in the transaction currency. Present on a partial approval receipt, where it is printed beside `approvedAmount`, and on a split tender summary, where it is the order total. Null on every other receipt. (nullable)
- `remainingBalanceAfterApproval` (number(double)): What a partial approval left unpaid on this card: `requestedAmount` minus `approvedAmount`, never negative. On a split tender summary, what the group as a whole left unpaid. In the transaction currency. Null whenever `requestedAmount` is null. (nullable)
- `currencyCode` (string): ISO 4217 currency code (e.g. "USD"). (nullable)
- `cashBack` (number(double)): Cash back (debit) or cash over (Discover credit) amount, in the transaction currency. Printed on Discover credit and debit receipts, where the processor's receipt rules require it. (nullable)
- `transactionFee` (number(double)): Transaction fee assessed (e.g. PIN debit fees), in the transaction currency. Included when provided by the processor. (nullable)
- `availableBalance` (number(double)): Available balance remaining after the transaction, in the transaction currency. Included when provided by the processor (credit, debit, EBT, prepaid). (nullable)
- `convenienceFee` (number(double)): Convenience fee assessed on the transaction, in the transaction currency. Null / zero when no convenience fee applies, in which case no fee line is rendered. (nullable)
- `convenienceFeeBilledSeparately` (boolean): True when the convenience fee was submitted as its own separately-authorized charge rather than being included in this transaction's `total`. The fee line is then rendered with a "billed as a separate charge" qualifier so the total still reconciles.
- `surcharge` (number(double)): Surcharge amount assessed on the transaction, in the transaction currency. Present only when the gateway computed and applied a surcharge; null otherwise (a non-surcharged transaction shows no surcharge line). (nullable)
- `surchargeRate` (number(double)): The surcharge rate applied to produce `surcharge`, as a decimal fraction (e.g. 0.03 for 3%). (nullable)
- `surchargeReversed` (number(double)): Surcharge amount reversed back to the cardholder on a refund / reversal receipt, in the transaction currency. Null / zero on non-refund receipts. (nullable)
- `cashPrice` (number(double)): For a merchant that posts a cash price and a card price, the cash price of this payment, in the transaction currency: its base amount. Present, with `cardPrice`, only when the payment was charged one of the two posted prices; null otherwise, and the receipt then prints its ordinary subtotal. (nullable)
- `cardPrice` (number(double)): For a merchant that posts a cash price and a card price, the card price of this payment, in the transaction currency: the cash price plus the merchant's card rate. On a card payment it is the price charged; on a cash or bank payment it is the price the payer did not pay. Null when the payment was not dual priced. (nullable)
- `cashDiscountAmount` (number(double)): The discount a payment charged the cash price received, in the transaction currency: `cardPrice` minus `cashPrice`. Present only on a cash payment, or a bank payment the merchant treats as cash; null on a card payment and when the payment was not dual priced. (nullable)
- `cashDiscountForBankPayment` (boolean): True when `cashDiscountAmount` was received by a bank payment rather than cash. False whenever no cash discount applies.
- `cardPriceReversed` (number(double)): The share of the card price returned to the payer on a void, reversal or refund of a payment charged the card price, in the transaction currency. Not printed as a row of its own: the refunded total already includes it. Null when nothing of a card price was returned. (nullable)

## See also

- [All documentation](https://devportal.signapay-sbx.winkpg.io/llms.txt): the machine-readable index of every public page on this site.