1. Oracle Banking Routing Hub Integration Guide
  2. Integration Guide
  3. APIs configured using Oracle Banking Routing Hub
  4. DDA Implementation
  5. Consumer Services - DDA

2.2.1.2 Consumer Services - DDA

This topic describes about the consumer services required for DDA Implementation.

The below endpoints must be configured under Consumer Services in Oracle Banking Routing Hub:
  1. Create an amount block (createECA)
  2. Close/release amount block (closeECA)
  3. External account check (EAC)
  4. Create a transaction (handofftoDDA)
  5. Structure Address Create (StrcAddressServiceCreate)
  6. Structure Address Modify (StrcAddressServiceModify)
  7. Structure Address Close (StrcAddressServiceClose)
  8. Structure Address Reopen (StrcAddressServiceReopen)
  9. Create External VA (CreateExtVirtualAcc)
  10. Modify External VA (ModifyExtVirtualAcc)
  11. Close External VA (CloseExtVirtualAcc)
  12. Reopen External VA (ReopenExtVirtualAcc)

Figure 2-3 Consumer Services - DDA


Description of Figure 2-3 follows
Description of "Figure 2-3 Consumer Services - DDA"

As part of Multi-Entity changes, add the EntityId of DDA System under <fcub:ENTITY> </fcub:ENTITY> tags in velocity template for each operation as shown below.

Figure 2-4 View Transformation


Description of Figure 2-4 follows
Description of "Figure 2-4 View Transformation"

createECA

This API enables the user to create an amount block.

Request / Response for FCUBS Version 14.1 and 14.4

SERVICE-CONSUMER = “OBVAM_DDA”

SERVICE-CONSUMER-SERVICE=”createECA”

Request:

{
  "userID": "",
  "currentBranchCode": "",
  "ddaSystem": "",
  "transactionrefNo": "",
  "creatEextRefNo": "",
  "ecaReferenceNo": "",
  "source": "",
  "effectiveDate": "",
  "ecaBlockDetailsDTO": 
  [
    {
      "accountNo": "",
      "accCurrency": "",
      "accountbranch": "",
      "blockStatus": "",
      "drCrIndicator": "",
      "sweepRequired": "",
      "partialBlkReqd": "",
      "remarks": "",
      "requestBlkAmount": "",
      "approvedBlkAmount": "",
      "outstandingBlkAmount": "",
      "partialReleaseAllowed": ""
    }
  ]
}

Response:

{ 
  "MSGSTAT":"" (SUCCESS/FAILUER)
  "{ERROR_CODE}":"{ERROR_DESC}"(if MSGSTAT = FAILUER) 
}

closeECA

This API enables the user to close/release the amount block.

Request / Response for FCUBS Version 14.1 and 14.4

SERVICE-CONSUMER = “OBVAM_DDA”

SERVICE-CONSUMER-SERVICE = “closeECA”

Request:

{
  "userID": "",
  "currentBranchCode": "",
  "ddaSystem": "",
  "ecaReferenceNo": "",
  "ddaReferenceNo": "",
  "createextRefNo": "",
  "source": "",
  "ecaCloseDetailsDTO": 
  [
    {
      "accountNo": "",
      "accCurreny": "",
      "accountbranch": "",
      "blockStatus": ""
    }
  ]
}

Response:

{ 
  "MSGSTAT":"" 
}

EAC

This API enables the user to perform an external account check.

Request / Response for FCUBS Version 14.1 and 14.4

SERVICE-CONSUMER = “OBVAM_DDA”

SERVICE-CONSUMER-SERVICE = “ECA”

Request:

{
  "userID": "",
  "currentBranchCode": "",
  "ddaSystem": "",
  "realAccountNo": "",
  "drCrIndicator": "",
  "externalRefNo": "",
  "mcyFlag": "",
  "customerBranchCode": "",
  "ccy": "", 
}

Response:

{ 
  "isValidAccount":"" 
}

handoffToDda

This API enables the user to create a transaction.

Request / Response for FCUBS Version 14.1 and 14.4

SERVICE-CONSUMER = “OBVAM_DDA”

SERVICE-CONSUMER-SERVICE = “handoffToDda”

Request:

{
  "userID": "",
  "currentBranchCode": "",
  "ddaSystem": "",
  "externalReferenceNo": "",
  "source": "",
  "ecaEntriesDetailsDTO": 
  [
    {
      "module": "",
      "transactionRefNo": "",
      "eventserialNo": "",
      "event": "",
      "accBranch": "",
      "accountNumber": "",
      "accCCY": "",
      "drCrIndicator": "",
      "amttag": "",
      "lcyAmt": 0,
      "trnDate": "",
      "valueDate": "",
      "ecaRefernceNo": "",
      "blockReleaseStatus": "",
      "chequeMandatory": "",
      "availBalReqd": "",
      "intraDayRelease": "",
      "availInfo": "",
      "salaryCredit": "",
      "sweepRequried": "",
      "escrow": "",
      "AMLMontoring": "",
      "considerForAccActivity": "",
      "balUpdThruPC": "",
      "txnNarrative": "",
      "txnCode": "",
      "relatedCustomer": "",
      "fcyAmount": 0,
      "exchrate":0
    }
  ]
}

Response:

{ 
  "MSGSTAT":"" 
}

StrcAddressServiceCreate

This API enables the user to create structure address.

Request / Response for FCUBS Version 14.1 and 14.4

SERVICE-CONSUMER = “OBVAM_DDA”

SERVICE-CONSUMER-SERVICE= “StrcAddressServiceCreate”

Request
{
  "department": "",
  "subDepartment": "",
  "streetName": "",
  "buildingNumber": "",
  "buildingName": "",
  "floor": "", 
  "postbox": "",
  "room": "",
  "postcode": "",
  "townName": "",
  "townLocationName": "",
  "districtName": "",
  "countrySubDivision": "",
  "strrCountry": "",
  "virtualAccountNo": "",
  "branchId": ""
}
Response:
{
 "MSGSTAT":""
}

StrcAddressServiceModify

This API enables the user to modify structure address.

Request / Response for FCUBS Version 14.1 and 14.4

SERVICE-CONSUMER = “OBVAM_DDA”

SERVICE-CONSUMER-SERVICE= “StrcAddressServiceModify”

Request:
{
        "department": "",
        "subDepartment": "",
        "streetName": "",
        "buildingNumber": "",
        "buildingName": "",
        "floor": "",
        "postbox": "",
        "room": "",
        "postcode": "",
        "townName": "",
        "townLocationName": "",
        "districtName": "",
        "countrySubDivision": "",
        "strrCountry": "",
        "virtualAccountNo": "",
        "branchId": ""
    }
Response:
{
 "MSGSTAT":""
}

StrcAddressServiceClose

This API enables the user to close structure address.

Request / Response for FCUBS Version 14.1 and 14.4

SERVICE-CONSUMER = “OBVAM_DDA”

SERVICE-CONSUMER-SERVICE= “StrcAddressServiceClose”

Request:
{
        "department": "",
        "subDepartment": "",
        "streetName": "",
        "buildingNumber": "",
        "buildingName": "",
        "floor": "",
        "postbox": "",
        "room": "",
        "postcode": "",
        "townName": "",
        "townLocationName": "",
        "districtName": "",
        "countrySubDivision": "",
        "strrCountry": "",
        "virtualAccountNo": "",
        "branchId": ""
    }
Response:
{
 "MSGSTAT":""
}

StrcAddressServiceReopen

This API enables the user to reopen structure address.

Request / Response for FCUBS Version 14.1 and 14.4

SERVICE-CONSUMER = “OBVAM_DDA”

SERVICE-CONSUMER-SERVICE= “StrcAddressServiceReopen”

Request:
{
        "department": "",
        "subDepartment": "",
        "streetName": "",
        "buildingNumber": "",
        "buildingName": "",
        "floor": "",
        "postbox": "",
        "room": "",
        "postcode": "",
        "townName": "",
        "townLocationName": "",
        "districtName": "",
        "countrySubDivision": "",
        "strrCountry": "",
        "virtualAccountNo": "",
        "branchId": ""
    }
Response:
{
 "MSGSTAT":""
}

CreateExtVirtualAcc

This API enables the user to create external virtual account.

Request / Response for FCUBS Version 14.1 and 14.4

SERVICE-CONSUMER = “OBVAM_DDA”

SERVICE-CONSUMER-SERVICE= “CreateExtVirtualAcc”

Request:
{
        "countryCode": "",
        "address4": " ",
        "address3": "",
        "address2": "",
        "address1": "",
        "ecaCheckReq": "",
        "accountClass": "",
        "acStatDormant": "",
        "acStatFrozen": "",
        "glStatBlocked": "",
        "acStatNoDr": "",
        "acStatNoCr": "",
        "acOpenDate": "",
        "custAcName": "",
        "custAcCcy": "",
        "customerNo": "",
        "sourceSystemAccBrn": "",
        "sourceSystemAccNo": "",
        "sourceSystem": "",
        "custAcIban": "",
        "hostCode": "",
        "custAccountNo": "",
        "branchId": ""
    }
Response:
{
 "MSGSTAT":""
}

ModifyExtVirtualAcc

This API enables the user to modify external virtual account.

Request / Response for FCUBS Version 14.1 and 14.4

SERVICE-CONSUMER = “OBVAM_DDA”

SERVICE-CONSUMER-SERVICE= “ModifyExtVirtualAcc”

Request:
{
        "countryCode": "",
        "address4": " ",
        "address3": "",
        "address2": "",
        "address1": "",
        "ecaCheckReq": "",
        "accountClass": "",
        "acStatDormant": "",
        "acStatFrozen": "",
        "glStatBlocked": "",
        "acStatNoDr": "",
        "acStatNoCr": "",
        "acOpenDate": "",
        "custAcName": "",
        "custAcCcy": "",
        "customerNo": "",
        "sourceSystemAccBrn": "",
        "sourceSystemAccNo": "",
        "sourceSystem": "",
        "custAcIban": "",
        "hostCode": "",
        "custAccountNo": "",
        "branchId": ""
    }
Response:
{
 "MSGSTAT":""
}

CloseExtVirtualAcc

This API enables the user to close external virtual account.

Request / Response for FCUBS Version 14.1 and 14.4

SERVICE-CONSUMER = “OBVAM_DDA”

SERVICE-CONSUMER-SERVICE= “CloseExtVirtualAcc”

Request:
{
        "countryCode": "",
        "address4": " ",
        "address3": "",
        "address2": "",
        "address1": "",
        "ecaCheckReq": "",
        "accountClass": "",
        "acStatDormant": "",
        "acStatFrozen": "",
        "glStatBlocked": "",
        "acStatNoDr": "",
        "acStatNoCr": "",
        "acOpenDate": "",
        "custAcName": "",
        "custAcCcy": "",
        "customerNo": "",
        "sourceSystemAccBrn": "",
        "sourceSystemAccNo": "",
        "sourceSystem": "",
        "custAcIban": "",
        "hostCode": "",
        "custAccountNo": "",
        "branchId": ""
    }
Response:
{
 "MSGSTAT":""
}

ReopenExtVirtualAcc

This API enables the user to reopen external virtual account.

Request / Response for FCUBS Version 14.1 and 14.4

SERVICE-CONSUMER = “OBVAM_DDA”

SERVICE-CONSUMER-SERVICE= “ReopenExtVirtualAcc”

Request:
{
        "countryCode": "",
        "address4": " ",
        "address3": "",
        "address2": "",
        "address1": "",
        "ecaCheckReq": "",
        "accountClass": "",
        "acStatDormant": "",
        "acStatFrozen": "",
        "glStatBlocked": "",
        "acStatNoDr": "",
        "acStatNoCr": "",
        "acOpenDate": "",
        "custAcName": "",
        "custAcCcy": "",
        "customerNo": "",
        "sourceSystemAccBrn": "",
        "sourceSystemAccNo": "",
        "sourceSystem": "",
        "custAcIban": "",
        "hostCode": "",
        "custAccountNo": "",
        "branchId": ""
    }
Response:
{
 "MSGSTAT":""
}

Parent topic: DDA Implementation