Jump to

• Request
• Response

Authorize the amount Blocks by given ID

post

/service/amountBlockSerQueues

This endpoint is used to authorize the amount Blocks identified by given ID.

Request

Supported Media Types

• application/json
• application/xml

Body ()

Request Body that contains data required for updating a amount block echange rate queue record.

Root Schema : AmtBlkSerMasterDTO

Type: object

Show Source

• amtBlkQueueReq(optional): string
  Flag to indicate if queue is required for Amount Block
• amtBlkSerDetailDTOList(optional): array amtBlkSerDetailDTOList
• authStatus(optional): string
  Minimum Length: 1

  Maximum Length: 1

  Approval Status
• blockRefNo: string
  Block Reference Number ECA number
• blockType: string
  Minimum Length: 1

  Maximum Length: 1

  Type of block telling Resident or not
• checkerDtStamp(optional): string(date)
  DateStamp of Authorization
• checkerId(optional): string
  User id of Authorizer
• ddaEcaRefNo(optional): string
  Minimum Length: 1

  Maximum Length: 50

  DDA ECA Reference Number
• effectiveDate: string
  Pattern: [0-9]{4}[-][0-9]{2}[-][0-9]{2}

  Effective Date from which block is valid
• expiryDate: string
  Pattern: [0-9]{4}[-][0-9]{2}[-][0-9]{2}

  Expiry Date till which block is valid
• failAllOnErr(optional): string
  Minimum Length: 1

  Maximum Length: 1

  Flag indicating whether to fail all accounts block processing if any one fails
• makerDtStamp(optional): string(date)
  DateStamp of Making of the Transaction
• makerId(optional): string
  User id of Maker
• sourceCode(optional): string
  Minimum Length: 1

  Maximum Length: 50

  Source from which request for placing block amounts on these accounts
• sourceRefNo(optional): string
  Minimum Length: 1

  Maximum Length: 50

  Reference number from the source
• transactionStatus(optional): string
  Minimum Length: 1

  Maximum Length: 1

  Block transaction status
• txnBranch(optional): string
  Minimum Length: 1

  Maximum Length: 3

  Branch where this ECA block is created

{
    "type":"object",
    "properties":{
        "blockRefNo":{
            "type":"string",
            "description":"Block Reference Number ECA number"
        },
        "sourceCode":{
            "type":"string",
            "description":"Source from which request for placing block amounts on these accounts",
            "minLength":1,
            "maxLength":50
        },
        "sourceRefNo":{
            "type":"string",
            "description":"Reference number from the source",
            "minLength":1,
            "maxLength":50
        },
        "effectiveDate":{
            "type":"string",
            "pattern":"[0-9]{4}[-][0-9]{2}[-][0-9]{2}",
            "description":"Effective Date from which block is valid"
        },
        "expiryDate":{
            "type":"string",
            "pattern":"[0-9]{4}[-][0-9]{2}[-][0-9]{2}",
            "description":"Expiry Date till which block is valid"
        },
        "blockType":{
            "type":"string",
            "description":"Type of block telling Resident or not",
            "minLength":1,
            "maxLength":1
        },
        "ddaEcaRefNo":{
            "type":"string",
            "description":"DDA ECA Reference Number",
            "minLength":1,
            "maxLength":50
        },
        "authStatus":{
            "type":"string",
            "description":"Approval Status",
            "minLength":1,
            "maxLength":1
        },
        "transactionStatus":{
            "type":"string",
            "description":"Block transaction status",
            "minLength":1,
            "maxLength":1
        },
        "txnBranch":{
            "type":"string",
            "description":"Branch where this ECA block is created",
            "minLength":1,
            "maxLength":3
        },
        "failAllOnErr":{
            "type":"string",
            "description":"Flag indicating whether to fail all accounts block processing if any one fails",
            "minLength":1,
            "maxLength":1
        },
        "checkerDtStamp":{
            "type":"string",
            "format":"date",
            "description":"DateStamp of Authorization"
        },
        "makerDtStamp":{
            "type":"string",
            "format":"date",
            "description":"DateStamp of Making of the Transaction"
        },
        "checkerId":{
            "type":"string",
            "description":"User id of Authorizer"
        },
        "makerId":{
            "type":"string",
            "description":"User id of Maker"
        },
        "amtBlkQueueReq":{
            "type":"string",
            "description":"Flag to indicate if queue is required for Amount Block"
        },
        "amtBlkSerDetailDTOList":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/AmtBlkSerDetailDTO"
            }
        }
    },
    "required":[
        "blockRefNo",
        "effectiveDate",
        "expiryDate",
        "blockType"
    ]
}

Nested Schema : amtBlkSerDetailDTOList

Type: array

Show Source

• Array of: object AmtBlkSerDetailDTO

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

Nested Schema : AmtBlkSerDetailDTO

Type: object

Show Source

• accountType(optional): string
  Type of an account
• amtBlkSerExchRateQueueDTO(optional): object AmtBlkSerExchRateQueueDTO
  Discriminator: resource_type
• amtInRealAccCcy(optional): number
  Amount based on real account details
• approvedAmount(optional): number
  Approved amount for placing block on account
• blockCcy: string
  Minimum Length: 1

  Maximum Length: 3

  Currency in which block amount is placed on this account
• blockRefNo(optional): string
• custAccBrn(optional): string
  Minimum Length: 1

  Maximum Length: 3

  Virtual Account branch for which block amount will be placed
• ecaBlkStatus(optional): string
  Minimum Length: 1

  Maximum Length: 10
• excRateBlockccyRaccy(optional): number
  Exchange Rate specific to Real Account Currency
• lockedBy(optional): string
  Minimum Length: 1

  Maximum Length: 30

  Id of user who is holding the lock on this record currently
• outstandingBlockAmount(optional): number
  Current outstanding block amount on account
• partialBlockRequired(optional): string
  Minimum Length: 1

  Maximum Length: 1

  Flag describing if partial block is required or not
• partialReleaseAllowed(optional): string
  Minimum Length: 1

  Maximum Length: 1

  Flag describing if partial release is allowed or not
• realAccCcy(optional): string
  Real account Currency of corresponding Virtual Account
• realAccClass(optional): string
  Real account class
• realAccountBrn(optional): string
  Real account branch of corresponding Virtual Account
• realAccountNo(optional): string
  Real account number of corresponding Virtual Account
• releasedAmount(optional): number
  Released amount for placing block on account
• requestedAmount(optional): number
  Requested amount for placing block on account
• userInputRemarks(optional): string
  Minimum Length: 1

  Maximum Length: 50

  User input remarks
• virtualAccount: string
  Minimum Length: 1

  Maximum Length: 50

  Virtual Account number for which block amount will be placed

{
    "type":"object",
    "properties":{
        "blockRefNo":{
            "type":"string",
            "description":""
        },
        "virtualAccount":{
            "type":"string",
            "description":"Virtual Account number for which block amount will be placed",
            "minLength":1,
            "maxLength":50
        },
        "blockCcy":{
            "type":"string",
            "description":"Currency in which block amount is placed on this account",
            "minLength":1,
            "maxLength":3
        },
        "requestedAmount":{
            "type":"number",
            "description":"Requested amount for placing block on account"
        },
        "approvedAmount":{
            "type":"number",
            "description":"Approved amount for placing block on account"
        },
        "releasedAmount":{
            "type":"number",
            "description":"Released amount for placing block on account"
        },
        "userInputRemarks":{
            "type":"string",
            "description":"User input remarks",
            "minLength":1,
            "maxLength":50
        },
        "custAccBrn":{
            "type":"string",
            "description":"Virtual Account branch for which block amount will be placed",
            "minLength":1,
            "maxLength":3
        },
        "outstandingBlockAmount":{
            "type":"number",
            "description":"Current outstanding block amount on account"
        },
        "partialBlockRequired":{
            "type":"string",
            "description":"Flag describing if partial block is required or not ",
            "minLength":1,
            "maxLength":1
        },
        "partialReleaseAllowed":{
            "type":"string",
            "description":"Flag describing if partial release is allowed or not",
            "minLength":1,
            "maxLength":1
        },
        "lockedBy":{
            "type":"string",
            "description":"Id of user who is holding the lock on this record currently",
            "minLength":1,
            "maxLength":30
        },
        "ecaBlkStatus":{
            "type":"string",
            "description":"",
            "minLength":1,
            "maxLength":10
        },
        "realAccountNo":{
            "type":"string",
            "description":"Real account number of corresponding Virtual Account"
        },
        "realAccountBrn":{
            "type":"string",
            "description":"Real account branch of corresponding Virtual Account"
        },
        "realAccCcy":{
            "type":"string",
            "description":"Real account Currency of corresponding Virtual Account"
        },
        "realAccClass":{
            "type":"string",
            "description":"Real account class"
        },
        "amtInRealAccCcy":{
            "type":"number",
            "description":"Amount based on real account details"
        },
        "excRateBlockccyRaccy":{
            "type":"number",
            "description":"Exchange Rate specific to Real Account Currency"
        },
        "accountType":{
            "type":"string",
            "description":"Type of an account"
        },
        "amtBlkSerExchRateQueueDTO":{
            "$ref":"#/definitions/AmtBlkSerExchRateQueueDTO"
        }
    },
    "required":[
        "virtualAccount",
        "blockCcy"
    ]
}

Nested Schema : AmtBlkSerExchRateQueueDTO

Type: object

Discriminator: resource_type

Show Source

• amtInRealAccCcy(optional): number
  Amount calculated out of the exchange rate
• authStatus(optional): string
  Minimum Length: 1

  Maximum Length: 1

  Approval Status
• blockRefNo: string
  reference number of the amount block which is in queue
• checkerDtStamp(optional): string(date)
  DateStamp of Authorization
• checkerId(optional): string
  User id of Authorizer
• excRateBlockccyRaccy(optional): number
  Currency in which block amount is placed on this account
• makerDtStamp(optional): string(date)
  DateStamp of Making of the Transaction
• makerId(optional): string
  User id of Maker
• newExchRate: number
  allows user to enter the new exchange rate
• updatedExchRateAmt(optional): number
  based on Exch rate, amount will be calculated from currency conversion
• virtualAccount: string
  Minimum Length: 1

  Maximum Length: 50

  Virtual Account number for which block amount will be placed

{
    "type":"object",
    "properties":{
        "blockRefNo":{
            "type":"string",
            "description":"reference number of the amount block which is in queue"
        },
        "virtualAccount":{
            "type":"string",
            "description":"Virtual Account number for which block amount will be placed",
            "minLength":1,
            "maxLength":50
        },
        "excRateBlockccyRaccy":{
            "type":"number",
            "description":"Currency in which block amount is placed on this account"
        },
        "amtInRealAccCcy":{
            "type":"number",
            "description":"Amount calculated out of the exchange rate"
        },
        "newExchRate":{
            "type":"number",
            "description":"allows user to enter the new exchange rate"
        },
        "updatedExchRateAmt":{
            "type":"number",
            "description":"based on Exch rate, amount will be calculated from currency conversion"
        },
        "makerDtStamp":{
            "type":"string",
            "format":"date",
            "description":"DateStamp of Making of the Transaction"
        },
        "makerId":{
            "type":"string",
            "description":"User id of Maker"
        },
        "checkerDtStamp":{
            "type":"string",
            "format":"date",
            "description":"DateStamp of Authorization"
        },
        "checkerId":{
            "type":"string",
            "description":"User id of Authorizer"
        },
        "authStatus":{
            "type":"string",
            "description":"Approval Status",
            "minLength":1,
            "maxLength":1
        }
    },
    "required":[
        "blockRefNo",
        "newExchRate",
        "virtualAccount"
    ],
    "discriminator":"resource_type"
}

Back to Top

Response

Supported Media Types

• application/json
• application/xml

200 Response

Successful operation.

Body ()

Root Schema : ResponseDtoWrapper

Type: object

Show Source

• messages(optional): object ResponseDto

{
    "type":"object",
    "properties":{
        "messages":{
            "$ref":"#/definitions/ResponseDto"
        }
    }
}

Nested Schema : ResponseDto

Type: object

Show Source

• codes(optional): array codes
• id(optional): string
• requestId(optional): string
• status(optional): string

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

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

Malformed syntax.

401 Response

Request does not have sufficient credentials.

403 Response

Request is not authorized.

500 Response

Internal error

Back to Top