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": "Enter_Group_Code",
"company": [
{
"companyCode": "Enter_Company_Code",
"userName": "Enter_Username",
"account": [
{
"bankCode": Enter_OSV_Bank_Code_Identifier,
"accountNum": "Enter_Bank_Account_Number",
"corpId": "Enter_Corporate_Bank_Code",
"holderName": "Enter_Bank_Account_Holder_Name",
"iban": "Enter_International_Bank_Account_Number",
"address": "Enter_ Bank_Address",
"currency": "Enter_Currency",
"acERPcode": "Enter_Unique_ERP_Account_Code"
},
{
"bankCode": Enter_OSV_Bank_Code_Identifier,
"accountNum": "Enter_Bank_Account_Number",
"corpId": "Enter_Corporate_Bank_Code",
"holderName": "Enter_Bank_Account_Holder_Name",
"iban": "Enter_International_Bank_Account_Number",
"address": "Enter_ Bank_Address",
"currency": "Enter_Currency",
"acERPcode": "Enter_Unique_ERP_Account_Code" // EX : ACC002
}
],
"beneficiary": [
{
"type": "Enter_Type",
"nickName": "Enter_Nickname",
"bankCode": Enter_OSV_Bank_Code_Identifier,
"accountNum": "Enter_Bank_Account_Number",
"name": "Enter_Bank_Account_Name",
"iban": "Enter_International_Bank_Account_Number",
"currency": "Enter_Currency",
"benERPcode": "Enter_Unique_ERP_Beneficiary_Code",
"description": "Enter_Description",
"country": "Enter_Country",
"supplierCode": "Enter_Unique_ERP_Supplier_Code",
"isPrimary": Enter_True/False
},
{
"type": "Enter_Type",
"nickName": "Enter_Nickname",
"bankCode": Enter_OSV_Bank_Code_Identifier,
"accountNum": "Enter_Bank_Account_Number",
"name": "Enter_Bank_Account_Name",
"iban": "Enter_International_Bank_Account_Number",
"currency": "Enter_Currency",
"benERPcode": "Enter_Unique_ERP_Beneficiary_Code",
"description": "Enter_Description",
"country": "Enter_Country",
"supplierCode": "Enter_Unique_ERP_Supplier_Code",
"isPrimary": Enter_True/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": {
"groupCode": "Group_Code",
"company": [
{
"companyCode": "Company_Code",
"userName" : "Username",
"account": [
{
"acERPcode": "Account_ERP_Code",
"status": Status_Code,
"message": "Process/Status_Message"
},
{
"acERPcode": "Account_ERP_Code",
"status": Status_Code,
"message": "Process/Status_Message",
"errorCode": "Error_Code"
}
],
"beneficiary": [
{
"benERPcode": "Beneficiary_ERP_Code",
"status": Status_Code,
"message": "Process/Status_Message"
},
{
"benERPcode": "Beneficiary_ERP_Code",
"status": Status_Code,
"message": "Process/Status_Message",
"errorCode": "Error_Code"
}
]
}
]
}
}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 |