Enlist your company's and suppliers' bank accounts
Account services allows you to add your own bank accounts as well as manage beneficiary bank accounts (supplier bank accounts).
Endpoint URL | Method | Authentication requirements |
|---|---|---|
| POST |
|
A request in the following format should be posted to the mentioned URL endpoint.
curl --location --request POST 'https://servicesuat.onesingleview.com/v1/api/erp/svAccService' \
--header 'clientid: Enter_Client_ID' \
--header 'clientsecret: Enter_Client_Secret' \
--header 'signature: Enter_Signature' \
--header 'Content-Type: application/json' \
--data-raw '{
"svAccServiceRQ": {
"groupCode": "1000",
"company": [
{
"companyCode": "1101",
"userName": "sayeed_7612",
"account": [
{
"bankCode": "02",
"accountNum": "05100000356000",
"corpId": "OSV0001",
"holderName": "SNB VA PRIMARY ACC",
"iban": "05100000356000",
"address": "Address",
"currency": "SAR",
"acERPcode": "1000000090"
}
],
"beneficiary": [
{
"nickName": "international account",
"bankCode": "57",
"type": "International",
"accountNum": "16505080184010",
"corpId": "",
"swiftCode": "BOFAGB22",
"name": "international account",
"address": "Dubai",
"iban": " ",
"currency": "USD",
"benERPcode": "510004550001",
"description": "",
"country": "GB",
"holderName": "",
"supplierCode": "51000455",
"isPrimary": "false"
}
]
}
]
}
}'Request details:
JSON Tag | Description | Data type |
|---|---|---|
clientid Mandatory | Unique client identification details Length of input: Min 3 Characters Max 20 Characters | String |
clientsecret Mandatory | Unique client identification secret code Length of input: Min 3 Characters Max 20 Characters | String |
signature Mandatory | 64-Bit string obtained by processing client signature key through Base-64 and SHA-256 | String |
svAccServiceRQ Mandatory | Tag carrying information on request to add beneficiary or supplier account | Object |
groupCode Mandatory | Unique group identification code | String |
company Mandatory | Tag carrying information on the company | Object |
companyCode Mandatory | Unique identification code of the company Length of input: Min 3 Characters Max 20 Characters | String |
userName Mandatory | Unique SingleView's username of the request initiator Length of input: Min 3 Characters Max 20 Characters | String |
account Mandatory | Object carrying information on accounts to be added | Object/Array |
accountNum Mandatory | Unique bank account number of the beneficiary/supplier | Alphanumeric |
corpID Mandatory | Corporate identification code as per bank records of the debit account Length of input: Min 3 Characters Max 20 Characters | Alphanumeric |
holderName Mandatory | Registered name of the account holder as per bank records Length of input: Min 3 Characters Max 20 Characters | Alphabetic |
currency Mandatory | Default currency code in ISO format | Alphabertic |
acERPcode Mandatory | Unique ERP code assigned to the bank account | Alphanumeric |
bankCode Mandatory | Unique bank identification code (SingleView identifier code) Length of input: Min 3 Characters Max 20 Characters | String |
iban Optional | Unique International Bank Account Number (IBAN) Length of input: Max 24 Characters | Alphanumeric |
address Mandatory | Address of the bank where the beneficiary holds the specified account Length of input: Min 3 Characters Max 20 Characters | String |
beneficiary Mandatory | Tag carrying an array of beneficiaries bank accounts | Object/Array |
iban Mandatory | International Bank Account Number/Beneficiary bank account number | Alphanumeric |
type Mandatory | Type of beneficiary; International or local Length of input: Min 3 Characters Max 20 Characters | Alphanumeric |
name Mandatory | Name of beneficiary as per bank account Length of input: Min 3 Characters Max 35 Characters | Alphabetic |
currency Mandatory | Beneficiary bank account currency in ISO format | Alphanumeric |
benERPCode Mandatory | Unique beneficiary code as per ERP | String |
bankCode Mandatory | Unique SingleView bank code identifier Length of input: Min 3 Characters Max 20 Characters | Alphanumeric |
supplierCode Mandatory | Unique supplier code for beneficiary | String |
address Optional | Address of the beneficiary Length of input: Min 3 Characters Max 35 Characters | String |
swiftCode Mandatory | Unique swift identification code of the beneficiary bank account | Alphanumeric |
isPrimary Mandatory | Set | Boolean |
nickName Optional | Nickname of the beneficiary Length of input: Min 3 Characters Max 20 Characters | Alphanumeric |
accountNum Optional | Bank account number of the beneficiary | Alphanumeric |
corpID Optional | Unique corporate identification details of the beneficiary Length of input: Min 3 Characters Max 20 Characters | Alphanumeric |
description Optional | Description of the beneficiary Length of input: Min 3 Characters Max 20 Characters | String |
country Optional | Bank account country Length of input: Max 35 Characters | String |
{
"svAccServiceRS": {
"company": [
{
"companyCode": "1101",
"userName": "sayeed_7612",
"account": [
{
"acERPcode": "1000000090",
"status": 0,
"message": "bank account added successfully"
}
],
"beneficiary": [
{
"benERPcode": "510004550001",
"status": 0,
"message": "beneficiary account added successfully"
}
]
}
]
}
}Response details:
JSON Tag | Description | Data type |
|---|---|---|
svAccServiceRS | Add account services Response Tag | Object |
groupCode | Unique group code | String |
company | Array of companies | Array |
companyCode | Unique company code | String |
userName | SingleView Account's username | String |
account | Array of accounts | Array |
acERPCode | Account ERP Code | Alphanumeric |
status | Status code | Numerical |
code | Unique company code | String |
message | Process display message | String |
errorCode | Error code | String |