com.broadleafcommerce.paymentgateway.service

Interface PaymentGatewayCheckoutService

public interface PaymentGatewayCheckoutService

This is designed as a generic contract for allowing payment modules to add payments to an order represented in Broadleaf while still staying decoupled from any of the Broadleaf core framework concepts.

Author:

Elbert Bautista (elbertbautista), Phillip Verheyden (phillipuniverse)

Method Summary

Modifier and Type	Method and Description
Long	applyPaymentToOrder(PaymentResponse responseDTO, PaymentGatewayConfiguration config)
String	initiateCheckout(Long orderId) Initiates the checkout process for a given orderId.
String	lookupOrderNumberFromOrderId(PaymentResponse responseDTO) Looks up the order number for a particular order id from the PaymentResponse.
void	markPaymentAsInvalid(Long orderPaymentId) Marks a given order payment as invalid.

Method Detail

applyPaymentToOrder

Long applyPaymentToOrder(PaymentResponse responseDTO,
                         PaymentGatewayConfiguration config)
                  throws IllegalArgumentException

Parameters:

responseDTO - the response that came back from the gateway

config - values for the payment gateway

Returns:

a unique ID of the payment as it is saved in the core commerce engine. If using Broadleaf core, this ID can be used to retrieve the payment on the Broadleaf side for other methods like markPaymentAsInvalid(Long)

Throws:

IllegalArgumentException - if the PaymentResponse.isValid() ()} returns false or if the order that the PaymentResponse is attempted to be applied to has already gone through checkout

markPaymentAsInvalid

void markPaymentAsInvalid(Long orderPaymentId)

Marks a given order payment as invalid. In the default implementation, this archives the payment. This can be determined from the result of applyPaymentToOrder(PaymentResponse, PaymentGatewayConfiguration)

Parameters:

orderPaymentId - the payment ID to mark as invalid

initiateCheckout

String initiateCheckout(Long orderId)
                 throws Exception

Initiates the checkout process for a given orderId. This is usually from PaymentResponse.getOrderId()

Parameters:

orderId - the order to check out

Returns:

the order number generated when checking out the order

Throws:

Exception

lookupOrderNumberFromOrderId

String lookupOrderNumberFromOrderId(PaymentResponse responseDTO)
                             throws IllegalArgumentException

Looks up the order number for a particular order id from the PaymentResponse. This can be used to redirect the user coming from the payment gateway to the order confirmation page.

Parameters:

responseDTO - the response from the gateway

Returns:

The order number for order id. This method can return null if the order number has not already been set (which usually means that the order has not already been checked out)

Throws:

IllegalArgumentException - if the order cannot be found from the PaymentResponse