Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
<groupId>com.cdrator.integration.financial</grocom.CDRator.billing.financial.ekspresbank.actionupId>groupId>
<artifactId>rator-financial-dk-ekspresbank</artifactId>

...

The Ekspres bank API can be accessed through the workflow actions developed in CDRator integration project. 

...

Workflow Actions

GetApplicationStatusAction

...

Code Block
languagejava
public ApplicationStatusResult execute(String applicationGUID, String applicationId, String brandId) throws Exception

applicationGUID: An order number used to identify the transaction  The unique ID that is used to reference an application.

applicationId: Application Id. 

brandId:  Used to read the Branded parameters. The URL of the webservice at Ekspres bank and some additional required arguments that are needed are specified in the parameter tree. This So brand Id is used on a branded environment.

The action returns a string which is the 'decision' on the response from Ekspres bank. This decision is mapped from a single character to a readable response.

ACCEPT, DECLINE, REFER, CANCEL, GOAHEAD, CAPTURED, ERROR.

Important NoteWhen using the GetApplicationStatusAction, do not supply both ApplicationGuid and ApplicationId. Only supply ApplicationGuid.

Return value: This action returns an object of type ApplicationStatusResult. Helper methods exposed by this object can be used to map the result to relevant outcomes based on business requirements. The table below describes all helper methods that can be invoked on this result object with a description of the return value for each of these methods. 

If anything unexpected happens, an exception is thrown. It is possible to map an Exception to an outcome on the Action GUI on the workflow builder. 

CancelAction

Package: com.CDRator.billing.financial.ekspresbank.action.CancelAction

...

Code Block
languagejava
public CancelResult execute(String applicationGUID, Date eventDate, String brandId) throws Exception

applicationGUID: An order number used to identify the transactionThe unique ID that is used to reference an application.

eventDate:  Time of cancellation of the Application

brandId: Used to read the Branded parameters. The URL of the webservice at Ekspres bank and some additional required arguments that are needed are specified in the parameter tree. This So brand Id is used on a branded environment.

The action returns a string, see section 4 for return values.Return value: This action returns an object of type CancelResult. Helper methods exposed by this object can be used to map the result to relevant outcomes based on business requirements. The table below describes all helper methods that can be invoked on this result object with a description of the return value for each of these methods. 

If anything unexpected happens, an exception is thrown. It is possible to map an Exception to an outcome on the Action GUI on the workflow builder. 

CaptureAction

Package: com.CDRator.billing.financial.ekspresbank.action.CaptureAction

...

Code Block
languagejava
public CaptureResult execute(String applicationGUID, Date eventDate, String brandId) throws Exception

applicationGUID: An order number used to identify the transaction The unique ID that is used to reference an application.

eventDate: Time of physical shipment of the goods

brandId:  Used to read the Branded parameters. The URL of the webservice at Ekspres bank and some additional required arguments that are needed are specified in the parameter tree. This So brand Id is used on a branded environment.

The action returns a string, see section 4 for return values.Return value: This action returns an object of type CaptureResult. Helper methods exposed by this object can be used to map the result to relevant outcomes based on business requirements. The table below describes all helper methods that can be invoked on this result object with a description of the return value for each of these methods. 

If anything unexpected happens, an exception is thrown. It is possible to map an Exception to an outcome on the Action GUI on the workflow builder. 

4 - Return Codes

ReturnCode

Description

OK

Everything is ok, no errors.

ERROR_LOGIN_ERROR

Something is wrong with the RetailerId/Password combination.

ERROR_APPLICATION_NOTFOUND

Application identified by RetailerId/OrderNr not found.

ERROR_UNKNOWN_ERROR

Unexpected error occurred.

ERROR_APPLICATION_ALREADY_SUBMITTED

There is already a submitted application with the given OrderNr.

ERROR_MANDATORY_FIELDS_MISSING

Not all mandatory fields were provided for the requested operation.

ERROR_SITE_DISABLED

The site is disabled.

ERROR_INVALID_PREFILLABLE_FIELDS

There are either non-prefillable fields available, or the value of some
prefillable fields are invalid.

ERROR_INVALID_HASH

The hash of the fields is invalid.

...