Overview

SingleView Virtual Accounts API services offer a comprehensive set of tools for creating, managing, and controlling virtual bank accounts. These APIs enable real-time access to virtual account data, automation of financial workflows, and seamless integration with your ERP systems.

Create a Virtual Account

Try in API Reference ➜

Endpoint details

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

Create Virtual Account

Sample request

curl --location --request POST 'https://servicesuat.onesingleview.com/v1/api/erp/svVAService' \
--header 'clientid: Enter_Client_ID' \
--header 'clientsecret: Enter_Client_Secret' \
--header 'signature: Enter_Signature' \
--header 'Content-Type: application/json' \
--data-raw '{
"svVAServiceRQ": {
  "groupCode": "Enter_Group_Code",
  "company": [
    {
      "companyCode": "Enter _Company_Code",
      "userName": "Enter_Username",
      "virAccount": [
        {
          "acERPcode": "Enter_Account_ERP_Code",
          "alias" : "Enter_Alias",
          "customerRef" : "Enter_Customer_Reference",
          "capLimit" : "Enter_Cap_Limit"
        }
      ]
    }
  ]
}
}'

Request description

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 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
svVAServiceRQ Mandatory	Tag carrying information on request to create virtual account	Object
groupCode Mandatory	Unique group identification code Length of input: Min 3 Characters Max 20 Characters	Numerical
company Mandatory	Tag carrying information about company	Object
companyCode Mandatory	Unique company identification code Length of input: Min 3 Characters Max 20 Characters	Numerical
userName Mandatory	Unique user identification name Length of input: Min 3 Characters Max 20 Characters	String
virAccount Mandatory	Tag carrying information on virtual account creation request	Object
acERPcode Mandatory	Unique account ERP identification code Length of input: Min 3 Characters Max 20 Characters	Numerical
alias Mandatory	Alias information Length of input: Min 3 Characters Max 20 Characters	String
customerRef Mandatory	Unique customer reference details	Numerical
capLimit Mandatory	Maximum limit of the amount in virtual account	Numerical

Sample response

{
  "svVAServiceRS": {
    "company": [
      {
        "companyCode": "Company_Code",
        "userName": "Username",
        "virAccount": {
          "acERPcode": "Account_ERP_Code",
          "alias": "Alias_Info",
          "customerRef": "Customer_Reference",
          "virtualIBAN": "Virtual_IBAN"
        }
      }
    ]
  }
}

Response description

JSON Tag	Description	Data Type
svVAServiceRS	Tag carrying information on process response of Virtual Account services	Object
company	Tag carrying information on company	Object
companyCode	Unique company identification code	Numerical
userName	Unique username	String
virAccount	Tag carrying information on virtual account	Object
acERPcode	Unique ERP account code	Numerical
alias	Unique alias details	String
customerRef	Unique customer reference number	Numerical
virtualIBAN	Unique virtual IBAN	String