REST API for Oracle Banking Virtual Account Management

Get all valid remitters

get

/service/remitters

This endpoint is used to get all valid remittance IDs.

Request

Supported Media Types

application/json
application/xml

Query Parameters

additionalInfo: string
authStat: string
checkerId: string
customerNo(required): string
ibanAccNo: string
ibanReqd: string
identiferAccNo: string
includecloseandunauth: boolean

includecloseandunauth need to be set to fetch summary record, defult value is false
limit: integer

limit is maximum no of records to be fetched
makerId: string
offset: integer

offset is starting no of records to be fetched
reconInfo: string
recordStat: string
remitterId: string
remitterListId: string
virtualIdentifier(required): string

Header Parameters

sourceCode(required): string

Source from which request is initiated

Response

Supported Media Types

application/json
application/xml
text/csv

201 Response

Returns message of succes or failure

Headers

Location: string

Root Schema : RemitterIdServiceCollection

Type: object

Collection of remitterid.

Show Source

data: array data
paging: object PagingDto

{
    "description":"Collection of remitterid.",
    "type":"object",
    "properties":{
        "data":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/RemitterIdServiceResponseDataDto"
            }
        },
        "paging":{
            "$ref":"#/definitions/PagingDto"
        }
    }
}

Nested Schema : data

Type: array

Show Source

Array of: object RemitterIdServiceResponseDataDto

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

Nested Schema : PagingDto

Type: object

Show Source

totalResults: integer

{
    "type":"object",
    "properties":{
        "totalResults":{
            "type":"integer"
        }
    }
}

Nested Schema : RemitterIdServiceResponseDataDto

Type: object

Match All

Show Source

object RemitterIdServiceResponseDataDto-allOf[0]

{
    "type":"object",
    "allOf":[
        {
            "type":"object",
            "properties":{
                "realCustomerNo":{
                    "type":"string",
                    "description":"Customer number for which Remitter list id is maintained",
                    "minLength":"1",
                    "maxLength":"20"
                },
                "virtualIdentifier":{
                    "type":"string",
                    "description":"Virtual Identifier",
                    "minLength":"1",
                    "maxLength":"15"
                },
                "remitterListId":{
                    "type":"string",
                    "description":"Unique identification number to identify Remitter list",
                    "minLength":"1",
                    "maxLength":"35",
                    "pattern":"^[a-zA-Z0-9]+$"
                },
                "remitterId":{
                    "type":"string",
                    "description":"Identification number of the Remitter which is the second part of the VAI account number",
                    "minLength":"1",
                    "maxLength":"35",
                    "pattern":"^[a-zA-Z0-9]+$"
                },
                "identifierAccountNo":{
                    "type":"string",
                    "description":"Identifier Account which is VirtualIdentifier + remitterId"
                },
                "ibanReqd":{
                    "type":"string",
                    "description":"Flag that indicates if IBAN is to be generated or not"
                },
                "ibanAccountNo":{
                    "type":"string",
                    "description":"IBAN for the Identifier"
                },
                "additionalInfo":{
                    "type":"string",
                    "description":"Additional information provided by corporate for further use "
                },
                "reconInfo":{
                    "type":"string",
                    "description":"Reference number provided by corporate for reconciliation purpose"
                },
                "validityStartDate":{
                    "type":"string",
                    "description":"Date from which Remitter id will be active"
                },
                "validityEndDate":{
                    "type":"string",
                    "description":"Date till which Remitter id will be active"
                },
                "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"
                }
            }
        }
    ]
}

Nested Schema : RemitterIdServiceResponseDataDto-allOf[0]

Type: object

Show Source

additionalInfo: string

Additional information provided by corporate for further use
authStatus: string

Authorization Status of Virtual Account
checkerDateStamp: string

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

Checker ID of Virtual Account
ibanAccountNo: string

IBAN for the Identifier
ibanReqd: string

Flag that indicates if IBAN is to be generated or not
identifierAccountNo: string

Identifier Account which is VirtualIdentifier + remitterId
makerDateStamp: string

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

Maker ID of Virtual Account
modNo: integer

Version number of Virtual Account
onceAuth: string

Flag that indicated if Virtual Account is authorized once or not
realCustomerNo: string

Minimum Length: 1

Maximum Length: 20

Customer number for which Remitter list id is maintained
reconInfo: string

Reference number provided by corporate for reconciliation purpose
recordStatus: string

Record Status of Virtual Account
remitterId: string

Minimum Length: 1

Maximum Length: 35

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

Identification number of the Remitter which is the second part of the VAI account number
remitterListId: string

Minimum Length: 1

Maximum Length: 35

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

Unique identification number to identify Remitter list
validityEndDate: string

Date till which Remitter id will be active
validityStartDate: string

Date from which Remitter id will be active
virtualIdentifier: string

Minimum Length: 1

Maximum Length: 15

Virtual Identifier

{
    "type":"object",
    "properties":{
        "realCustomerNo":{
            "type":"string",
            "description":"Customer number for which Remitter list id is maintained",
            "minLength":"1",
            "maxLength":"20"
        },
        "virtualIdentifier":{
            "type":"string",
            "description":"Virtual Identifier",
            "minLength":"1",
            "maxLength":"15"
        },
        "remitterListId":{
            "type":"string",
            "description":"Unique identification number to identify Remitter list",
            "minLength":"1",
            "maxLength":"35",
            "pattern":"^[a-zA-Z0-9]+$"
        },
        "remitterId":{
            "type":"string",
            "description":"Identification number of the Remitter which is the second part of the VAI account number",
            "minLength":"1",
            "maxLength":"35",
            "pattern":"^[a-zA-Z0-9]+$"
        },
        "identifierAccountNo":{
            "type":"string",
            "description":"Identifier Account which is VirtualIdentifier + remitterId"
        },
        "ibanReqd":{
            "type":"string",
            "description":"Flag that indicates if IBAN is to be generated or not"
        },
        "ibanAccountNo":{
            "type":"string",
            "description":"IBAN for the Identifier"
        },
        "additionalInfo":{
            "type":"string",
            "description":"Additional information provided by corporate for further use "
        },
        "reconInfo":{
            "type":"string",
            "description":"Reference number provided by corporate for reconciliation purpose"
        },
        "validityStartDate":{
            "type":"string",
            "description":"Date from which Remitter id will be active"
        },
        "validityEndDate":{
            "type":"string",
            "description":"Date till which Remitter id will be active"
        },
        "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"
        }
    }
}

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