Class PaymentSummary
java.lang.Object
com.broadleafcommerce.cart.service.messaging.event.PaymentSummary
- All Implemented Interfaces:
Serializable
The domain that summarizes the current state of transactions against the payment.
- Author:
- Dima Myroniuk (dmyroniuk)
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected boolean
boolean
The list of restrictions that apply to payment access.The collection of related addresses that may include billing or shipping addressesjavax.money.MonetaryAmount
The payment's adjustments (a.k.a discounts) total, usually excluding shipping/fulfillment discounts.javax.money.MonetaryAmount
The amount for which this payment is allotted.javax.money.MonetaryAmount
The total authorized amount for capture.javax.money.MonetaryAmount
The total captured amount.javax.money.MonetaryAmount
The total detached credit amount.javax.money.MonetaryAmount
The total refunded amount.General use map to capture any additional attributes needed for this Paymentjavax.money.MonetaryAmount
The total amount sent to the payment gateway for capture, and is waiting for a response about the transaction result.General use map to capture any display properties for this Paymentjavax.money.MonetaryAmount
The payment's total fulfillment costThe gateway used to process this payment.getName()
The name of this payment.The id of this payment.javax.money.MonetaryAmount
The payment's total usually excluding adjustments, tax, and shipping.javax.money.MonetaryAmount
The payment's total tax costgetType()
The type of this payment like Credit Card or Gift Card.The version of this payment.int
hashCode()
boolean
Whether or not the underlying payment method can only be used once.void
setAccessRestrictions
(List<String> accessRestrictions) The list of restrictions that apply to payment access.void
setAddressByType
(Map<String, com.broadleafcommerce.order.common.domain.Address> addressByType) The collection of related addresses that may include billing or shipping addressesvoid
setAdjustmentsTotal
(javax.money.MonetaryAmount adjustmentsTotal) The payment's adjustments (a.k.a discounts) total, usually excluding shipping/fulfillment discounts.void
setAmount
(javax.money.MonetaryAmount amount) The amount for which this payment is allotted.void
setAmountAuthorized
(javax.money.MonetaryAmount amountAuthorized) The total authorized amount for capture.void
setAmountCaptured
(javax.money.MonetaryAmount amountCaptured) The total captured amount.void
setAmountCredited
(javax.money.MonetaryAmount amountCredited) The total detached credit amount.void
setAmountRefunded
(javax.money.MonetaryAmount amountRefunded) The total refunded amount.void
setAttributes
(Map<String, String> attributes) General use map to capture any additional attributes needed for this Paymentvoid
setCaptureAmountAwaitingResult
(javax.money.MonetaryAmount captureAmountAwaitingResult) The total amount sent to the payment gateway for capture, and is waiting for a response about the transaction result.void
setDisplayAttributes
(Map<String, String> displayAttributes) General use map to capture any display properties for this Paymentvoid
setFulfillmentTotal
(javax.money.MonetaryAmount fulfillmentTotal) The payment's total fulfillment costvoid
setGatewayType
(String gatewayType) The gateway used to process this payment.void
The name of this payment.void
setPaymentId
(String paymentId) The id of this payment.void
setSingleUsePaymentMethod
(boolean isSingleUsePaymentMethod) Whether or not the underlying payment method can only be used once.void
setSubtotal
(javax.money.MonetaryAmount subtotal) The payment's total usually excluding adjustments, tax, and shipping.void
setTaxTotal
(javax.money.MonetaryAmount taxTotal) The payment's total tax costvoid
The type of this payment like Credit Card or Gift Card.void
setVersion
(Integer version) The version of this payment.toString()
-
Constructor Details
-
PaymentSummary
public PaymentSummary()
-
-
Method Details
-
getPaymentId
The id of this payment.- Returns:
- The id of this payment.
-
getName
The name of this payment. This name is typically something like "Visa ending in 1234".- Returns:
- The name of this payment.
-
getType
The type of this payment like Credit Card or Gift Card.- Returns:
- The type of this payment like Credit Card or Gift Card.
-
getGatewayType
The gateway used to process this payment. Only a SINGLE payment gateway can modify transactions on a particular payment.- Returns:
- The gateway used to process this payment.
-
getAddressByType
The collection of related addresses that may include billing or shipping addresses- Returns:
- The collection of related addresses
-
getAttributes
General use map to capture any additional attributes needed for this Payment- Returns:
- General use map to capture any additional attributes needed for this Payment
-
getDisplayAttributes
General use map to capture any display properties for this Payment- Returns:
- General use map to capture any display properties for this Payment
-
isSingleUsePaymentMethod
public boolean isSingleUsePaymentMethod()Whether or not the underlying payment method can only be used once. In most cases, we're managing a single-use token that represents a credit card. This flag is especially important for managing payments with successful transactions. In those cases, the token has already been used and cannot be reused. If we need modify the payment's amount, then we may actually need to archive the existing payment, and create a new payment, with a new underlying token. Additionally, this flag is helpful when needing to re-authorize an expired authorization transaction. In that case, if the payment represents a single-use payment method, then the re-authorization may not be possible, and you'll need to seek an alternative form of payment.- Returns:
- Whether or not the underlying payment method can only be used once
-
getAmount
public javax.money.MonetaryAmount getAmount()The amount for which this payment is allotted. The summation of all of the payments for a particular cart should equal the cart's total. If specified, the amount details (subtotal
,adjustmentsTotal
,fulfillmentTotal
, &taxTotal
) should sum together to equal this amount.- Returns:
- The amount for which this payment is allotted.
-
getSubtotal
public javax.money.MonetaryAmount getSubtotal()The payment's total usually excluding adjustments, tax, and shipping.- Returns:
- The payment's total usually excluding adjustments, tax, and shipping.
-
getAdjustmentsTotal
public javax.money.MonetaryAmount getAdjustmentsTotal()The payment's adjustments (a.k.a discounts) total, usually excluding shipping/fulfillment discounts.- Returns:
- The payment's adjustments (a.k.a discounts) total, usually excluding shipping/fulfillment discounts.
-
getFulfillmentTotal
public javax.money.MonetaryAmount getFulfillmentTotal()The payment's total fulfillment cost- Returns:
- The payment's total fulfillment cost
-
getTaxTotal
public javax.money.MonetaryAmount getTaxTotal()The payment's total tax cost- Returns:
- The payment's total tax cost
-
getAmountAuthorized
public javax.money.MonetaryAmount getAmountAuthorized()The total authorized amount for capture. This value is calculated as "total authorized - total reverse-authed".- Returns:
- the total authorized amount for capture
-
getAmountCaptured
public javax.money.MonetaryAmount getAmountCaptured()The total captured amount. This value is calculated as "total captured - total refunded - total voided".- Returns:
- the total captured amount
-
getAmountRefunded
public javax.money.MonetaryAmount getAmountRefunded()The total refunded amount.- Returns:
- the total refunded amount
-
getAmountCredited
public javax.money.MonetaryAmount getAmountCredited()The total detached credit amount.- Returns:
- the total detached credit amount
-
getCaptureAmountAwaitingResult
public javax.money.MonetaryAmount getCaptureAmountAwaitingResult()The total amount sent to the payment gateway for capture, and is waiting for a response about the transaction result.This value should only be present for payment gateways that support asynchronous transaction executions.
- Returns:
- the total amount sent to the payment gateway for capture and is waiting for a response about the transaction result
-
getVersion
The version of this payment. Used for checking that the requested version of the payment is up-to-date before saving changes. Required for any request which results in an update being made to the payment. This should never be manually incremented/decremented. -
getAccessRestrictions
The list of restrictions that apply to payment access.- Returns:
- the list of restrictions that apply to payment access
-
setPaymentId
The id of this payment.- Parameters:
id
- The id of this payment.
-
setName
The name of this payment. This name is typically something like "Visa ending in 1234".- Parameters:
name
- The name of this payment.
-
setType
The type of this payment like Credit Card or Gift Card.- Parameters:
type
- The type of this payment like Credit Card or Gift Card.
-
setGatewayType
The gateway used to process this payment. Only a SINGLE payment gateway can modify transactions on a particular payment.- Parameters:
gatewayType
- The gateway used to process this payment.
-
setAddressByType
public void setAddressByType(Map<String, com.broadleafcommerce.order.common.domain.Address> addressByType) The collection of related addresses that may include billing or shipping addresses- Parameters:
addressByType
- The collection of related addresses
-
setAttributes
General use map to capture any additional attributes needed for this Payment- Parameters:
attributes
- General use map to capture any additional attributes needed for this Payment
-
setDisplayAttributes
General use map to capture any display properties for this Payment- Parameters:
displayAttributes
- General use map to capture any display properties for this Payment
-
setSingleUsePaymentMethod
public void setSingleUsePaymentMethod(boolean isSingleUsePaymentMethod) Whether or not the underlying payment method can only be used once. In most cases, we're managing a single-use token that represents a credit card. This flag is especially important for managing payments with successful transactions. In those cases, the token has already been used and cannot be reused. If we need modify the payment's amount, then we may actually need to archive the existing payment, and create a new payment, with a new underlying token. Additionally, this flag is helpful when needing to re-authorize an expired authorization transaction. In that case, if the payment represents a single-use payment method, then the re-authorization may not be possible, and you'll need to seek an alternative form of payment.- Parameters:
isSingleUsePaymentMethod
- Whether or not the underlying payment method can only be used once
-
setAmount
public void setAmount(javax.money.MonetaryAmount amount) The amount for which this payment is allotted. The summation of all of the payments for a particular cart should equal the cart's total. If specified, the amount details (subtotal
,adjustmentsTotal
,fulfillmentTotal
, &taxTotal
) should sum together to equal this amount.- Parameters:
amount
- The amount for which this payment is allotted.
-
setSubtotal
public void setSubtotal(javax.money.MonetaryAmount subtotal) The payment's total usually excluding adjustments, tax, and shipping. -
setAdjustmentsTotal
public void setAdjustmentsTotal(javax.money.MonetaryAmount adjustmentsTotal) The payment's adjustments (a.k.a discounts) total, usually excluding shipping/fulfillment discounts. -
setFulfillmentTotal
public void setFulfillmentTotal(javax.money.MonetaryAmount fulfillmentTotal) The payment's total fulfillment cost -
setTaxTotal
public void setTaxTotal(javax.money.MonetaryAmount taxTotal) The payment's total tax cost -
setAmountAuthorized
public void setAmountAuthorized(javax.money.MonetaryAmount amountAuthorized) The total authorized amount for capture. This value is calculated as "total authorized - total reverse-authed".- Parameters:
amountAuthorized
- the total authorized amount for capture
-
setAmountCaptured
public void setAmountCaptured(javax.money.MonetaryAmount amountCaptured) The total captured amount. This value is calculated as "total captured - total refunded - total voided".- Parameters:
amountCaptured
- the total captured amount
-
setAmountRefunded
public void setAmountRefunded(javax.money.MonetaryAmount amountRefunded) The total refunded amount.- Parameters:
amountRefunded
- the total refunded amount
-
setAmountCredited
public void setAmountCredited(javax.money.MonetaryAmount amountCredited) The total detached credit amount.- Parameters:
amountCredited
- the total detached credit amount
-
setCaptureAmountAwaitingResult
public void setCaptureAmountAwaitingResult(javax.money.MonetaryAmount captureAmountAwaitingResult) The total amount sent to the payment gateway for capture, and is waiting for a response about the transaction result.This value should only be present for payment gateways that support asynchronous transaction executions.
- Parameters:
captureAmountAwaitingResult
- the total amount sent to the payment gateway for capture and is waiting for a response about the transaction result
-
setVersion
The version of this payment. Used for checking that the requested version of the payment is up-to-date before saving changes. Required for any request which results in an update being made to the payment. This should never be manually incremented/decremented. -
setAccessRestrictions
The list of restrictions that apply to payment access.- Parameters:
accessRestrictions
- the list of restrictions that apply to payment access
-
equals
-
canEqual
-
hashCode
public int hashCode() -
toString
-