REST API for Oracle Banking Virtual Account Management

Adds a new structured address service

post

/service/structuredaddressservice

This endpoint is used to add a new structured address service.

Request

Supported Media Types

application/json
application/xml

Request Body that contains data required for creating a new structuredaddressservice

Root Schema : StructuredAddressServiceSaveDTO

Type: object

Match All

Show Source

object StructuredAddressServiceSaveDTO-allOf[0]

{
    "type":"object",
    "allOf":[
        {
            "type":"object",
            "properties":{
                "department":{
                    "type":"string",
                    "description":"Department",
                    "maxLength":70
                },
                "subDepartment":{
                    "type":"string",
                    "description":"Sub Department",
                    "maxLength":70
                },
                "streetName":{
                    "type":"string",
                    "description":"Street Name",
                    "maxLength":70
                },
                "buildingNumber":{
                    "type":"string",
                    "description":"Building Number",
                    "maxLength":16
                },
                "buildingName":{
                    "type":"string",
                    "description":"building Name",
                    "maxLength":35
                },
                "floor":{
                    "type":"string",
                    "description":"Floor",
                    "maxLength":70
                },
                "postbox":{
                    "type":"string",
                    "description":"postbox",
                    "maxLength":16
                },
                "room":{
                    "type":"string",
                    "description":"Room",
                    "maxLength":70
                },
                "postcode":{
                    "type":"string",
                    "description":"postcode",
                    "maxLength":16
                },
                "townName":{
                    "type":"string",
                    "description":"Town Name",
                    "maxLength":35
                },
                "townLocationName":{
                    "type":"string",
                    "description":"Town Location Name",
                    "maxLength":35
                },
                "districtName":{
                    "type":"string",
                    "description":"District name",
                    "maxLength":35
                },
                "countrySubDivision":{
                    "type":"string",
                    "description":"Country Sub Division",
                    "maxLength":35
                },
                "strrCountry":{
                    "type":"string",
                    "description":"country",
                    "maxLength":2
                },
                "virtualAccountNo":{
                    "type":"string",
                    "description":"Account number of the External customer",
                    "minLength":1,
                    "maxLength":35
                }
            },
            "required":[
                "virtualAccountNo",
                "strrCountry",
                "postcode",
                "townName"
            ]
        }
    ]
}

Nested Schema : StructuredAddressServiceSaveDTO-allOf[0]

Type: object

Show Source

buildingName(optional): string

Maximum Length: 35

building Name
buildingNumber(optional): string

Maximum Length: 16

Building Number
countrySubDivision(optional): string

Maximum Length: 35

Country Sub Division
department(optional): string

Maximum Length: 70

Department
districtName(optional): string

Maximum Length: 35

District name
floor(optional): string

Maximum Length: 70

Floor
postbox(optional): string

Maximum Length: 16

postbox
postcode: string

Maximum Length: 16

postcode
room(optional): string

Maximum Length: 70

Room
streetName(optional): string

Maximum Length: 70

Street Name
strrCountry: string

Maximum Length: 2

country
subDepartment(optional): string

Maximum Length: 70

Sub Department
townLocationName(optional): string

Maximum Length: 35

Town Location Name
townName: string

Maximum Length: 35

Town Name
virtualAccountNo: string

Minimum Length: 1

Maximum Length: 35

Account number of the External customer

{
    "type":"object",
    "properties":{
        "department":{
            "type":"string",
            "description":"Department",
            "maxLength":70
        },
        "subDepartment":{
            "type":"string",
            "description":"Sub Department",
            "maxLength":70
        },
        "streetName":{
            "type":"string",
            "description":"Street Name",
            "maxLength":70
        },
        "buildingNumber":{
            "type":"string",
            "description":"Building Number",
            "maxLength":16
        },
        "buildingName":{
            "type":"string",
            "description":"building Name",
            "maxLength":35
        },
        "floor":{
            "type":"string",
            "description":"Floor",
            "maxLength":70
        },
        "postbox":{
            "type":"string",
            "description":"postbox",
            "maxLength":16
        },
        "room":{
            "type":"string",
            "description":"Room",
            "maxLength":70
        },
        "postcode":{
            "type":"string",
            "description":"postcode",
            "maxLength":16
        },
        "townName":{
            "type":"string",
            "description":"Town Name",
            "maxLength":35
        },
        "townLocationName":{
            "type":"string",
            "description":"Town Location Name",
            "maxLength":35
        },
        "districtName":{
            "type":"string",
            "description":"District name",
            "maxLength":35
        },
        "countrySubDivision":{
            "type":"string",
            "description":"Country Sub Division",
            "maxLength":35
        },
        "strrCountry":{
            "type":"string",
            "description":"country",
            "maxLength":2
        },
        "virtualAccountNo":{
            "type":"string",
            "description":"Account number of the External customer",
            "minLength":1,
            "maxLength":35
        }
    },
    "required":[
        "virtualAccountNo",
        "strrCountry",
        "postcode",
        "townName"
    ]
}

Response

Supported Media Types

application/json
application/xml
text/csv

201 Response

Returns message of succes or failure

Headers

Location: string

URL of newly created structuredaddressservice

Root Schema : ResponseDtoServiceWrapper

Type: object

Show Source

data(optional): object StructuredAddressServiceDTO
messages(optional): object StructuredAddrResponseDto

{
    "type":"object",
    "properties":{
        "messages":{
            "$ref":"#/definitions/StructuredAddrResponseDto"
        },
        "data":{
            "$ref":"#/definitions/StructuredAddressServiceDTO"
        }
    }
}

Nested Schema : StructuredAddressServiceDTO

Type: object

Show Source

buildingName(optional): string

Maximum Length: 35

building Name
buildingNumber(optional): string

Maximum Length: 16

Building Number
countrySubDivision(optional): string

Maximum Length: 35

Country Sub Division
department(optional): string

Maximum Length: 70

Department
districtName(optional): string

Maximum Length: 35

District name
floor(optional): string

Maximum Length: 70

Floor
operationType(optional): string

operation type
postbox(optional): string

Maximum Length: 16

postbox
postcode: string

Maximum Length: 16

postcode
resourceId(optional): string

resource id
resourceName(optional): string

resource name
room(optional): string

Maximum Length: 70

Room
streetName(optional): string

Maximum Length: 70

Street Name
strrCountry: string

Maximum Length: 2

country
subDepartment(optional): string

Maximum Length: 70

Sub Department
townLocationName(optional): string

Maximum Length: 35

Town Location Name
townName: string

Maximum Length: 35

Town Name
virtualEntityId: string

Specify Virtual Entity Identification Number here

{
    "type":"object",
    "properties":{
        "resourceId":{
            "description":"resource id",
            "type":"string"
        },
        "resourceName":{
            "description":"resource name",
            "type":"string"
        },
        "operationType":{
            "description":"operation type",
            "type":"string"
        },
        "department":{
            "type":"string",
            "description":"Department",
            "maxLength":70
        },
        "subDepartment":{
            "type":"string",
            "description":"Sub Department",
            "maxLength":70
        },
        "streetName":{
            "type":"string",
            "description":"Street Name",
            "maxLength":70
        },
        "buildingNumber":{
            "type":"string",
            "description":"Building Number",
            "maxLength":16
        },
        "buildingName":{
            "type":"string",
            "description":"building Name",
            "maxLength":35
        },
        "floor":{
            "type":"string",
            "description":"Floor",
            "maxLength":70
        },
        "postbox":{
            "type":"string",
            "description":"postbox",
            "maxLength":16
        },
        "room":{
            "type":"string",
            "description":"Room",
            "maxLength":70
        },
        "postcode":{
            "type":"string",
            "description":"postcode",
            "maxLength":16
        },
        "townName":{
            "type":"string",
            "description":"Town Name",
            "maxLength":35
        },
        "townLocationName":{
            "type":"string",
            "description":"Town Location Name",
            "maxLength":35
        },
        "districtName":{
            "type":"string",
            "description":"District name",
            "maxLength":35
        },
        "countrySubDivision":{
            "type":"string",
            "description":"Country Sub Division",
            "maxLength":35
        },
        "strrCountry":{
            "type":"string",
            "description":"country",
            "maxLength":2
        },
        "virtualEntityId":{
            "type":"string",
            "description":"Specify Virtual Entity Identification Number here"
        }
    },
    "required":[
        "virtualEntityId",
        "townName",
        "strrCountry",
        "postcode"
    ]
}

Nested Schema : StructuredAddrResponseDto

Type: object

Show Source

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

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

Nested Schema : codes

Type: array

Show Source

Array of: object StructuredAddrResponseCode

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

Nested Schema : StructuredAddrResponseCode

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

Malformed syntax.

401 Response

Request does not have sufficient credentials.

403 Response

Request is not authorized.

405 Response

Invalid input

500 Response

Internal error