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

Add account

Try in API Reference ➜

Endpoint details

Endpoint URL	Method	Authentication requirements
`/v1/api/erp/svAccService`	POST	1. `clientid` 2. `clientsecret` 3. `signature`

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_Bank_Code, // 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 : ACC001
          }, 
          {
            "bankCode": Enter_Bank_Code, // 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_Bank_Code, // OSV BANK CODE IDENTIFIER
            "accountNum": "Enter_Bank_Account_Number",
            "corpId": "Enter_Corporate_Code",
            "name": "Enter_Bank_Account_Name",
            "iban": "Enter_International_Bank_Account_Number",
            "currency": "Enter_Currency",
            "benERPcode": "Enter_Unique_ERP_Beneficiary_Code", // EX : BEN001
            "description": "Enter_Description",
            "country": "Enter_Country",
            "supplierCode": "Enter_Unique_ERP_Supplier_Code",  // EX : SUP001
            "isPrimary": Enter_True/False
          },
          {
            "type": "Enter_Type",
            "nickName": "Enter_Nickname",
            "bankCode": Enter_Bank_Code, // OSV BANK CODE IDENTIFIER
            "accountNum": "Enter_Bank_Account_Number",
            "corpId": "Enter_Corporate_Code",
            "name": "Enter_Bank_Account_Name",
            "iban": "Enter_International_Bank_Account_Number",
            "currency": "Enter_Currency",
            "benERPcode": "Enter_Unique_ERP_Beneficiary_Code", // EX : BEN002
            "description": "Enter_Description",
            "country": "Enter_Country",
            "supplierCode": "Enter_Unique_ERP_Supplier_Code",  // EX : SUP002
            "isPrimary": Enter_True/False
          }
        ]
      }
    ]
  }
}'

Request details:

JSON Tag	Description	Data type
clientid Mandatory	Client ID	String
clientsecret Mandatory	Client Code	String
signature Mandatory	Signature	String
svAccServiceRQ Mandatory	Add Own Bank Accounts and Beneficiaries request tag	Object
groupCode Specific Mandatory	Unique Group Code	String
userName Mandatory	Singleview username	String
account Specific Mandatory	Array of accounts	Array
bankCode Mandatory	Singleview Unique bank code identifier	String
acERPCode Mandatory	Unique code for bank accounts as per ERP	String
accountNum Mandatory	Bank account number	String
corpID Mandatory	Corporate code as per bank records	String
holderName Mandatory	Registered account name	String
iban optional	International Bank Account Number	String
address optional	Bank Account Address	String
currency Mandatory	Default currency in ISO format	String
beneficiary Specific Mandatory	Array of beneficiaries	Array
benERPCode Mandatory	Unique beneficiary code as per ERP	String
type Mandatory	Type of beneficiary; International or local	String
nickName Optional	Nickname of the beneficiary	String
bankCode Mandatory	Unique SV bank code identifier	String
corpId Mandatory	Corporate code as per bank records	String
name Mandatory	Registered name in bank account	String
iban Mandatory	International Bank Account Number/Beneficiary bank account number	String
currency Mandatory	Beneficiary bank account currency in ISO format	String
address Specific Mandatory	Beneficiary Bank Account Address in case of type = "international"	String
swiftCode Specific Mandatory	Beneficiary Bank Account swiftcode in case of type = "international"	String
description Optional	Description of the beneficiary	String
country Optional	Bank account country	String
supplierCode Mandatory	Unique supplier code for beneficiary	String
isPrimary Optional	Set true if is a primary account for beneficiary	Boolean

Successful 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"
          }
        ]
      }
    ]
  }
}

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
accERPCode	Account ERP Code	String
status	Status code	Numerical
code	Unique company code	String
message	Process display message	String
errorCode	Error code	String