Package com.broadleafcommerce.paymentgateway.service

Interface PaymentGatewayPaymentModificationService

All Superinterfaces:
PaymentGatewayTypeAware
public interface PaymentGatewayPaymentModificationService extends PaymentGatewayTypeAware
This service is responsible for interacting with the payment gateway to modify a payment's paymentMethodProperties.
Author:
Dima Myroniuk (dmyroniuk)

  • Method Details

    • modifyPaymentMethodProperties

      @Deprecated(forRemoval=true) default Map<String,String> modifyPaymentMethodProperties(@NonNull @NonNull Map<String,String> paymentMethodProperties, @Nullable String applicationId, @Nullable String tenantId)
      Deprecated, for removal: This API element is subject to removal in a future version.
      in favor of modifyPaymentMethodProperties(PaymentInfo, String, String)
      Modify the given paymentMethodProperties for alternative values used by the gateway. In most cases, this involves swapping a provided payment representation for a different style of representation. For example, swapping a digital wallet token for the payment gateway's token.
      Parameters:
      paymentMethodProperties - the payment method properties
      applicationId - the application id
      tenantId - the tenant id
      Returns:
      the modified payment method properties
      Throws:
      PaymentMethodPropertiesModificationException - if an error occurred during the modification of the payment method properties

    • modifyPaymentMethodProperties

      default Map<String,String> modifyPaymentMethodProperties(@NonNull @NonNull PaymentInfo paymentInfo, @Nullable String applicationId, @Nullable String tenantId)
      Modify the given PaymentInfo.getPaymentMethodProperties() for alternative values used by the gateway. In most cases, this involves swapping a provided payment representation for a different style of representation. For example, swapping a digital wallet token for the payment gateway's token.
      Parameters:
      paymentInfo - the information about payment
      applicationId - the application id
      tenantId - the tenant id
      Returns:
      the modified payment method properties
      Throws:
      PaymentMethodPropertiesModificationException - if an error occurred during the modification of the payment method properties

    • updateGatewayPayment

      default Map<String,Object> updateGatewayPayment(@NonNull @NonNull UpdateGatewayPaymentRequest request, @Nullable String applicationId, @Nullable String tenantId)
      Updates the payment gateway's representation of the payment.
      Parameters:
      request - Request object describing the data that is to be updated.
      applicationId - the current context's application id.
      tenantId - the current context's tenant id.
      Returns:
      The gateway's response to the update.

    • getCallbackUrlKeys

      default Set<String> getCallbackUrlKeys()
      Provides the set of PaymentInfo.getPaymentMethodProperties() map keys for any properties that declare a callback url used to redirect back to a Broadleaf context following an interaction like 3DS verification or a HPP interaction.
      Returns:
      a set of PaymentInfo.getPaymentMethodProperties() map keys