org.broadleafcommerce.core.payment.service

Class OrderToPaymentRequestDTOServiceImpl

java.lang.Object

org.broadleafcommerce.core.payment.service.OrderToPaymentRequestDTOServiceImpl

All Implemented Interfaces:

OrderToPaymentRequestDTOService

@Service(value="blOrderToPaymentRequestDTOService")
public class OrderToPaymentRequestDTOServiceImpl
extends Object
implements OrderToPaymentRequestDTOService

Author:

Elbert Bautista (elbertbautista)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	OrderToPaymentRequestDTOServiceImpl.NameResponse

Field Summary

Fields

Modifier and Type	Field and Description
protected FulfillmentGroupService	fgService
static String	ZERO_TOTAL

Constructor Summary

Constructors

Constructor and Description
OrderToPaymentRequestDTOServiceImpl()

Method Summary

Modifier and Type	Method and Description
protected OrderToPaymentRequestDTOServiceImpl.NameResponse	getName(Address address)
void	populateBillTo(Order order, PaymentRequestDTO requestDTO)
void	populateCustomerInfo(Order order, PaymentRequestDTO requestDTO)
void	populateDefaultLineItemsAndSubtotal(Order order, PaymentRequestDTO requestDTO) IMPORTANT:
void	populateShipTo(Order order, PaymentRequestDTO requestDTO) Uses the first shippable fulfillment group to populate the PaymentRequestDTO.shipTo() object
void	populateTotals(Order order, PaymentRequestDTO requestDTO)
PaymentRequestDTO	translateOrder(Order order) This translates an Order of PaymentType.CREDIT_CARD into a PaymentRequestDTO.
PaymentRequestDTO	translatePaymentTransaction(Money transactionAmount, PaymentTransaction paymentTransaction) Utilizes the PaymentTransaction.getAdditionalFields() map to populate necessary request parameters on the resulting PaymentRequestDTO.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ZERO_TOTAL

public static final String ZERO_TOTAL

See Also:

Constant Field Values

fgService

protected FulfillmentGroupService fgService

Constructor Detail

OrderToPaymentRequestDTOServiceImpl

public OrderToPaymentRequestDTOServiceImpl()

Method Detail

translateOrder

public PaymentRequestDTO translateOrder(Order order)

Description copied from interface: OrderToPaymentRequestDTOService

This translates an Order of PaymentType.CREDIT_CARD into a PaymentRequestDTO. This method assumes that this translation will apply to a final payment which means that the transaction amount for the returned PaymentRequestDTO will be Order.getTotalAfterAppliedPayments() It assumes that all other payments (e.g. gift cards/account credit) have already been applied to the Order.

Specified by:

translateOrder in interface OrderToPaymentRequestDTOService

Parameters:

order - the Order to be translated

Returns:

a PaymentRequestDTO based on the properties of order. This will only utilize the payments that are of type PaymentType.CREDIT_CARD

translatePaymentTransaction

public PaymentRequestDTO translatePaymentTransaction(Money transactionAmount,
                                                     PaymentTransaction paymentTransaction)

Description copied from interface: OrderToPaymentRequestDTOService

Utilizes the PaymentTransaction.getAdditionalFields() map to populate necessary request parameters on the resulting PaymentRequestDTO. These additional fields are then used by the payment gateway to construct additional requests to the payment gateway. For instance, this might be use to refund or void the given paymentTransaction

Specified by:

translatePaymentTransaction in interface OrderToPaymentRequestDTOService

Parameters:

transactionAmount - the amount that should be placed on PaymentRequestDTO.getTransactionTotal()

paymentTransaction - the transaction whose additional fields should be placed on PaymentRequestDTO.getAdditionalFields() for the gateway to use

Returns:

a new PaymentRequestDTO populated with the additional fields from paymentTransaction and the amount from transactionAmount

populateTotals

public void populateTotals(Order order,
                           PaymentRequestDTO requestDTO)

Specified by:

populateTotals in interface OrderToPaymentRequestDTOService

populateCustomerInfo

public void populateCustomerInfo(Order order,
                                 PaymentRequestDTO requestDTO)

Specified by:

populateCustomerInfo in interface OrderToPaymentRequestDTOService

populateShipTo

public void populateShipTo(Order order,
                           PaymentRequestDTO requestDTO)

Uses the first shippable fulfillment group to populate the PaymentRequestDTO.shipTo() object

Specified by:

populateShipTo in interface OrderToPaymentRequestDTOService

Parameters:

order - the Order to get data from

requestDTO - the PaymentRequestDTO that should be populated

See Also:

FulfillmentGroupService#getFirstShippableFulfillmentGroup(Order)}

populateBillTo

public void populateBillTo(Order order,
                           PaymentRequestDTO requestDTO)

Specified by:

populateBillTo in interface OrderToPaymentRequestDTOService

getName

protected OrderToPaymentRequestDTOServiceImpl.NameResponse getName(Address address)

populateDefaultLineItemsAndSubtotal

public void populateDefaultLineItemsAndSubtotal(Order order,
                                                PaymentRequestDTO requestDTO)

IMPORTANT:

If you would like to pass Line Item information to a payment gateway so that it shows up on the hosted site, you will need to override this method and construct line items to conform to the requirements of that particular gateway:

For Example: The Paypal Express Checkout NVP API validates that the order subtotal that you pass in, add up to the amount of the line items that you pass in. So, In that case you will need to take into account any additional fees, promotions, credits, gift cards, etc... that are applied to the payment and add them as additional line items with a negative amount when necessary.

Each gateway that accepts line item information may require you to construct this differently. Please consult the module documentation on how it should be properly constructed.

In this default implementation, just the subtotal is set, without any line item details.

Specified by:

populateDefaultLineItemsAndSubtotal in interface OrderToPaymentRequestDTOService

Parameters:

order -

requestDTO -