REST API for Oracle Banking Virtual Account Management

Adds a new account structures

post

/service/accountstructures

This endpoint is used to add a new account structure.

Request

Supported Media Types

application/json
application/xml

Request Body that contains data required for creating a new accountstructures

Root Schema : AccountMapMasterSaveDTO

Type: object

Match All

Show Source

object AccountMapMasterSaveDTO-allOf[0]

{
    "type":"object",
    "allOf":[
        {
            "type":"object",
            "properties":{
                "realCustomerNo":{
                    "type":"string",
                    "description":"Real Customer Number for which Virtual Account Structure is maintained"
                },
                "structureCode":{
                    "type":"string",
                    "description":"Code to identify Virtual Account Structure",
                    "minLength":1,
                    "maxLength":20,
                    "pattern":"[a-zA-Z0-9]+"
                },
                "structureDesc":{
                    "type":"string",
                    "description":"Description of Virtual Account Structure",
                    "minLength":0,
                    "maxLength":35,
                    "pattern":"([a-zA-Z0-9\\s]+)?"
                },
                "virtualMainAcc":{
                    "type":"string",
                    "description":"Virtual Main/Header Account"
                },
                "realAccountNo":{
                    "type":"string",
                    "description":"Real Account Number for which the VA Structure is mapped"
                },
                "realAccountBrn":{
                    "type":"string",
                    "description":"Branch of the Real Account Number"
                },
                "accountLinkage":{
                    "type":"string",
                    "description":"Type of real account number to be linked. Account or group level.",
                    "pattern":"[A,G]"
                },
                "accountGroupId":{
                    "type":"string",
                    "description":"Virtual Multi-Currency Account Number"
                },
                "interestCalcRequired":{
                    "type":"string",
                    "description":"Flag to indicate if Interest Calculation is required or not",
                    "pattern":"[Y,N]"
                },
                "custChargeAcc":{
                    "type":"string",
                    "description":"Customer charge account",
                    "maxLength":35
                },
                "custChargeAccBrn":{
                    "type":"string",
                    "description":"Customer charge account branch",
                    "maxLength":3
                },
                "custChargeAccCcy":{
                    "type":"string",
                    "description":"Customer charge account Currency",
                    "maxLength":3
                },
                "remarks":{
                    "type":"string",
                    "description":"Remarks of virtual account structure"
                },
                "AccountMapDetailSaveDTO":{
                    "type":"array",
                    "items":{
                        "$ref":"#/definitions/AccountMapDetailSaveDTO"
                    }
                }
            },
            "required":[
                "realCustomerNo",
                "structureCode",
                "structureDesc",
                "virtualMainAcc",
                "accountLinkage"
            ]
        }
    ]
}

Nested Schema : AccountMapMasterSaveDTO-allOf[0]

Type: object

Show Source

accountGroupId(optional): string

Virtual Multi-Currency Account Number
accountLinkage: string

Pattern: [A,G]

Type of real account number to be linked. Account or group level.
AccountMapDetailSaveDTO(optional): array AccountMapDetailSaveDTO
custChargeAcc(optional): string

Maximum Length: 35

Customer charge account
custChargeAccBrn(optional): string

Maximum Length: 3

Customer charge account branch
custChargeAccCcy(optional): string

Maximum Length: 3

Customer charge account Currency
interestCalcRequired(optional): string

Pattern: [Y,N]

Flag to indicate if Interest Calculation is required or not
realAccountBrn(optional): string

Branch of the Real Account Number
realAccountNo(optional): string

Real Account Number for which the VA Structure is mapped
realCustomerNo: string

Real Customer Number for which Virtual Account Structure is maintained
remarks(optional): string

Remarks of virtual account structure
structureCode: string

Minimum Length: 1

Maximum Length: 20

Pattern: [a-zA-Z0-9]+

Code to identify Virtual Account Structure
structureDesc: string

Minimum Length: 0

Maximum Length: 35

Pattern: ([a-zA-Z0-9\s]+)?

Description of Virtual Account Structure
virtualMainAcc: string

Virtual Main/Header Account

{
    "type":"object",
    "properties":{
        "realCustomerNo":{
            "type":"string",
            "description":"Real Customer Number for which Virtual Account Structure is maintained"
        },
        "structureCode":{
            "type":"string",
            "description":"Code to identify Virtual Account Structure",
            "minLength":1,
            "maxLength":20,
            "pattern":"[a-zA-Z0-9]+"
        },
        "structureDesc":{
            "type":"string",
            "description":"Description of Virtual Account Structure",
            "minLength":0,
            "maxLength":35,
            "pattern":"([a-zA-Z0-9\\s]+)?"
        },
        "virtualMainAcc":{
            "type":"string",
            "description":"Virtual Main/Header Account"
        },
        "realAccountNo":{
            "type":"string",
            "description":"Real Account Number for which the VA Structure is mapped"
        },
        "realAccountBrn":{
            "type":"string",
            "description":"Branch of the Real Account Number"
        },
        "accountLinkage":{
            "type":"string",
            "description":"Type of real account number to be linked. Account or group level.",
            "pattern":"[A,G]"
        },
        "accountGroupId":{
            "type":"string",
            "description":"Virtual Multi-Currency Account Number"
        },
        "interestCalcRequired":{
            "type":"string",
            "description":"Flag to indicate if Interest Calculation is required or not",
            "pattern":"[Y,N]"
        },
        "custChargeAcc":{
            "type":"string",
            "description":"Customer charge account",
            "maxLength":35
        },
        "custChargeAccBrn":{
            "type":"string",
            "description":"Customer charge account branch",
            "maxLength":3
        },
        "custChargeAccCcy":{
            "type":"string",
            "description":"Customer charge account Currency",
            "maxLength":3
        },
        "remarks":{
            "type":"string",
            "description":"Remarks of virtual account structure"
        },
        "AccountMapDetailSaveDTO":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/AccountMapDetailSaveDTO"
            }
        }
    },
    "required":[
        "realCustomerNo",
        "structureCode",
        "structureDesc",
        "virtualMainAcc",
        "accountLinkage"
    ]
}

Nested Schema : AccountMapDetailSaveDTO

Type: array

Show Source

Array of: object AccountMapDetailSaveDTO

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/AccountMapDetailSaveDTO"
    }
}

Nested Schema : AccountMapDetailSaveDTO

Type: object

Show Source

virtualChildAcc(optional): string
virtualParentAcc(optional): string

{
    "type":"object",
    "properties":{
        "virtualParentAcc":{
            "type":"string",
            "description":""
        },
        "virtualChildAcc":{
            "type":"string",
            "description":""
        }
    }
}

Response

Supported Media Types

application/json
application/xml

201 Response

Returns message of succes or failure

Headers

Location: string

URL of newly created accountstructures

Root Schema : AccountMapServiceResponseWrapperDTO

Type: object

Show Source

data(optional): object AccountMapMasterServiceDTO
messages(optional): object AccountMapServiceResponseDto

{
    "type":"object",
    "properties":{
        "messages":{
            "$ref":"#/definitions/AccountMapServiceResponseDto"
        },
        "data":{
            "$ref":"#/definitions/AccountMapMasterServiceDTO"
        }
    }
}

Nested Schema : AccountMapMasterServiceDTO

Type: object

Match All

Show Source

object AccountMapMasterServiceDTO-allOf[0]

{
    "type":"object",
    "allOf":[
        {
            "type":"object",
            "properties":{
                "realCustomerNo":{
                    "type":"string",
                    "description":"Real Customer Number for which Virtual Account Structure is maintained"
                },
                "structureCode":{
                    "type":"string",
                    "description":"Code to identify Virtual Account Structure",
                    "minLength":1,
                    "maxLength":20,
                    "pattern":"[a-zA-Z0-9]+"
                },
                "structureDesc":{
                    "type":"string",
                    "description":"Description of Virtual Account Structure",
                    "minLength":0,
                    "maxLength":35,
                    "pattern":"([a-zA-Z0-9\\s]+)?"
                },
                "virtualMainAcc":{
                    "type":"string",
                    "description":"Virtual Main/Header Account"
                },
                "realAccountNo":{
                    "type":"string",
                    "description":"Real Account Number for which the VA Structure is mapped"
                },
                "realAccountBrn":{
                    "type":"string",
                    "description":"Branch of the Real Account Number"
                },
                "accountLinkage":{
                    "type":"string",
                    "description":"Type of real account number to be linked. Account or group level.",
                    "pattern":"[A,G]"
                },
                "accountGroupId":{
                    "type":"string",
                    "description":"Virtual Multi-Currency Account Number"
                },
                "interestCalcRequired":{
                    "type":"string",
                    "description":"Flag to indicate if Interest Calculation is required or not",
                    "pattern":"[Y,N]"
                },
                "creationDate":{
                    "type":"string",
                    "description":"Structure creation date"
                },
                "makerId":{
                    "type":"string",
                    "description":"Maker ID of Virtual Account"
                },
                "makerDateStamp":{
                    "type":"string",
                    "description":"Date and Time when Virtual Account is created or modified or closed or reopened"
                },
                "checkerId":{
                    "type":"string",
                    "description":"Checker ID of Virtual Account"
                },
                "checkerDateStamp":{
                    "type":"string",
                    "description":"Date and Time when some action on Virtual Account is authorized"
                },
                "modNo":{
                    "type":"integer",
                    "description":"Version number of Virtual Account"
                },
                "recordStatus":{
                    "type":"string",
                    "description":"Record Status of Virtual Account"
                },
                "authStatus":{
                    "type":"string",
                    "description":"Authorization Status of Virtual Account"
                },
                "onceAuth":{
                    "type":"string",
                    "description":"Flag that indicated if Virtual Account is authorized once or not"
                },
                "doerRemarks":{
                    "type":"string",
                    "description":"Remarks made by Maker"
                },
                "approverRemarks":{
                    "type":"string",
                    "description":"Remarks made by Approver"
                },
                "AccountMapDetailServiceDTO":{
                    "type":"array",
                    "items":{
                        "$ref":"#/definitions/AccountMapDetailServiceDTO"
                    }
                }
            }
        }
    ]
}

Nested Schema : AccountMapServiceResponseDto

Type: object

Show Source

codes(optional): array codes
status(optional): string

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string"
        },
        "codes":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/AccountMapServiceResponseCode"
            }
        }
    }
}

Nested Schema : AccountMapMasterServiceDTO-allOf[0]

Type: object

Show Source

accountGroupId(optional): string

Virtual Multi-Currency Account Number
accountLinkage(optional): string

Pattern: [A,G]

Type of real account number to be linked. Account or group level.
AccountMapDetailServiceDTO(optional): array AccountMapDetailServiceDTO
approverRemarks(optional): string

Remarks made by Approver
authStatus(optional): string

Authorization Status of Virtual Account
checkerDateStamp(optional): string

Date and Time when some action on Virtual Account is authorized
checkerId(optional): string

Checker ID of Virtual Account
creationDate(optional): string

Structure creation date
doerRemarks(optional): string

Remarks made by Maker
interestCalcRequired(optional): string

Pattern: [Y,N]

Flag to indicate if Interest Calculation is required or not
makerDateStamp(optional): string

Date and Time when Virtual Account is created or modified or closed or reopened
makerId(optional): string

Maker ID of Virtual Account
modNo(optional): integer

Version number of Virtual Account
onceAuth(optional): string

Flag that indicated if Virtual Account is authorized once or not
realAccountBrn(optional): string

Branch of the Real Account Number
realAccountNo(optional): string

Real Account Number for which the VA Structure is mapped
realCustomerNo(optional): string

Real Customer Number for which Virtual Account Structure is maintained
recordStatus(optional): string

Record Status of Virtual Account
structureCode(optional): string

Minimum Length: 1

Maximum Length: 20

Pattern: [a-zA-Z0-9]+

Code to identify Virtual Account Structure
structureDesc(optional): string

Minimum Length: 0

Maximum Length: 35

Pattern: ([a-zA-Z0-9\s]+)?

Description of Virtual Account Structure
virtualMainAcc(optional): string

Virtual Main/Header Account

{
    "type":"object",
    "properties":{
        "realCustomerNo":{
            "type":"string",
            "description":"Real Customer Number for which Virtual Account Structure is maintained"
        },
        "structureCode":{
            "type":"string",
            "description":"Code to identify Virtual Account Structure",
            "minLength":1,
            "maxLength":20,
            "pattern":"[a-zA-Z0-9]+"
        },
        "structureDesc":{
            "type":"string",
            "description":"Description of Virtual Account Structure",
            "minLength":0,
            "maxLength":35,
            "pattern":"([a-zA-Z0-9\\s]+)?"
        },
        "virtualMainAcc":{
            "type":"string",
            "description":"Virtual Main/Header Account"
        },
        "realAccountNo":{
            "type":"string",
            "description":"Real Account Number for which the VA Structure is mapped"
        },
        "realAccountBrn":{
            "type":"string",
            "description":"Branch of the Real Account Number"
        },
        "accountLinkage":{
            "type":"string",
            "description":"Type of real account number to be linked. Account or group level.",
            "pattern":"[A,G]"
        },
        "accountGroupId":{
            "type":"string",
            "description":"Virtual Multi-Currency Account Number"
        },
        "interestCalcRequired":{
            "type":"string",
            "description":"Flag to indicate if Interest Calculation is required or not",
            "pattern":"[Y,N]"
        },
        "creationDate":{
            "type":"string",
            "description":"Structure creation date"
        },
        "makerId":{
            "type":"string",
            "description":"Maker ID of Virtual Account"
        },
        "makerDateStamp":{
            "type":"string",
            "description":"Date and Time when Virtual Account is created or modified or closed or reopened"
        },
        "checkerId":{
            "type":"string",
            "description":"Checker ID of Virtual Account"
        },
        "checkerDateStamp":{
            "type":"string",
            "description":"Date and Time when some action on Virtual Account is authorized"
        },
        "modNo":{
            "type":"integer",
            "description":"Version number of Virtual Account"
        },
        "recordStatus":{
            "type":"string",
            "description":"Record Status of Virtual Account"
        },
        "authStatus":{
            "type":"string",
            "description":"Authorization Status of Virtual Account"
        },
        "onceAuth":{
            "type":"string",
            "description":"Flag that indicated if Virtual Account is authorized once or not"
        },
        "doerRemarks":{
            "type":"string",
            "description":"Remarks made by Maker"
        },
        "approverRemarks":{
            "type":"string",
            "description":"Remarks made by Approver"
        },
        "AccountMapDetailServiceDTO":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/AccountMapDetailServiceDTO"
            }
        }
    }
}

Nested Schema : AccountMapDetailServiceDTO

Type: array

Show Source

Array of: object AccountMapDetailServiceDTO

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/AccountMapDetailServiceDTO"
    }
}

Nested Schema : AccountMapDetailServiceDTO

Type: object

Show Source

virtualChildAcc(optional): string
virtualMainAcc(optional): string
virtualParentAcc(optional): string

{
    "type":"object",
    "properties":{
        "virtualMainAcc":{
            "type":"string",
            "description":""
        },
        "virtualParentAcc":{
            "type":"string",
            "description":""
        },
        "virtualChildAcc":{
            "type":"string",
            "description":""
        }
    }
}

Nested Schema : codes

Type: array

Show Source

Array of: object AccountMapServiceResponseCode

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/AccountMapServiceResponseCode"
    }
}

Nested Schema : AccountMapServiceResponseCode

Type: object

Show Source

Code(optional): string
Desc(optional): string
Language(optional): string
Type(optional): string

{
    "type":"object",
    "properties":{
        "Code":{
            "type":"string"
        },
        "Desc":{
            "type":"string"
        },
        "Type":{
            "type":"string"
        },
        "Language":{
            "type":"string"
        }
    }
}

400 Response

Bad request error, the server is unable to process the request

401 Response

Unauthorized request error, invalid credentials

403 Response

Request denied, no permission to access the request.

405 Response

Request denied, invalid input.

500 Response

Internal server error.