Account Services

Account services allows you to add your own bank accounts as well as manage beneficiary bank accounts (supplier bank accounts).

Add new account

Endpoint details

Endpoint URL	Method	Authentication requirements
`/v1/api/erp/svAccService`	POST	`clientid` `clientsecret` `signature`

Sample request

A request in the following format should be posted to the mentioned URL endpoint.

Add account services

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 Min: 9 Characters	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 `true` or `false` to set the account as a primary account for the beneficiary	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

Sample response

Add account services success response

{
  "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

Categories

Getting started

Authentication

ERP API Services

Add new account

Endpoint details

Sample request

Sample response