Deposit
POST/v1.2/finance/deposit
This is used to request to deposit some amount from customer cash account in the system by the end customer.
This facilitates a request from the end customer to deposit a specified amount into their cash account within the system.
Security account number or cash account number is required. Cash account number will be prioritized
Request
Header Parameters
- application/json
Body
The Security account number
The Cash account number
The amount
Find valid bank id for the institution Master Data> Get Instiutional Bank Account
Possible values: non-empty
Find customer bank account numbers Master Data > Get Customer Bank Accounts
Example: USD
Possible values: non-empty
, [0
, 1
, 2
]
0 for Cheque, 1 for Bank, 2 for Cash
Possible values: Value must match regular expression ^[0-9]{4}/(0[1-9]|1[0-2])/(0[1-9]|[1-2][0-9]|3[0-1])$
Example: 2022/04/04
Possible values: Value must match regular expression ^[0-9]{4}/(0[1-9]|1[0-2])/(0[1-9]|[1-2][0-9]|3[0-1])$
Example: 2022/04/04
reference Id for the transaction
originating bank name
originating bank address
originating bank branch
Responses
- 200
- 401
OK
- application/json
- Schema
- Example (from schema)
- example
Schema
Possible values: non-empty
Possible values: non-empty
, [SUCCESS
, FAILED
]
Find error codes here
Cash account number of the cash account which the cash deposited
{
"requestId": 0,
"amount": 0,
"narration": "string",
"status": "SUCCESS",
"reason": "string",
"rejectCode": 0,
"cashAccountNumber": "string"
}
{
"status": "SUCCESS",
"reason": "N/A",
"rejectCode": 0,
"requestId": 1674717955022,
"amount": 10000,
"narration": "N/A",
"cashAccountNumber": "C000311055"
}
Unauthorized
- application/json
- Schema
- Example (from schema)
- Invalid Token
- Expired Token
Schema
{
"timestamp": "string",
"status": "string",
"error": "string",
"message": "string",
"path": "string",
"rejectCode": "string"
}
{
"timestamp": "2023-12-28T09:51:50.682Z",
"status": "401",
"error": "Unauthorized",
"message": "Invalid Token",
"path": "/api/v1.2/finance/deposit",
"rejectCode": "1008"
}
{
"timestamp": "2023-12-28T09:51:50.682Z",
"status": "401",
"error": "Unauthorized",
"message": "Expired Token",
"path": "/api/v1.2/finance/deposit",
"rejectCode": "1007"
}