Jump to

• Request
• Response

Retrieves the Real account for given Virtual Account/Virtual Identifier/Virtual Account IBAN

get

/service/realaccountforvirtual

This end point is used to retrieve the Real Account details for a given Virtual Account/Virtual Identifier/Virtual Account IBAN.

Request

Supported Media Types

• application/json

Query Parameters

• transactionCurrency(optional): string
  transaction currency in case of virtual Identifier. In case of an identifier linked to real account using virtual multi currency account group, if this field value is given as input, and the VMCA has a real account with same Ccy, then that real account will be returned, otherwise if default account exists, it will be returned
• txnAccountBrn(optional): string
  Virtual Account Branch/Identifier Transacion Branch. The transaction branch is mandatory in case the iput is a virtual identifier
• virtualAccountIdentifier: string
  Virtual Account/Identifier/Virtual Account IBAN for which we have to get the Real Account

Header Parameters

• sourceCode: string
  Source from which request is initiated

Back to Top

Response

Supported Media Types

• application/json

200 Response

Returns message of success and data containing Real Account Details or failure with messages.

Headers

• Location: string
  Returns real account details of given Virtual Account/Identifier

Body ()

Root Schema : RealAcountWrapperDTO

Type: object

Show Source

• data(optional): object RealAccountServiceDTO
• messages(optional): object ResponseDtoForGet

{
    "type":"object",
    "properties":{
        "messages":{
            "$ref":"#/definitions/ResponseDtoForGet"
        },
        "data":{
            "$ref":"#/definitions/RealAccountServiceDTO"
        }
    }
}

Nested Schema : RealAccountServiceDTO

Type: object

Show Source

• accountClass(optional): string
  Account class of the Real Account. It can be Normal account or Multi Currency account
• address1(optional): string
  First line of the customer address
• address2(optional): string
  Second line of the customer address
• address3(optional): string
  Third line of the customer address
• address4(optional): string
  Fourth line of the customer address
• corecustAccountNo(optional): string
  Real Account Number as stored in OBVAM
• corecustAcIban(optional): string
  IBAN of the Real Account
• corecustAcName(optional): string
  Real Account Name as stored in OBVAM
• countryCode(optional): string
  Country Code
• custAcCcy(optional): string
  Real Account currency as stored in OBVAM
• customerNo(optional): string
  Real Customer Number
• realAccBrn(optional): string
  Real Account branch as per DDA system
• realAccNo(optional): string
  Real Account number as per DDA system
• sourceSystem(optional): string
  Source Code

{
    "type":"object",
    "properties":{
        "realAccNo":{
            "type":"string",
            "description":"Real Account number as per DDA system"
        },
        "realAccBrn":{
            "type":"string",
            "description":"Real Account branch as per DDA system"
        },
        "corecustAccountNo":{
            "type":"string",
            "description":"Real Account Number as stored in OBVAM"
        },
        "corecustAcName":{
            "type":"string",
            "description":"Real Account Name as stored in OBVAM"
        },
        "custAcCcy":{
            "type":"string",
            "description":"Real Account currency as stored in OBVAM"
        },
        "customerNo":{
            "type":"string",
            "description":"Real Customer Number"
        },
        "corecustAcIban":{
            "type":"string",
            "description":"IBAN of the Real Account"
        },
        "accountClass":{
            "type":"string",
            "description":"Account class of the Real Account. It can be Normal account or Multi Currency account"
        },
        "sourceSystem":{
            "type":"string",
            "description":"Source Code"
        },
        "countryCode":{
            "type":"string",
            "description":"Country Code"
        },
        "address1":{
            "type":"string",
            "description":"First line of the customer address"
        },
        "address2":{
            "type":"string",
            "description":"Second line of the customer address"
        },
        "address3":{
            "type":"string",
            "description":"Third line of the customer address"
        },
        "address4":{
            "type":"string",
            "description":"Fourth line of the customer address"
        }
    }
}

Nested Schema : ResponseDtoForGet

Type: object

Show Source

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

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

Nested Schema : codes

Type: array

Show Source

• Array of: object ResponseCode

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

Nested Schema : ResponseCode

Type: object

Show Source

• arg(optional): string
• args(optional): array args
• 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"
        },
        "args":{
            "type":"array",
            "items":{
                "type":"object"
            }
        },
        "arg":{
            "type":"string"
        }
    }
}

Nested Schema : args

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object"
    }
}

Nested Schema : items

Type: object

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.

500 Response

Internal server error

Back to Top