All Superinterfaces:

Service

All Known Subinterfaces:

RecurringPaymentServiceLocal

All Known Implementing Classes:

RecurringPaymentServiceImpl, RecurringPaymentServiceSecurity
```
public interface RecurringPaymentService
extends Service
```
Service interface to perform recurring payments and for searching and retrieve information about a recurring payment. A recurring payment is a transaction, and performing a recurring payment normally starts by using TransactionService.getPaymentData(org.cyclos.model.banking.accounts.InternalAccountOwner, org.cyclos.model.banking.accounts.InternalAccountOwner, org.cyclos.model.banking.transfertypes.TransferTypeVO). preview(PerformRecurringPaymentDTO) and eventually perform(PerformRecurringPaymentDTO) the recurring payment.

See Also:

TransactionService, PaymentService

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`void`	`cancel(@NotNull RecurringPaymentActionDTO params)`	Permanently cancels the given recurring payment, so installments will never be processed
`RecurringPaymentData`	`getData(@NotNull Long id)`	Returns data about a recurring payment
`RecurringPaymentVO`	`perform(@NotNull PerformRecurringPaymentDTO recurringPayment)`	Performs an recurring payment, returning its data
`RecurringPaymentPreviewVO`	`preview(@NotNull PerformRecurringPaymentDTO parameters)`	Previews a recurring payment to be performed
`RecurringPaymentPreviewVO`	`previewReceive(@NotNull PerformRecurringPaymentDTO parameters)`	Previews a recurring payment to be received
`TransferVO`	`processFailure(@NotNull InstallmentActionDTO params)`	Processes a failed occurrence
`RecurringPaymentVO`	`receive(@NotNull PerformRecurringPaymentDTO recurringPayment)`	Receives a recurring payment, returning its data

Method Detail

cancel
```
void cancel(@NotNull
            @NotNull RecurringPaymentActionDTO params)
     throws FrameworkException
```
Permanently cancels the given recurring payment, so installments will never be processed

Throws:

FrameworkException

getData

RecurringPaymentData getData(@NotNull
                             @NotNull Long id)
                      throws FrameworkException

Returns data about a recurring payment

Throws:: FrameworkException

perform

RecurringPaymentVO perform(@NotNull
                           @NotNull PerformRecurringPaymentDTO recurringPayment)
                    throws TransferException,
                           FrameworkException

Performs an recurring payment, returning its data

Throws:: TransferException; FrameworkException
See Also:: PaymentService.perform(org.cyclos.model.banking.transactions.PerformPaymentDTO)

preview

RecurringPaymentPreviewVO preview(@NotNull
                                  @NotNull PerformRecurringPaymentDTO parameters)
                           throws FrameworkException

Previews a recurring payment to be performed

Throws:: FrameworkException

previewReceive

RecurringPaymentPreviewVO previewReceive(@NotNull
                                         @NotNull PerformRecurringPaymentDTO parameters)
                                  throws FrameworkException

Previews a recurring payment to be received

Throws:: FrameworkException

processFailure

TransferVO processFailure(@NotNull
                          @NotNull InstallmentActionDTO params)
                   throws FrameworkException,
                          TransferException

Processes a failed occurrence

Throws:: FrameworkException; TransferException

receive

RecurringPaymentVO receive(@NotNull
                           @NotNull PerformRecurringPaymentDTO recurringPayment)
                    throws TransferException,
                           PosPayerException,
                           FrameworkException

Receives a recurring payment, returning its data

Throws:: TransferException; PosPayerException; FrameworkException
See Also:: PaymentService.perform(org.cyclos.model.banking.transactions.PerformPaymentDTO)

Interface RecurringPaymentService