All Superinterfaces:

Service

All Known Subinterfaces:

RecurringPaymentServiceLocal
```
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`	`block(@NotNull RecurringPaymentActionDTO params)`	Blocks the given recurring payment, so installments won't be processed on their respective due dates
`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
`RecurringPaymentEditData`	`getEditData(@NotNull RecurringPaymentVO vo)`	Returns data for edition about a recurring payment
`void`	`modify(@NotNull RecurringPaymentDTO recurringPayment, String confirmationPassword)`	Modifies the given 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
`void`	`unblock(@NotNull RecurringPaymentActionDTO params)`	Unlocks the given recurring payment, so installments will be processed on their respective due dates

Method Detail

block
```
void block(@NotNull
           @NotNull RecurringPaymentActionDTO params)
    throws FrameworkException
```
Blocks the given recurring payment, so installments won't be processed on their respective due dates

Throws:

FrameworkException

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

getEditData

RecurringPaymentEditData getEditData(@NotNull
                                     @NotNull RecurringPaymentVO vo)
                              throws FrameworkException

Returns data for edition about a recurring payment

Throws:: FrameworkException

modify

void modify(@NotNull
            @NotNull RecurringPaymentDTO recurringPayment,
            String confirmationPassword)
     throws FrameworkException

Modifies the given 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)

unblock
```
void unblock(@NotNull
             @NotNull RecurringPaymentActionDTO params)
      throws FrameworkException
```
Unlocks the given recurring payment, so installments will be processed on their respective due dates

Throws:

FrameworkException

Interface RecurringPaymentService